+7 495 255 06 20
Войти Начать бесплатно
Сменить регион сайта

Отправка и получение webhook в Битрикс24

В этой инструкции мы разберем, как настроить Битрикс24 на отправку и прием webhook. Научим бота ChatApp запрашивать оценку при перемещении карточки на новый этап воронки, а в конце вставлять оценку или комментарий клиента из сообщения в эту же карточку. Настройка проходит в 3 шага:

Шаг 1. Настроить Битрикс24 на приемку webhook

Это подготовительный этап. Он нужен, чтобы получить ссылку для исходящего запроса, по которому в конце сценария изменится поле в карточке.

1. Зайти в Битрикс24 → нажмите «Разработчикам» → «Прочее» → «Входящий вебхук».

2. В «Настройке прав» выберите «CRM».

3. Скопируйте «Вебхук для вызова rest api» и сохраните его у себя. Он понадобится позже для создания «Отправка запроса» в боте ChatApp.

4. Нажмите сохранить

Шаг 2. Настроить бота в редакторе сценариев ChatApp

1. Зайдите в редактор сценариев;

2. Создайте блок «Вебхук»;

3. Создайте блок «Отправка сообщения*»;

4. Создайте блок «Ожидание сообщения»;

5. Создайте блок «Отправка запроса»;

6. В отправку запроса вставьте скопированную ранее ссылку «Вебхук для вызова rest api» + /crm.deal.update?  (Символ вопроса после метода обязателен)

7. В блоке «Входящий webhook» создайте 2 поля и впишите в одно «chat_id», а во второе «id». Автоматически создаются локальные переменные с таким же названием.

8. В блоке «Отправка сообщения*» выберите:

  • В «ChatID» — переменную chat_id;
  • В «Линии» — линию с которой хотите отправить сообщение;
  • В «Мессенджере» — мессенджер в котором хотите отправить сообщение.
  • Введите текст сообщения.

11. В блоке «Отправка запроса» перейдите в «Params»:

  • В «key» введите «ID» сделки. И id поля в формате fields[UF_CRM_**********], чтобы Битрикс24 понимал, какую карточку и какое поле нужно изменить.

1. Перейдите в Пользовательские поля в Битрикс24.

2. Откройте список полей любой из сущностей.

3. Выберите нужную сущность и нажмите на название.

4. Откроется страница редактирования пользовательского поля, здесь в URL страницы и находится нужный ID поля CRM.

Например: PHONE, EMAIL, UF_123123332

Коды стандартных полей можно узнать здесь: лид, сделка, контакт, компания

Коды пользовательских полей необходимо брать из url при посещении страницы редактирования поля. Например: https://portal.bitrix24.ru/crm/configs/fields/CRM_LEAD/edit/UF_CRM_614D2FEF694EE/ - здесь UF_CRM_614D2FEF694EE - это и есть нужный id (code) поля.

Для пользовательских полей поддерживаются только строковые не множественные поля.

Логика сохранения полей:

При поступлении информации для сохранения из бота, в чат ОЛ отправляется специальное системное сообщение (без него нельзя).

Далее получаем привязанные сущности к чату на данный момент (лид, сделка, контакт, компания).

В найденные сущности делаем попытку установить переданные данные.

Важно: Обязательно необходимо наличие компании в модуле "Мой бизнес", в настройках которого обязательно должен быть подключен bitrix портал к компании.

  1. Откройте карточку в Битрикс 24.
  2. Нажмите правой кнопкой мыши по нужному полю.
  3. Выберите «Посмотреть код».
  4. Скопируйте ID поля (то что находится напротив «name=»).

  • В «value» введите {{id}} и {{massage}} (их нужно выбрать из выпадающих значений после ввода «{{», чтобы бот Битрикс24 понимал, какие значения нужно вставить.

12. Сохраните и опубликуйте бота.

Шаг 3. Добавить исходящий вебхук в воронку Битрикс

1. Скопируйте ссылку из блока «Входящий вебхук»;

2. Зайдите в Битрикс → CRM → Сделки → Канбан → Роботы;

3. Добавьте в нужную колонку робота «Исходящий вебхук»;

4. В поле «Хендлер:» вставьте скопированную ссылку из блока «Входящий вебхук»;

5. Добавьте нужные параметры. В нашем примере это chat_id и id. Они добавляются к ссылке через символ «&». Пример готовой ссылки на скриншоте:

6. Нажмите «Сохранить».

Готово! Теперь при переносе карточки сделки в выбранную вами колонку бот отправит сообщение клиенту. Ответ клиента появится в выбранном вами поле в CRM.

Если остались вопросы, посмотрите видео с интсрукцией

Оставить заявку на услуги интегратора