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

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

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

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

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

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

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

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

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

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

    Важно

    Если у получателя открыт чат в момент получения сообщения, статус Delivered будет отсутствовать. Статус сообщения изменится с Sent на Read, иными словами уведомления будут отправлены только об отправке и прочтении сообщения, в то время как уведомление о доставке не будет получено.

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

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

    Отчеты о прочтении

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

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

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

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

    read-off

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

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

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

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

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

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