REST-хуки для Zapier, Make и n8n
REST-хук позволяет платформе автоматизации запрашивать у MonoPbx события по одному триггеру. Когда кто-то включает Zap, сценарий или рабочий процесс, платформа подписывает свой адрес на одно событие. Когда выключает, отписывается. После этого MonoPbx отправляет каждое подходящее событие на этот адрес подписанным POST.
Подписка — это точка приёма исходящего вебхука для одного типа события, поэтому подпись, повторы, защита исходящих адресов и правила о том, кто какое событие может получать, те же. Подписка учитывается в лимите точек вебхуков вашей компании.
Вызовы
Все вызовы используют API-ключ или токен пользователя. См. Начало работы с API.
| Вызов | Право |
|---|---|
POST /api/v1/hooks/subscriptions | integrations:write |
GET /api/v1/hooks/subscriptions | integrations: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 для действий. Те же события можно получать и на точке вебхука.