Перейти к основному содержимому

REST-хуки для Zapier, Make и n8n

REST-хук позволяет платформе автоматизации запрашивать у MonoPbx события по одному триггеру. Когда кто-то включает Zap, сценарий или рабочий процесс, платформа подписывает свой адрес на одно событие. Когда выключает, отписывается. После этого MonoPbx отправляет каждое подходящее событие на этот адрес подписанным POST.

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

Вызовы​

Все вызовы используют API-ключ или токен пользователя. См. Начало работы с API.

ВызовПраво
POST /api/v1/hooks/subscriptionsintegrations:write
GET /api/v1/hooks/subscriptionsintegrations:read
DELETE /api/v1/hooks/subscriptions/{id}integrations:write

Подписка:

{ "target_url": "https://hooks.zapier.com/hooks/standard/123/abc", "event": "call.ended", "source": "zapier" }
  • target_url должен быть публичным адресом https. Loopback, частные сети и внутренние имена отклоняются.
  • event — один тип события или один шаблон темы, например call.*. Это должно быть событие, которое ключ вправе получать по всей компании, с правом, указанным в разделе Исходящие вебхуки. Иначе ответ 400.
  • source необязателен (zapier, make, n8n) и помогает различать подписки.

Ответ 201 содержит id подписки и секрет подписи Standard Webhooks secret, показываемый один раз. Сохраните id для отписки. Список никогда не показывает секреты и не включает точки, созданные в консоли. Удаление подписки также удаляет ожидающие доставки; неизвестный id, id другой компании или точка из консоли дают 404.

Получение событий​

Каждая доставка — JSON-конверт {id, type, occurred_at, data} с заголовками Standard Webhooks, описанными в разделе Исходящие вебхуки. Используйте id, чтобы игнорировать дубликаты.

Zapier, Make и n8n​

Используйте триггер-вебхук платформы, чтобы подписываться этими вызовами, и публичный API для действий. Те же события можно получать и на точке вебхука.