Инструкция по настройке Webhook на стандартные действия из раздела Leeloo.ai API

Owned by Andrew Mose
Last updated: Oct 15, 2024
3 min read

UA

image-20240611-123449.png

US

image-20240611-123805.png

RU

image-20240611-131051.png

 

UA

image-20240611-123449.png

US

image-20240611-123805.png

RU

image-20240611-131051.png

 

Раздел Leeloo.ai API на платформе Leeloo.ai позволяет автоматизировать передачу данных о стандартных событиях, происходящих на платформе, на внешний сервер. Это полезно для интеграции с CRM-системами и другими инструментами, которые обрабатывают информацию о заказах, продажах, подписках и сообщениях в чатах.

Активация вебхуков
Чтобы активировать вебхуки, выполните следующие шаги:

  1. Перейдите в раздел Настройки → Leeloo API на панели управления вашей платформой.

  2. В открывшемся окне отметьте чекбокс Включён Webhook.

    ksnip_20240930-124146.png

3. В поле Webhook URL введите URL вашего webhook-сервера который будет принимать запросы с платфомы.

ksnip_20240930-125135.png

Протестировать и звять Webhook URL вы можете с помощью онлайн сервисов таких как https://webhook.site

4. Выберите, какие события должны передаваться на ваш сервер:

  • Заказ (человек нажал кнопку «Купить», ввёл данные и подтвердил заказ).

  • Продажа (факт продажи: подтверждение ручного платежа или успешная оплата через платёжную систему).

  • Подписка (если пользователь подписался на ЛГТ в туннеле продаж).

  • Входящее сообщение (лид написал сообщение в ваш бот который интегрирова в платформу Leeloo).

ksnip_20240930-125406.png

Ниже вы можете ознакомтся с примерами событий, передаваемых через Webhook
Когда одно из указанных событий происходит, на ваш сервер передается запрос с JSON-данными. Примеры JSON-ответов для каждого типа события:

Заказ (ORDER):

{ "type": "ORDER", "data": { "order_id": "5eabfdfb4eee28000e33dac7", "account_id": "5e9eed3c8b2dc7000faff207", "offer_name": "1111", "price": 10770, "currency": "RUB", "email": "test@gmai.com", "phone": "+380952938955", "created_at": "2020-05-01T10:47:06.474Z" } }


Продажа (SALE):

{ "type": "SALE", "data": { "order_id": "5eabfeadaf2213000cc5ee1e", "account_id": "5e9eed3c8b2dc7000faff207", "offer_name": "1111", "price": 10770, "currency": "RUB", "payment_method": "5d08cd71bcc043000c4bc5fc", "email": "test@gmai.com", "phone": "+380952938955", "created_at": "2020-05-01T10:49:17.260Z" } }


Подписка (SUBSCRIBE):

{ "type": "SUBSCRIBE", "data": { "account_id": "5f46a0ce5fa0ee000e697436", "tunnel_name": "первый туннель", "leadgentool_name": "подписка1", "email": "tesst@gmail.com", "phone": "+380952938955", "created_at": "2020-09-04T10:09:44.394Z" } }


Входящее сообщение (INCOME_MESSAGE):

{ "type": "INCOME_MESSAGE", "data": { "text": "подписка", "account_id": "5dd691740f69bb000d45dbcb", "email": "test@gmail.com", "phone": "+380664445432", "created_at": "2020-07-13T12:01:44.333Z" } }

Данные Phone, Email, Account_name и другие пользовательские поля берутся из карты клиента на платформе Leeloo.AI.

ksnip_20240930-123713.png

Настройка параметров синхронизации
После активации вебхуков на странице настроек, можно обновить время синхронизации данных. Это поможет поддерживать актуальность информации на вашем сервере.
Что бы это сделать Нажмите на кнопку “Обновить время синхронизации”

WebHook отправляется из платформы на сервер раз в 15 минут.

ksnip_20240930-131101.png

Эта кнопка отправит вебхуки которые “скопились” в рамках 15-ти минут. И запустит таймер снова.

Вебхуки на платформе Leeloo.ai предоставляют гибкие возможности для интеграции с другими системами.
Правильная настройка этих запросов позволяет своевременно получать актуальные данные о действиях пользователей на платформе.