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

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

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

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

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

1. Sent#

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

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

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

2. Delivered#

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

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

Почему отсутствует статус Delivered

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

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

3. Read#

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

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

Почему отсутствует статус Read

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

    1. Отправитель не сможет увидеть синие галочки в первом сообщении
    2. API не формирует входящее уведомление со статусом read для первого сообщения
    3. Статус delivered для первого сообщения сохраняется даже после сохранения номера отправителя или получении ответа (последующие сообщения меняют статус корректно)

    read-off

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

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

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

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

    read-off

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

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

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

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

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

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