Яндекс.Формы → Битрикс24. Создание лида по API
Передавайте данные из Яндекс.Форм
и на основе этих данных создавайте сделки в Битрикс24 по API
Настройка получения данных из Яндекс.Формы
Список Шагов:
Шаг 1. Добавления источника
Шаг 2. Настройка отправки данных из Яндекс.Формы
Шаг 3. Отправка тестового лида из Яндекс.Формы
Шаг 1. Добавления источника
Шаг 1.1 Нажмите на кнопку "Добавить".
Шаг 1.2 Выберите источник данных "HTTP-Запрос (Webhook)".
Шаг 1.3 Не изменяя параметров, нажмите кнопку "Сохранить"
Шаг 1.4 Скопируйте ссылку.
Шаг 2. Настройка отправки данных из Яндекс.Формы
Настройте отправку заявок из Яндекс.Формы
Перейдите в Настроики вашего проекта в Яндекс.Формы
- Выберите созданую форму
- Нажмите на вкладку "Интеграция"
- Нажмите на кнопку "Добавить группу действий"
- Выберите "API"
- Выберите "Запрос заданным методом"
- Укажите ваш адрес webhook в поле"URL" из Шага 1.4
- Выберите метод "POST"
- Тело запроса Добавьте параметры(Данные) которые нужно получать
- Добавить заголовок Content-Type: application/x-www-form-urlencoded
- Сохранить
Шаг 3. Отправка тестового лида из Яндекс.Формы
Отправьте Тестовый лид из Яндекс.Формы
Т.е. заполните вашу яндекс форму.
после того как отправите тестовый лид зайдите в обработку:
- в блоке "1.Источник данных".
- Нажмите на кнопку "Изменить".
- Нажмите на кнопку "Получить" после этого появятся параметры.
- Нажмите на кнопку "Сохранить".
На скринах ниже показано как это сделать.
На этом настройка получения данных о поступивших заявках из Яндекс.Формы закончена.
Заявки для квиза, для которого вы настроили отправку, будут поступать в обработку.
Далее можно настроить действия по отправке этих данных в amoCRM, Bitrix24, Telegram и др.
Зачем использовать API?
В некоторых случаях имеющуюся интеграцию не получается использовать. Например иногда в коробочных версиях битрикс или когда не удается установить приложение Webjack в битрикс24.
Создайте входящий вебхук
Шаг 1. Перейдите в меню "Все приложения" → "Готовые сценарии" → "Другое"
Выберите "Входящий вебхук"
Выберите права доступа к "CRM", скопируйте "Вебхук для вызова rest api" и сохраните
С настройками на стороне битрикс мы закончили. Теперь можно переходить к настройкам передачи данных.
Отправка данных в Битрикс24 через Вебхук
Шаг 1 . Подготовим данные для отправки в Битрикс. Для этого добавьте действие "Form Urlencoded"
Добавьте параметры и их значения.
Основные параметры:
fields[TITLE] - Название лида (Обязательное поле)
fields[SOURCE_ID] - ID источника
fields[NAME] - Имя
fields[PHONE][0][VALUE] - Телефон
fields[PHONE][0][VALUE_TYPE] - Тип телефонного номера (Например: WORK)
fields[EMAIL][0][VALUE] - Email
fields[EMAIL][0][VALUE_TYPE] - Тип email (Например: WORK)
fields[COMMENTS] - Комментарий
fields[ASSIGNED_BY_ID] - ID ответственного
UF_CRM_1456385609 - Так указываются пользовательские поля. Код для каждого поля надо смотреть в Битрикс24
Полный список возможных полей можно посмотреть в документации Битрикс24 https://dev.1c-bitrix.ru/rest_help/crm/leads/crm_lead_fields.php
Шаг 2. Добавьте действие "HTTP-запрос"
Вставьте адрес входящего вебхука, скопированный в битрикс24. Добавьте в поле "Тело", данные, сформированные на предыдущем шаге.
Добавьте к нему строку crm.lead.add.json - для создания лидов в Битрикс
На этом настройка закончена. Теперь данные, которые будут поступать в вашу обработку будут отправляться в битрикс24 по API
Запустите обработку
Нажмите на кнопку "Запустить"
С этого момента данные будут обрабатываться.
Как все будет работать?
- В обработку будут поступать данные из настроенного вами "Источника данных"
- Поочередно будут выполняться все действия, которые вы настроили
- Все поступающие в обработку данные, а также статус и история их обработки будут отражаться в "Истории операций"
В случае возникновения каких-либо ошибок в процессе обработки, вы получите письмо-уведомление на email.
Если вы обнаружили ошибку или неточность в описании, либо что-то не понятно, напишите нам в чат на сайте. Мы внесем правки.