Инструкция по подключению Rest API агент и подключение к Bitrix24
Получите доступ к инструментам разработчика bitrix24 (меню Разработчикам - Интеграции - вкладка Готовые сценарии - Интегрировать с внешними системами - Добавить лиды). Доступ открыт только на платных тарифах.
Вы получите Вебхук для вызова rest api, возможность выбрать уже готовый метод и использовать Генератор запросов:
Подставив с помощью конструктора генератора запросов требуемые поля, вы получите URL, который может добавлять новые сделки.
Сохраните настройки. Из всегда можно будет найти и, при необходимости, отредактировать на вкладке Интеграции.
Далее, перейдем к формированию сценария в системе CraftTalk, в том числе к созданию restagent.
Перейдите в Базу знаний CraftTalk, на вкладке Слоты создайте слоты, которые будете запрашивать в сценарии. В нашем случае это слоты с идентификаторами bitrix_name (Имя ), bitrix_last_name (Фамилия ), bitrix_company (Компания ), bitrix_phone (Телефон ) и bitrix_email (Email ).
Перейдите на вкладку Записи базы данных и создайте статьи для сценария лидогенерации. Сначала создадим статью, в которой будем запрашивать данные клиента и вызывать агента, который будет передавать данные в bitrix, чтобы создать сделку. Внимание: Условие __FILLED__ прописывается для каждого слота.
Опубликуем статью (сначала создадим черновик, а затем опубликуем его).
Создадим статью bitrix_delete_slots, в которой в ответе выведем благодарность за оставленные данные и сбросим значения слотов, которые заполнил клиент, командой DELETE_SLOT_VALUES bitrix_*|yes_mail, где bitrix_*|yes_mail - регулярное выражение, позволяющее сбросить значения всех слотов, ктоторые начинаются на bitrix_ и слота yes_mail. На вкладках Примеры вопросов и Слоты информацию не вносим. Добавим к этому же ответу кнопку для перехода в основное меню, чтобы клиент мог перейти в него, если посчитает необходимым.
Сохраним статью и перейдем к созданию агента интеграции.
В меню Настройки проекта - Агенты нажимаем кнопку Добавить агента, выбираем из списка Вызов REST API. Заполняем поля агента:
Название агента - rest_bitrix;
URL берем из генератора запросов bitrix24 (весь URL до знака вопроса ?). Выглядит примерно так:
Метод - GET;
Тайм-аут - можно оставить значение по-умолчанию;
Сообщение в случае успешного вызова - команда вызова статьи bitrix_delete_slots из БЗ:
Сообщение в случае ошибки - это может быть просто текст, написанный в поле, или вызов статьи из БЗ (по аналогии с сообщением в случае успешного вызова);
HTTP-заголовки запроса;
Шаблон тела JSON - подстановка в поля запроса содержимого слотов: