Инструкция по подключению Rest API агент и подключение к Bitrix24


  1. Получите доступ к инструментам разработчика bitrix24 (меню Разработчикам - Интеграции - вкладка Готовые сценарии - Интегрировать с внешними системами - Добавить лиды). Доступ открыт только на платных тарифах.
  2. Вы получите Вебхук для вызова rest api, возможность выбрать уже готовый метод и использовать Генератор запросов:
  3. Подставив с помощью конструктора генератора запросов требуемые поля, вы получите URL, который может добавлять новые сделки.
  4. Сохраните настройки. Из всегда можно будет найти и, при необходимости, отредактировать на вкладке Интеграции.
  5. Далее, перейдем к формированию сценария в системе CraftTalk, в том числе к созданию restagent.
  6. Перейдите в Базу знаний CraftTalk, на вкладке Слоты создайте слоты, которые будете запрашивать в сценарии. В нашем случае это слоты с идентификаторами bitrix_name (Имя ), bitrix_last_name (Фамилия ), bitrix_company (Компания ), bitrix_phone (Телефон ) и bitrix_email (Email ).
  7. Перейдите на вкладку Записи базы данных и создайте статьи для сценария лидогенерации. Сначала создадим статью, в которой будем запрашивать данные клиента и вызывать агента, который будет передавать данные в bitrix, чтобы создать сделку. Внимание: Условие __FILLED__ прописывается для каждого слота.
  8. Опубликуем статью (сначала создадим черновик, а затем опубликуем его).
  9. Создадим статью bitrix_delete_slots, в которой в ответе выведем благодарность за оставленные данные и сбросим значения слотов, которые заполнил клиент, командой DELETE_SLOT_VALUES bitrix_*|yes_mail, где bitrix_*|yes_mail - регулярное выражение, позволяющее сбросить значения всех слотов, ктоторые начинаются на bitrix_ и слота yes_mail. На вкладках Примеры вопросов и Слоты информацию не вносим. Добавим к этому же ответу кнопку для перехода в основное меню, чтобы клиент мог перейти в него, если посчитает необходимым.
  10. Сохраним статью и перейдем к созданию агента интеграции.
  11. В меню Настройки проекта - Агенты нажимаем кнопку Добавить агента, выбираем из списка Вызов REST API. Заполняем поля агента:
    • Название агента - rest_bitrix;
    • URL берем из генератора запросов bitrix24 (весь URL до знака вопроса ?). Выглядит примерно так:
  12. Метод - GET;
  13. Тайм-аут - можно оставить значение по-умолчанию;
  14. Сообщение в случае успешного вызова - команда вызова статьи bitrix_delete_slots из БЗ:
  15. Сообщение в случае ошибки - это может быть просто текст, написанный в поле, или вызов статьи из БЗ (по аналогии с сообщением в случае успешного вызова);
  16. HTTP-заголовки запроса;
  17. Шаблон тела JSON - подстановка в поля запроса содержимого слотов:
  18. {
  19. "fields" : {
  20. "NAME" : "{{bitrix_name}}",
  21. "TITLE" : "{{bitrix_company}}",
  22. "LAST_NAME" : "{{bitrix_last_name}}",
  23. "PHONE" : [
  24. {
  25. "VALUE" : "{{bitrix_phone}}",
  26. "VALUE_TYPE" : "WORK"
  27. }
  28. ],
  29. "EMAIL" : [
  30. {
  31. "VALUE" : "{{bitrix_email}}",
  32. "VALUE_TYPE" : "WORK"
  33. }
  34. ]
  35. }
  36. }
  37. Сохраняем агента.