Webhooks

Webhooks в digital pipeline

Webhooks – это уведомление сторонних приложений посредством отправки уведомлений о событиях, произошедших в amoCRM. Вы можете настроить HTTP адреса ваших приложений и связанные с ними рабочие правила в настройках digital pipeline, в amoCRM.

Подробнее о технологии можно посмотреть в разделе WebHooks REST API. Однако, не смотря на тот факт, что применяемая технология уведомлений Webhooks в digital pipeline такая же, как и в разделе настроек вашего аккаунта ("Настройки -> Интеграции"), она имеет несколько отличий.

  • Первое отличие, более ограниченный список событий по которым будет реагировать отправка уведомлений.
  • Второе отличие, из digital pipeline, в отличии от настроек аккаунта, webhook отправляется только один раз, по произошедшему указанному событию. Без попыток повторной отправки.

Список возможных событий

  • При выходящем письме
  • При входящем звонке
  • При входящем сообщении из чата
  • При заходе на сайт
  • При переходе в этап

Чтобы создать 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
            }
        ]
    }
}

При смене периода, для покупателя

{
    "customers": {
        "period": [
            {
                "id": 4831596,
                "old_period_id": 16203334,
                "period_id": 16203337
            }
        ]
    }
}