Интеграция
Получение событий из Клиентикс CRM → Создание лида в Envybox
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Приём событий из Клиентикс CRM через HTTP webhook: URL в clientix/admin/eventHandlers, настройка обработчика событий в админке CRM для выбранного типа события.
- Создание лида в Envybox через HTTP POST на URL аккаунта envycrm.com: api_key из «Настройки» → «Интеграция» → «API» и поля заявки в JSON.
Отдельные инструкции: источник «Получение событий из Клиентикс CRM» · действие «Создание лида в Envybox»
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «klientiks.ru» и нажмите кнопку «Выбрать».
Источник «klientiks.ru»
Клиентикс CRM отправляет события на webhook URL. Создайте обработчик в eventHandlers и укажите URL источника.
URL вебхука
- Выберите нужный тип источника и нажмите «Выбрать».
- Нажмите «Сохранить».
- Скопируйте «URL» целиком - адрес уже содержит параметры приёма данных.
Обработчик в Клиентикс
- В Клиентикс CRM откройте
https://klientiks.ru/clientix/admin/eventHandlers. - Создайте или отредактируйте обработчик нужного события.
- Вставьте скопированный URL источника.
- Сохраните обработчик событий.
Действие «Envybox. Создание лида»
Envybox CRM принимает лиды POST-запросом на URL аккаунта. Скопируйте api_key в настройках интеграции и передайте поля заявки.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
API-ключ
- В Envybox откройте «Настройки» → «Интеграция» → «API» и скопируйте api_key.
- Запишите URL аккаунта, например
https://test.envycrm.com.
Параметры запроса
Действие настраивается через «HTTP-запрос».
- Выберите «HTTP-запрос» и нажмите «Выбрать».
- В поле «HTTP-метод» выберите
POST. - В поле «Адрес» укажите URL вашего аккаунта Envybox.
- В «Заголовки» добавьте
Content-Typeсо значениемapplication/json. - В поле «Тело» через «Компоновщик JSON» передайте
api_keyи поля лида. - Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».