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

Обновлено:

В SyBox это делается в Настройки > Интеграции > Вебхуки.

  1. Убедитесь, что вебхук включён. Если он выключен, появится сообщение «Сначала включите этот вебхук.»
  2. На его карточке нажмите «Отправить тестовое событие». Вы увидите сообщение «Тестовое событие отправляется. Его результат появится в разделе «Доставки».»
  3. Через несколько секунд откроется список «Доставки» с ответом вашего сервера. На карточке также отобразится последний ответ вашего сервера и время попытки. Успешный ответ (например, «HTTP 200») подсвечивается зелёным, ошибка — красным. Статус «Последняя доставка: никогда» означает, что событий ещё не было.
    To test a webhook: "HTTP 200" marked on the screen in SyBox

Тестовое событие содержит "event": "test" и не передаёт данных клиентов. Отправлять его можно раз в несколько секунд; если нажать раньше, появится сообщение «Тест был отправлен только что. Повторите попытку через несколько секунд.»

Вопросы

Я потерял ключ подписи.

Посмотреть его повторно невозможно. Откройте редактирование вебхука, введите в поле «Ключ подписи» новый ключ, сохраните настройки и укажите этот же ключ на своём сервере.

Мой вебхук отключился, хотя я его не выключал.

SyBox отключил его после того, как ваш сервер выдал ошибку 20 раз подряд на протяжении более чем часа. См. раздел «Автоматическое отключение» выше: исправьте работу сервера и снова включите вебхук в течение 24 часов, чтобы ожидающие события были отправлены.

На вебхук ничего не приходит.

Сначала нажмите «Отправить тестовое событие» на его карточке и загляните в «Доставки». Затем проверьте четыре момента: (1) Вебхук включён. (2) Выбрано хотя бы одно событие. (3) К вебхуку привязан нужный номер WhatsApp или выбрано «Все номера». (4) Канал, по которому пришло сообщение, поддерживается вебхуками (WhatsApp, Messenger, Instagram, Telegram, TikTok или онлайн-чат; не почта и не SMS). Затем посмотрите статус последней доставки на карточке.

На карточке горит красная ошибка (например, HTTP 404 или 500).

SyBox смог связаться с адресом, но сервер вернул код ошибки. Проверьте правильность URL и логи вашего сервера.

Не удаётся создать вебхук, пишет, что недостаточно прав.

Для добавления и включения вебхука нужны сразу два права: «Управление каналами» и «Показывать номер контакта». Обратитесь к администратору.

Подробнее о Вебхуки.