Как добавить вебхук

Обновлено:

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

  1. Перейдите в Настройки > Интеграции > Вебхуки.
    Settings, Webhooks: an active webhook with its last result, and the "Add webhook" button
  2. Нажмите «Добавить вебхук».
    The new webhook window: its name and the address it calls
  3. Укажите «Название».
  4. Введите «URL назначения». Это должен быть «Публичный https-адрес, доступный для нас». Обычный http, а также локальные и внутренние IP-адреса не принимаются.
  5. В блоке «События» отметьте хотя бы одно событие. «Входящее сообщение» выбрано по умолчанию.
  6. Необязательно: включите «Расшифровка голоса», чтобы получать голосовые сообщения вместе с текстом.
  7. В блоке «Номера» оставьте вариант «Все номера», чтобы отслеживать все линии WhatsApp, либо выключите его и выберите только нужные номера.
  8. Нажмите Сохранить.
  9. В окне появится «Ключ подписи». «Скопируйте сейчас — показывается только один раз». Сохраните его на своём сервере.

Вопросы

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

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

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

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

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

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

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

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

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

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

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