Настройте доступ
Настройте провайдера в разделе коммуникаций с гостями заведения. Идентификатор провайдера и выданный webhook-секрет определяют входящий канал. Протокол предназначен для настроенного коннектора сообщений, а не общего доступа к записям гостей.
Маршрут кабинета: /venues/:venueId/guests → Настройки → Провайдеры. Требуется право guests.providers.manage. Активируйте выбранного провайдера и однократно скопируйте выданный секрет webhook.
Первый успешный сценарий
Выполните шаги по порядку. Откройте каждый метод для точного тела, обязательных заголовков и схемы ответа.
- Для входящего сообщения передайте идентификаторы события и сообщения провайдера, контакт отправителя, текст и время события.
- Для доставки исходящего передайте идентификатор сообщения провайдера и состояние доставки.
- Подпишите timestamp + "." + JSON.stringify(parsed DTO) секретом UTF-8 с результатом base64url. Проверьте, применено событие впервые или распознано как повтор.
Состояния, повторы и восстановление
Дедупликация определяется идентификаторами событий и сообщений провайдера. Сам повтор подписи в этом профиле не является универсальной ошибкой. Обновления доставки сохраняют прошлые попытки; неизвестные сообщения требуют сверки.