Настроить вебхуки

Подготовьте адрес

Нужен публичный HTTPS URL на стандартном порту 443 с действительным сертификатом. Локальные и частные адреса не принимаются. Перенаправления не выполняются. Для разработки используйте публичный тестовый endpoint с проверкой подписи.

Настройка

1. В кабинете откройте «Вебхуки» и укажите URL.
2. Включите «Доставлять события на этот адрес». Кабинет отправляет message.received и message.status.updated; выбрать только один тип можно через API.
3. Сохраните секрет, показанный при первом создании. Он отличается от API-ключа.
4. Отправьте тестовое событие и проверьте журнал доставок.
5. Напишите бизнесу с тестового телефона и проверьте реальное событие.

Через API

{
  "url": "https://example.com/hooks/waix",
  "events": ["message.received", "message.status.updated"],
  "active": true
}

PUT /webhook с webhooks:write. Один endpoint на организацию. GET /webhook возвращает настройки и последние доставки. POST /webhook/test отправляет тест. POST /webhook/rotate-secret заменяет секрет; DELETE /webhook удаляет endpoint.