Подключаем Totum к Битрикс 24

Загружаем схему подключения.

Скачайте файл по этой ссылке: https://raw.githubusercontent.com/totumonline/ttm-samples/main/samples/ttm_btx.json.gz.ttm

Загрузите его в вашу схему. Инструкция по импорту: https://youtu.be/UA7j28Ht5u4

Подготавливаем Totum к приему вебхуков из Битрикс

В Totum в Системные таблицы — Доступы — Пользователи создаем пользователя API, например btx.

В Тотум в Системные таблицы — Основные — API — Remotes выбираем пользователя для btx_deals_hash, включаем его и заменяем hash на случайный набор символов A-Z a-z 0-9.

Ставим пользователя btx для btx и включаем его.

Добавляем вебхуки в Битрикс.

В Битрикс cверху Интеграции — Rest API — Другое — Исходящий вебхук.

В URl ставим https://HOST/Remotes/btx_deals_add_hash (замените hash на ваш).

Копируем токен приложения.

Ставим токен в ttm_btx_access — h_btx_token_add.

В события выбираем Создание сделки (ONCRMDEALADD)

Создаем еще два аналогичных вебхука для Обновление сделки (ONCRMDEALUPDATE) и Удаление сделки (ONCRMDEALDELETE).

Направлять на btx_deals_edit_hash и btx_deals_delete_hash (заменив hash на ваш).

Токены надо соответственно поставить в ttm_btx_access — h_btx_token_edit и ttm_btx_access — h_btx_token_delete .

Где в Битрикс искать созданные интеграции.

В Битрикс cверху Интеграции — Rest API — Сверху закладка Интеграции.

Создаем REST-приложение в Битрикс.

В Битрикс cверху Интеграции — Rest API — Другое — Локальное приложение.

Серверное;
Путь: https://HOST/Remotes/btx (замените HOST на ваш хост);
Галочка Использует только API;
Настройка прав: CRM (crm), Пользователи (user);
Сохранить;
Скопировать Код приложения и Ключ приложения в Totum в таблицу ttm_btx_access;

В Totum в таблице ttm_btx_order заполняем:

В BTX Host ваш хост в Битрикс с https://;
Код приложения;
Ключ приложения;
Нажимаем Зарегистрировать приложение;
Если видим страницу success то можно вернуться обратно — токен будет записан в строчной части.
Идем в Системные таблицы — Основные — Настройки и крон — Кроны — Remotes и включаем крон ttm_btx.

Получаем пользователей и статусы сделок.

Идем в ttm_btx_users и нажимаем Get btx users.

Идем в ttm_btx_statusses и нажимаем Get btx statusses.

Создаем сделку в Битрикс.

Создаем новую сделку в Битрикс — если все ок, то она появится в Totum.

Добавляем в Битрикс ссылку на карточку в Totum.

В Битрикс добавим поле типа Ссылка например в Раздел Дополнительно, и заполним его каким-то значением в созданной на предыдущем шаге Сделке.

В Тотум в этой сделке нажимаем GET TEH DATA и ищем в ответе номер этого поля вида UF_CRM_1662131924042.

Открываем на редактирование поле тип Кнопка h_send_data_to_btx и в link_field_name ставим номер этого поля.

Сохраняем и проверяем, что данные дошли в Битрикс.

Подключаем автоматическую отправку изменений из Totum в Битрикс.

Теперь включаем отправку данных в Битрикс автоматически. Открываем поле f_control и включаем триггер На изменение.

После этого кнопки h_get_data_from_btx и h_send_data_to_btx можно поставить в статус Видно только Создателю.

Если нужно добавить какие-то дополнительные поля в Битрикс и получать данные в Тотум, то это надо добавить в h_get_data_from_btx.

Если надо из Тотум отправлять данные в Битрикс то новое поле надо добавить в h_send_data_to_btx.

Ссылка на документацию Битрикса.

Ссылка на все возможные команды API Битрикс 24: https://dev.1c-bitrix.ru/rest_help/crm/cdeals/crm_deal_get.php

⟵ сюда туда ⟶