Как настроить интеграцию с Bitrix24?

    Инструкция по настройке вебхуков Битрикс24 для интеграции с платформой Realting

    В данной инструкции описаны шаги для создания вебхуков, которые необходимы для передачи заявок из Realting в ваш Битрикс24.

    Вебхук — это программный код, с помощью которого отслеживают изменения в одном сервисе и передают данные об этом на другой. Выглядит как ссылка с зашифрованным кодом. Такую ссылку лучше не передавать никому, кроме вашего менеджера Realting.

    Общая схема действий:  

    1. Сформировать входящий вебхук в вашем Битрикс24;

    2. Сформировать исходящий вебхук в вашем Битрикс24;

    3. Выслать данные по обоим вебхукам (см. ниже) вашему менеджеру Realting;

    4. Выслать ID пользователя Битрикс вашему менеджеру Realting

    Сформировать входящий вебхук

    Входящий вебхук нужен для того чтобы Realting мог создавать в вашем Битриксе лиды.

    Чтобы создать входящий вебхук, следуйте этим шагам:

    1. Откройте ваш портал Битрикс24.
    2. В левом меню найдите раздел «Приложения» или «Маркет» (может быть под другим названием в зависимости от версии Битрикс24).
    3. В разделе «Разработчикам» найдите вкладку «Готовые сценарии», выберете «Другое».

    1. Создайте новый вебхук, выбрав пункт «Входящий вебхук».
    1. Заполните форму следующим образом:
    • Задайте имя для вебхука (любое, чтобы вам было удобно его найти)
    • Настройте права доступа, добавив «CRM (crm)»
    1. В генераторе запросов будет предоставлен URL, который нужно передать вашему менеджеру Realting

    * Создание входящих вебхуков в различных версиях может немного отличаться, так что рекомендуется обращаться к актуальной документации или настройкам вашего аккаунта для более точной информации.

    Сформировать исходящий вебхук

    Исходящий вебхук нужен чтобы на платформе обновился статус заявки/лида, при изменении статуса лида в Битриксе.

    1. В том же разделе «Разработчикам» выберите «Исходящий вебхук».
    1. Заполните форму следующим образом:
    • Задайте имя для вебхука (любое, чтобы вам было удобно его найти).
    • Укажите URL вашего обработчика в соответствии с примером на скриншоте.
    • Выберите события, которые будут инициировать отправку данных на указанный URL:
      • Обновление сделки (ONCRMDEALUPDATE)
      • Обновление лида (ONCRMLEADUPDATE)
    1. Далее нужно скопировать токен приложения. Этот код используется для проверки, что вебхук вызывается именно вашим Битрикс24. Его нужно передать вашему менеджеру Realting.

    * Обратите внимание, что для использования исходящего вебхука в коробочной версии Битрикс24 требуется активная лицензия. На демо-порталах этот инструмент не будет работать.

    Выслать ID пользователя Битрикс вашему менеджеру Realting

    Если вы хотите, что бы при создании лида из Realting автоматически уведомлялся конкретный сотрудник в Битриксе, то вам надо выслать ID пользователя Битрикс вашему менеджеру Realting.

    Это необязательно, если не предоставить ID пользователя, то уведомления приходить конкретному человеку не будут.

    Остается возможность настроить уведомления о лидах через «Триггеры» и т.п. функции самого Битрикс24.

    ID пользователя можно узнать только в разделе Администрирование / Список пользователей.
    https://[ваш домен]/bitrix/admin/user_admin.php

    Опубликовано