Webhooks в digital pipeline
Webhooks – это уведомление сторонних приложений посредством отправки уведомлений о событиях, произошедших в amoCRM. Вы можете настроить HTTP адреса ваших приложений и связанные с ними рабочие правила в настройках digital pipeline, в amoCRM.
Подробнее о технологии можно посмотреть в разделе WebHooks REST API. Однако, не смотря на тот факт, что применяемая технология уведомлений Webhooks в digital pipeline такая же, как и в разделе amoМаркет вашего аккаунта, она имеет несколько отличий.
- Первое отличие, более ограниченный список событий по которым будет реагировать отправка уведомлений.
- Второе отличие касается логики ретраев: если получен невалидный отклик, то система выполняет до четырёх повторных попыток доставки в течение одного часа.
Повторные попытки могут быть временно отключены для конкретного адреса при следующем условии: если за последние 5 минут от этого адреса получено более 100 невалидных откликов.
При превышении указанного лимита система приостанавливает повторные попытки на 5 минут с момента достижения порога невалидных откликов.
По истечении этого времени механизм повторных попыток автоматически возобновляется.
Список возможных событий
- При заполнении анкеты
- При входящем письме
- При входящем звонке
- После захода на сайт
Чтобы создать webhook
Пройдите в меню настроек digital pipeline из раздела Сделки/Покупатели и выберите "добавить триггер", под нужным вам этапом..
Далее выберите "API: отправить webhook".
Выберите событие, при котором будет отправляться webhook.
Введите URL, по которому будет отправляться webhook.
Формат отправляемых данных
Webhook отправляет на стороннее приложение POST переменную, которая содержит массив вида {"entity":{"action":{массив полей сущности}}}.
Параметры
| Параметр | Описание |
|---|---|
| leads | Сущность: "Сделка" |
| customers | Сущность: "Покупатель" |
Параметры событий
| Параметр | Описание |
|---|---|
| call_in | Событие при входящем вызове |
| chat | Событие при входящем сообщении из чата |
| site_visit | Событие при заходе на сайт |
| mail_in | Событие при входящем письме |
| status | Событие при переходе в этап, только у сделок |
| period | Событие при смене периода, только у покупателя |
Параметры полей сущности
| Параметр | Описание |
|---|---|
| id | id элемента сущности |
| old_pipeline_id | id старой цифровой воронки, только у сделок |
| pipeline_id | id новой цифровой воронки, только у сделок |
| old_status_id | id старого статуса, только у сделок |
| status_id | id нового статуса, только у сделок |
| old_period_id | id старого периода, только у покупателя |
| period_id | id нового периода, только у покупателя |
Пример
При входящем письме, для сделки
{
"leads": {
"mail_in": [
{
"id": 4921027,
"pipeline_id": 752662,
"status_id": 16203334
}
]
}
}При переходе в этап, для сделки
{
"leads": {
"status": [
{
"id": 4831596,
"old_pipeline_id": 752662,
"pipeline_id": 752662,
"old_status_id": 16203334,
"status_id": 16203337
}
]
}
}