Отметки о прочтении — это галочки рядом с отправленным сообщением. По ним видно, ушло ли сообщение, дошло ли до получателя и прочитал ли он его. В приложении отметки можно отключить в настройках конфиденциальности. А компания, которая работает через API, получает те же статусы автоматически и может сама отмечать сообщения клиентов прочитанными.
Содержание
Что значат галочки в WhatsApp
Рядом с каждым отправленным сообщением WhatsApp ставит значок. По справке WhatsApp они означают вот что:
| Значок | Что произошло |
| Часы | Сообщение ещё не отправлено, обычно из-за проблем со связью |
| Одна серая галочка | Сообщение отправлено |
| Две серые галочки | Сообщение доставлено на телефон получателя или его связанное устройство |
| Две синие галочки | Получатель прочитал сообщение |
В групповом чате вторая галочка появляется, когда сообщение получили все участники, а синими галочки становятся, когда его прочитали все. Голосовое сообщение помечается синим микрофоном, когда его прослушали. Если вы отредактируете сообщение, отметки сбросятся, и вы увидите, кто прочитал новую версию.
Узнать точное время доставки и прочтения можно в информации о сообщении. Нажмите на своё сообщение и подержите его, затем нажмите на значок «i». На некоторых телефонах этот пункт спрятан в меню с тремя точками. Там видно, когда сообщение доставили, прочитали или, если это голосовое, прослушали.
Почему не появляются синие галочки
Если сообщение давно доставлено, а галочки остаются серыми, причин может быть несколько:
- вы или получатель отключили отчёты о прочтении;
- получатель вас заблокировал;
- получатель ещё не открывал чат;
- у вас или у получателя проблемы со связью;
- на телефоне у вас или у получателя неверно выставлены дата и время.
Кроме того, когда человек получает от вас сообщение впервые, отметка о прочтении может не прийти.
Как отключить отметки о прочтении
Если не хотите, чтобы собеседники видели, что вы прочитали их сообщения, отметки можно отключить. Откройте настройки WhatsApp, перейдите в раздел «Конфиденциальность» и выключите «Отчёты о прочтении». Чтобы снова включить их, верните переключатель.
У этой настройки есть обратная сторона: вы тоже перестанете видеть, читают ли ваши сообщения другие. Кроме того, вы можете не увидеть, кто смотрел ваш статус, а другие — не увидеть, что вы смотрели их статусы. В групповых чатах и для голосовых сообщений отметки отключить нельзя: они работают всегда.
Как работать с отметками о прочтении через API
Когда компания общается с клиентами через WhatsApp API, ей тоже важно знать, дошло ли сообщение и прочитал ли его клиент. Например, чтобы показать оператору в CRM, что клиент уже видел счёт, или чтобы заметить, что сообщение не доставлено. В шлюзе WhatsApp API от GREEN-API отметки о прочтении приходят как статусы сообщений, и с ними можно работать в обе стороны.
Как узнать, что клиент прочитал ваше сообщение
Статусы отправленных сообщений приходят на ваш сервер вебхуком outgoingMessageStatus. Чтобы их получать, включите в консоли GREEN-API настройку «Получать уведомления о статусах отправленных сообщений» или передайте outgoingWebhook со значением yes в методе SetSettings. Настройки применяются в течение 5 минут.
Каждое уведомление содержит номер сообщения (idMessage), чат и статус. Основные статусы такие:
| Статус | Что значит |
| sent | Сообщение отправлено |
| delivered | Сообщение доставлено получателю |
| read | Сообщение прочитано, просмотрено или прослушано |
| failed | При отправке произошла ошибка, её описание — в поле description |
| noAccount | У номера получателя нет аккаунта WhatsApp |
Статусы failed и noAccount приходят всегда, даже если уведомления о статусах выключены. Полный список, включая статусы для групп и временных ограничений, есть в документации.
Так выглядит уведомление о том, что клиент прочитал сообщение:
{
"typeWebhook": "outgoingMessageStatus",
"chatId": "79876543210@c.us",
"timestamp": 1727691478,
"idMessage": "3EB0608D6A2901063D63",
"status": "read",
"sendByApi": true
}
По idMessage ваш сервер находит отправленное сообщение и обновляет его статус. Если нужно проверить конкретное сообщение без вебхука, вызовите метод GetMessage: в ответе есть поле statusMessage с тем же статусом.
Учтите, что API подчиняется тем же правилам, что и приложение. Если клиент отключил отчёты о прочтении, статус read не придёт и сообщение останется доставленным. В группе статус read означает, что сообщение прочитали все участники.
Как отметить сообщения клиента прочитанными
Клиент тоже видит галочки. Если сообщения приходят в вашу CRM, а не на телефон, решите, когда клиент увидит синие галочки. Есть три варианта.
Первый — отмечать все входящие сообщения прочитанными сразу. Для этого в SetSettings передайте markIncomingMessagesReaded со значением yes. Это просто, но клиент увидит синие галочки, даже если оператор ещё не открыл чат.
Второй — отмечать сообщения прочитанными, когда вы отвечаете клиенту через API. Для этого передайте markIncomingMessagesReadedOnReply со значением yes. Тогда синие галочки появятся вместе с ответом.
Третий — отмечать чат прочитанным в тот момент, когда оператор его открыл. Для этого вызовите метод ReadChat:
curl -X POST "{{apiUrl}}/waInstance{{idInstance}}/readChat/{{apiTokenInstance}}" \
-H "Content-Type: application/json" \
-d '{"chatId": "79876543210@c.us"}'
Без idMessage метод отмечает прочитанными все непрочитанные сообщения чата, а с idMessage — сообщения до указанного включительно. В ответ приходит setRead: true. Метод работает, только если включены уведомления о входящих сообщениях. Сообщения, полученные до включения этой настройки, останутся непрочитанными.
Как узнать, что сообщение прочитали на телефоне
Иногда сотрудник отвечает клиенту не только из CRM, но и с телефона, к которому привязан номер. Чтобы CRM знала, что сообщение уже прочитали на телефоне, выключите автоматическое прочтение (markIncomingMessagesReaded со значением no) и включите уведомления о статусах входящих сообщений. Тогда, когда сообщение прочитают на телефоне, придёт вебхук incomingMessageStatus со статусом read. Подробнее — в FAQ GREEN-API.
Попробовать работу со статусами можно на своём номере: подключите его на тарифе «Разработчик».
Частые вопросы об отметках о прочтении
Можно ли прочитать сообщение так, чтобы собеседник не увидел синих галочек?
Да, если отключить отчёты о прочтении в настройках конфиденциальности. Но тогда вы тоже не увидите, читают ли ваши сообщения другие. В групповых чатах это не работает: там отметки видны всегда.
Почему через API не приходит статус read?
Чаще всего клиент отключил отчёты о прочтении — тогда сообщение навсегда останется доставленным. Ещё проверьте, включены ли уведомления о статусах отправленных сообщений и прошло ли 5 минут после изменения настроек. В группах статус read приходит, только когда сообщение прочитали все участники.
Видит ли клиент, что сообщение отметили прочитанным через API?
Да. Когда вы отмечаете сообщение прочитанным методом ReadChat или настройкой инстанса, клиент видит синие галочки, как если бы вы прочитали сообщение в приложении. Исключение — если на вашем номере или у клиента отключены отчёты о прочтении: тогда галочки останутся серыми.