Передача сделок из Bitrix24 в Rubitime

Содержание:

• 1. Подготовка к обмену данными
  • 1.1. Создание входящего вебхука в APInita
  • 1.2. Создание исходящего вебхука в Битрикс 24
  • 1.3. Создание входящего вебхука в Битрикс 24
  • 1.4. Создание API ключа в Rubitime
• 2. Создание сценария в APInita
  • 2.1. Добавление подключения
  • 2.2. Настройка сценария

1. Подготовка к обмену данными

1.1. Создание входящего вебхука в APInita

На странице "Сценарии" нажмите кнопку "+" (1):

В левом верхнем угулу (2) укажите название сценария, например: "Создание записи в Rubitime из сделки Битрикс 24". Затем нажмите кнопку "Добавить" (3), в открывшемся окне выберите "Webhook" (4):

Скопируйте отобразившийся URL (5), нажав на него левой кнопкой:

1.2. Создание исходящего вебхука в Битрикс 24

В левом меню системы перейдите в раздел "Приложения -> Разработчикам" (1) и нажмите кнопку "Другое" (2):

Если Вы только зарегистрировались в системе, у Вас появится экран включения демо-тарифа и сообщение о том, что приложение доступно только на платных тарифах - нажмите "Включить Демо-тариф".

Нажмите кнопку "Исходящий вебхук", в поле "URL вашего обработчика" (3) вставьте ссылку, полученную в пункте 1 (5), скопируйте значение поля "Токен приложения" (4), в поле "События" (5) выберите "Создание сделки" и после нажмите кнопку "Сохранить":

1.3. Создание входящего вебхука в Битрикс 24

Входящий вебхук нужен для получения данных сделки. Выполните пункт 1.3. по ссылке и скопируйте значение поля "Вебхук для вызова rest api".

1.4. Создание API ключа в Rubitime

Перейдите в раздел "Настройки -> Получение и сохранение данных при помощи API" и скопируйте ключ (1):

2. Создание сценария в APInita

2.1. Добавление подключения

Переходим в раздел "Подключения" и нажимаем "+":

Выбираем тип подключения "Custom" (1), вводим название, например "Битрикс 24 исходящий вебхук: токен" (2), ключ указываем "token" (3), значение подставляем полученное из пункта 1.2. (4), далее жмем "Сохранить" и копируем полученный ID подключения (4):

2.2. Настройка сценария

Возвращаемся в сценарий, созданный в пункте 1.1. После созданного первого шага нажимаем "+" (1), выбираем модуль "IF", вводим название "Проверка токена" (2) и указываем условие:

{{ s1.body.auth.application_token == connections[xxx].body.token }}

- где "xxx" это ID подключения, полученное в пункте 2.1.

После IF модуля добавляем следующий модуль HTTP. Название шага (1) указываем "Получение данных сделки", URL запроса (2) вставляем URL входящего вебхука, полученное в пункте 1.3., метод (3) "POST", тип "application/json", ключ (4) "ID" (именно заглавными буквами), значение "{{ s1.body.data.FIELDS.ID }}":

После получения данных сделки остается последний шаг - создание записи в Rubitime. Для этого добавляем еще один HTTP модуль:

Укажите название (1) "Создание записи в Rubitime", URL (2) "https://rubitime.ru/api2/create-record", метод (3) "POST", тип данных "application_json", поля (4) "branch_id", "cooperator_id" и "service_id" получить ID (7) вы можете открыв филиал/сотрудника/услугу на редактирование:

Вам так же нужно указать дату и время начала записи по Вашему местному времени (5), status и duration. Подробнее о параметрах можно узнать здесь: https://rubitime.ru/faq/api

Дату записи Вы можете брать из полученных полей сделки предыдущего шага (6): это могут быть как дополнительные поля созданные в Битрикс 24, так и стандартные.

Не забудьте включить сценарий для возможности приема входящих данных (кнопка Вкл/Выкл справа от названия сценария).