Перейти к содержанию

Какие бывают статусы сообщений в WhatsApp?#

В нашем API как и в WhatsApp реализованы статусы sent, delivered и read.

Для получения уведомлений о статусах отправленных сообщений из нашего API необходимо включить настройку outgoingWebhook с помощью метода SetSettings или включить параметр Получать уведомления о статусах отправленных сообщений в личном кабинете

Статусы сообщения при отправке с аккаунта, который подключен к API#

1. Sent (Отправлено)#

Ваше сообщение было успешно отправлено на сервер WhatsApp. Однако, оно еще не доставлено на устройство получателя.
В этом случае:

  • На устройстве отправителя сообщение будет с одной серой галочкой (✓)
  • API формирует уведомление со статусом сообщения sent
    sent

Для получения подробной информации о том, почему сообщения могут быть в статусе sent, рекомендуем ознакомится со статьёй Почему статус сообщения в значении "sent"?

2. Delivered (Доставлено)#

Ваше сообщение было успешно доставлено на устройство получателя. Но получатель еще не прочитал сообщение.
В этом случае:

  • На устройстве отправителя сообщение будет с двумя серыми галочками (✓✓)
  • API формирует уведомление со статусом сообщения delivered
    delivered
Почему отсутствует статус Delivered?

Если у получателя открыт чат в момент получения сообщения:

  • Статус Delivered будет отсутствовать
  • Статус сообщения изменится с Sent сразу на Read

3. Read (Прочитано)#

Ваше сообщение было прочитано получателем.
В этом случае:

  • На устройстве отправителя сообщение будет с двумя синими галочками (✓✓)
  • API формирует уведомление со статусом сообщения read
    read
Почему отсутствует статус Read?
  1. Если у получателя не сохранён номер отправителя и ранее не было переписки:

    • Отправитель не сможет увидеть синие галочки в первом сообщении
    • API не формирует входящее уведомление со статусом read для первого сообщения

    read-off

    • Статус delivered для первого сообщения сохраняется даже после сохранения номера отправителя или получении ответа (последующие сообщения меняют статус корректно)

    read-off

  2. Выключена функция "Отчеты о прочтении"

    • Если у получателя на устройстве выключена функция "Отчеты о прочтении":

      • Отправитель не сможет увидеть синие галочки
      • API не формирует входящее уведомление со статусом read
    • Если у отправителя на устройстве выключена функция "Отчеты о прочтении":

      • Отправитель не сможет увидеть синие галочки
      • API формирует входящее уведомление со статусом read.

read-off

Статусы сообщения при отправке на аккаунт, который подключен к API#

Чтобы отправитель получал актуальные статусы при отправке сообщения на аккаунт, который подключен к API, требуется включать настройки:

  1. keepOnlineStatus - чтобы выставлять статус устройства в сети и отправлять статус delivered
  2. markIncomingMessagesReaded - чтобы отмечать входящие сообщения прочитанными

    Игнорируется, если markIncomingMessagesReadedOnReply в значении yes

  3. markIncomingMessagesReadedOnReply - чтобы отмечать входящие сообщения прочитанными при отправке сообщения через API

Настройки изменяются в личном кабинете или с помощью метода SetSettings.
Требуется использовать метод readChat, чтобы вручную отмечать входящие сообщения прочитанными