Webhooks

Webhooks — уведомления о входящих сообщениях

WazzaBee может отправлять HTTP-уведомления на ваш сервер при получении входящих сообщений.

Регистрация вебхука

PATCH /v1/webhooks

{
  "webhooksUri": "https://your-server.com/webhook",
  "subscriptions": ["messages_incoming"]
}

Параметры

Параметр	Тип	Обязательный	Описание
webhooksUri	string	✅	URL для получения уведомлений (HTTPS рекомендуется)
subscriptions	string[]	❌	Типы событий: messages_incoming, messages_outgoing, messages_status

Ответ (200 OK)

{
  "success": true,
  "webhooksUri": "https://your-server.com/webhook",
  "subscriptions": ["messages_incoming"],
  "secret": "your_webhook_secret_hex",
  "message": "Вебхук установлен. Сохраните secret — он используется для подписи уведомлений (HMAC-SHA256)."
}

Получение настроек вебхука

GET /v1/webhooks

curl -X GET https://YOUR_SUPABASE_URL/functions/v1/api-gateway/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY"

Формат уведомления

При поступлении входящего сообщения WazzaBee отправит POST-запрос на ваш webhooksUri:

{
  "event": "message.incoming",
  "timestamp": "2026-02-24T12:00:00Z",
  "data": {
    "channelId": "uuid",
    "channelType": "whatsapp_qr",
    "messageId": "uuid",
    "contactId": "uuid",
    "chatId": "uuid",
    "direction": "incoming",
    "type": "text",
    "text": "Привет!",
    "mediaUrl": null
  }
}

Подпись (HMAC-SHA256)

Каждый запрос содержит заголовок X-Webhook-Signature с HMAC-SHA256 подписью тела запроса, используя ваш secret. Проверяйте подпись для безопасности.

Повторные попытки

• Если ваш сервер вернёт ошибку (не 2xx), WazzaBee попробует повторить запрос
• После 10 неудачных попыток вебхук автоматически деактивируется
• Статус можно проверить через GET /v1/webhooks