Начните с одного тестового сообщения: найдите его message_token в ответе отправки и такой же идентификатор во входящих callbacks. Затем проверьте подписку webhook на seen. Успешный запрос отправки не подтверждает, что пользователь открыл разговор, а отсутствие seen не доказывает, что текст точно не был увиден.
Три результата отвечают на разные вопросы
В Viber REST API delivered означает доставку на устройство, seen — открытие разговора, содержащего сообщение. События delivered и seen могут быть исключены фильтром event_types. При нескольких устройствах возможны несколько delivered для одного сообщения. Документация Viber API 7.3.0 проверена 29 октября 2026 года.
| Наблюдение | Допустимый вывод |
|---|---|
| Успешный ответ отправки | Запрос принят без указанной ошибки |
| delivered | Есть подтверждение доставки на устройство |
| seen | Платформа прислала событие открытия разговора |
| Нет callback | Подтверждение в системе отсутствует |
| Два delivered | Не обязательно две отправки |
В интерфейсе поддержки называйте состояние точно. Зелёная отметка «прочитано» по одному HTTP-успеху создаёт ложную уверенность у менеджера. Также событие seen не является доказательством понимания текста или подтверждённым согласием на действие. Для такого подтверждения проектируется отдельный ответ пользователя.
Callback может обогнать локальную запись отправки
Условная связь статуса:
канал + аккаунт бота + message_token -> исходящее сообщение
callback.event -> тип наблюдения
callback.timestamp -> время события платформы
received_at -> время приёма вашим сервером
Не найдено исходящее -> сохранить для последующего связывания,
не присваивать последнему сообщению диалога.Если обработчик просто отбрасывает неизвестный message_token, ранний callback теряется навсегда. Запишите его в устойчивый входящий журнал с ограниченным сроком хранения и повторите связывание после появления исходящего. Другая причина потери — преобразование большого числового идентификатора с потерей точности; сравните его представление на каждой границе сериализации и хранения.
Проверьте фактические event_types зарегистрированного аккаунта и маршрут до обработчика. Одного успешного запроса настройки мало: приложение могло позже зарегистрировать другой фильтр или отправлять события в иную среду. Не публикуйте секретный токен при сборе этой диагностики; хватит обезличенного аккаунта, перечня событий и времени изменения.
Повторные и запоздалые уведомления обрабатывайте без отката интерфейса. Если seen уже сохранён, поздний delivered не должен визуально вернуть сообщение к более ранней стадии. Хранение исходных наблюдений отдельно от вычисленного статуса позволяет объяснить такую последовательность. Ошибку отправки и отсутствие подтверждения не сводите к одному полю false.
Проверка проводится на управляемом получателе
- Отправить синтетический текст и сохранить внешний идентификатор.
- Дождаться доставки, затем открыть разговор на тестовом устройстве.
- Сопоставить события с исходящим и обновлением панели.
- Повторить callback и изменить порядок тестовых уведомлений.
- Подать уведомление до появления локальной записи и проверить последующее связывание.
Наблюдайте и сервер, и интерфейс: запись seen в базе ещё не гарантирует обновление открытой панели менеджера. Сверьте API чтения статуса, кеш и механизм обновления страницы. Если сервер хранит правильный результат, повторная настройка webhook не устранит устаревший экран.
Для уже потерянных статусов не заполняйте историю значением «прочитано» по догадке. Сначала выясните доступные способы восстановления у вашего продукта и провайдера. Там, где подтверждение получить нельзя, сохраните честное состояние «нет данных». В отчёт диагностики включите путь одного message_token, времена события и приёма, применённый фильтр и результат отображения.