Подключение Zapier или n8n

Zapier и n8n — сервисы автоматизации. Они умеют передавать данные в BytePhase почти из любого другого приложения. Например, новая строка в таблице может стать лидом.

Перед началом

• Нужен аккаунт Zapier или n8n. В Zapier шаг Webhooks by Zapier — платная функция Zapier.
• Подключить интеграцию можно на любом тарифе. Чтобы видеть запросы, нужен тариф Standard или выше.
• Хорошо, если рядом есть человек, который уже собирал Zap или рабочий процесс в n8n.

Шаги

1. Откройте Настройки › Интеграции. В разделе Сайт и формы нажмите Подключить на карточке Zapier или n8n.

2. Выберите Саморегистрация или Лид и нажмите Далее.

3. Скопируйте API-ключ и URL эндпоинта. Для Zapier также показан Базовый URL API.

   API-ключ показывается только один раз. Скопируйте его сейчас.

   

   Компьютер

4. Соберите связку в своём сервисе. Шаги перечислены в блоке Как подключить на экране:

   • Zapier: добавьте в Zap действие Webhooks by Zapier › POST. Вставьте Endpoint URL и добавьте API-ключ, как указано на экране. Или найдите в Zapier «BytePhase» и подключитесь с API-ключом и базовым URL API.
   • n8n: добавьте узел HTTP Request, нажмите Import cURL и вставьте пример curl из Примеры кода.

   Ниже описано, что выбирать внутри Zapier и n8n.

5. Запустите тест в своём сервисе: шаг Test в Zapier или запуск узла в n8n. Затем нажмите Проверить сейчас в BytePhase.

   Появится Тестовая заявка получена.

6. Нажимайте Далее на шагах Сопоставление полей и Если клиент уже есть, затем нажмите Активировать интеграцию.

Готово!

Теперь ваш Zap или рабочий процесс n8n при каждом запуске создаёт лиды или саморегистрации в BytePhase.

Настройка Zap в Zapier

1. В Zapier нажмите Create, затем Zap.

2. В качестве триггера выберите приложение, из которого приходят данные. Для Google Forms выберите New Form Response, а не New or Updated Form Response. Иначе изменённый ответ создаст второй лид.

3. Нажмите Test trigger, чтобы Zapier нашёл свежую запись. Если он ничего не нашёл, заполните форму сами один раз и проверьте снова.

4. Добавьте действие: Webhooks by Zapier, затем POST. Заполните его так:

   • URL: URL эндпоинта из BytePhase.
   • Payload Type: Json. Wrap Request In Array: No. Unflatten: Yes.
   • Headers: добавьте X-API-Key с вашим API-ключом. Также добавьте Content-Type и Accept, оба со значением application/json.
   • Data: повторите структуру примера curl из Примеры кода. Ваши поля идут внутри data. Каждое значение заполняйте через выбор полей в Zapier, а не вводите вручную.

5. При желании добавьте перед действием шаг Filter by Zapier. Пропускайте запись, только если в ней есть имя и email или номер мобильного. Так вы отсечёте спам.

6. После того как вы активируете интеграцию в BytePhase, нажмите Publish в Zapier.

Настройка рабочего процесса в n8n

Import cURL сам заполнит узел HTTP Request. Если хотите заполнить его вручную:

1. В поле Method выберите POST, в поле URL вставьте URL эндпоинта из BytePhase.

2. Добавьте два заголовка: X-API-Key с вашим API-ключом и Content-Type со значением application/json.

3. Отправляйте тело запроса в формате JSON, в той же структуре, что и пример curl. Ваши поля идут внутри data.

4. Если названия ваших полей отличаются от названий в BytePhase, добавьте перед ним узел Set. Переименуйте поля так, как они названы в Показать доступные поля.

Сохраните API-ключ в учётных данных (credentials) n8n, а не вписывайте его в узел. Тогда он не попадёт в экспорт рабочего процесса.

Что умеет приложение BytePhase в Zapier

Если подключиться через приложение BytePhase в Zapier, одно подключение даёт:

• Triggers (что-то происходит в BytePhase): новый заказ, клиент, лид, платёж, заказ на аутсорсинг или смена статуса заказа.
• Actions (BytePhase что-то делает): создать клиента, создать лида или добавить саморегистрацию.
• Search: найти клиента.

Полезно знать

• Чтобы увидеть каждую заявку и узнать, сработала ли она, нажмите Посмотреть активность на карточке.
• Полный список полей, которые принимает BytePhase, откроется по кнопке Показать доступные поля на шаге подключения. Также его можно найти на developers.bytephase.com.
• Если API-ключ попал в чужие руки, нажмите Сменить ключ на странице активности. Затем укажите новый ключ в своём Zap или рабочем процессе.
• Если Zapier повторит шаг, BytePhase может создать вторую запись. Повторы останавливает ваш выбор в шаге Если клиент уже есть. В n8n добавьте заголовок Idempotency-Key с уникальным для каждой записи значением, и повтор будет проигнорирован.