Сообщение `invalidUrl` у Viber не означает автоматически «просрочен сертификат». При установке webhook платформа сначала должна разрешить домен, установить HTTPS-соединение, проверить доверие к сертификату и получить от endpoint ответ `200 OK`. Разложите одну попытку по этим этапам: так становится видно, оборвалась ли она до reverse proxy или уже дошла до приложения.

У webhook должен быть публичный HTTPS-адрес с сертификатом от доверенного центра. Самоподписанный сертификат Viber не принимает. В актуальной документации сервиса также указано требование TLS 1.2 или новее. Не ослабляйте TLS и не отключайте проверку сертификата: это не исправляет запросы Viber и создаёт отдельную уязвимость.

Ответ теста указывает на конкретный слой

НаблюдениеГде искатьЧто подтвердить
DNS не разрешаетсяпубличная зона DNSA/AAAA ведут на действующий proxy
TLS alert до HTTPсертификат и протоколыимя, срок, цепочка, TLS 1.2+
в access log нет запросаfirewall, CDN, SNIпорт 443 доступен извне
Viber получает не 200route и middlewarecallback не перенаправлен на login или 404
200 приходит слишком поздносинхронная логикаподтверждение отделено от тяжёлой обработки

Проверяйте с внешнего узла, а не только с самого сервера. Локальный `curl` может использовать внутренний DNS, обходить CDN или доверять корпоративному CA. Для IPv6 отдельно убедитесь, что AAAA-запись ведёт на работающий endpoint: часть клиентов выберет её, даже если IPv4 настроен верно.

Цепочка должна включать промежуточные сертификаты

Сервер отправляет leaf-сертификат домена и необходимые промежуточные сертификаты. Корневой сертификат обычно уже находится в trust store клиента и не заменяет intermediate. Типичная ошибка: браузер достраивает цепочку из своего кэша, а новый серверный клиент видит только leaf и не может прийти к доверенному корню.

openssl s_client -connect bot.example.com:443 \
  -servername bot.example.com -showcerts

# затем отдельная проверка HTTP без секретного token
curl -i https://bot.example.com/viber/webhook
  • Имя в URL должно входить в SAN сертификата; сертификат только для другого поддомена не подходит.
  • Проверьте notBefore/notAfter и часы сервера, но не публикуйте приватный ключ или authentication token.
  • На виртуальном хосте должен выбираться нужный сертификат по SNI, а не сертификат сайта по умолчанию.
  • После обновления сертификата проверьте именно публичный адрес через CDN или балансировщик.

Проверочный callback обязан вернуть обычный 200

После вызова `set_webhook` Viber отправляет событие `webhook` на указанный URL. Проверка считается успешной, когда сервер получает HTTP 200; редирект, страница авторизации, 403 от WAF, 404 из-за завершающего слеша и 5xx считаются ошибкой. Создайте точный route для POST и проверьте, что middleware не требует cookie браузера и не пытается разобрать событие как пользовательское сообщение.

Подтверждение должно быть коротким: принять тело, выполнить минимальную валидацию, записать request ID и вернуть 200. Если callback запускает обращение к CRM, генерацию ответа или долгую транзакцию до отправки статуса, доступный endpoint может выглядеть недоступным из-за тайм-аута. Работу после приёма переносите в очередь с идемпотентным ключом.

Логи связывают set_webhook и входящий запрос

Для одной попытки сохраните время UTC, домен, итог `set_webhook` со `status` и `status_message`, TLS-ошибку на proxy, HTTP status и длительность callback. Тело пользовательских сообщений и token в журнал не нужны. Callback от Viber содержит подпись: её проверяют HMAC-SHA256 по исходному JSON с token аккаунта как ключом, сравнивая результат безопасным способом.

  1. Отправить set_webhook и записать ответ API без authentication token.
  2. Найти входящий POST в CDN, reverse proxy и приложении по времени.
  3. Если POST отсутствует, исследовать DNS, TLS и сетевую доступность.
  4. Если POST есть, сверить route, подпись, status и время ответа.
  5. Повторить проверку снаружи после исправления, не меняя сразу несколько слоёв.

Готовность проверяется после продления сертификата

Автоматическое продление считается рабочим только после reload процесса, который обслуживает TLS. Полезный тест — сравнить serial и срок сертификата на диске с тем, что реально отдаёт публичный hostname. Если сертификат завершается на CDN, обновление файла в origin вообще не меняет внешний ответ; владелец сертификата должен быть определён явно.

Итоговый критерий прост: внешний клиент строит доверенную цепочку для точного hostname, согласует TLS 1.2+, POST `webhook` достигает нужного route, получает быстрый 200, а ответ `set_webhook` содержит `status: 0`. После этого отдельно тестируют подписанный message callback и повторную доставку; SSL уже не смешивают с логикой бота.

Проверенные источники