Skip to content

What are the statuses of messages in WhatsApp?#

In our API, as in WhatsApp, statuses such as sent, delivered and read was implemented

To receive notifications about the outgoing message statuses from our API, it is necessary to activate the outgoingWebhook setting using the SetSettings method, or enable the Receive webhooks on sent messages statuses parameter in your profile.

Message statuses when sent from an account connected to the API#

  1. Sent: Your message has been successfully dispatched to the WhatsApp server. However, it has not yet been delivered to the recipient's device. In this scenario:

    • On the sender's device, the message will only show a single gray checkmark (✓)
    • The API generates a notification with the message status sent
      sent

    For a comprehensive understanding of why messages might remain in the sent status, we recommend referring to the article Why is the message status "sent"?

  2. Delivered: Your message has been successfully delivered to the recipient's device. Nevertheless, the recipient has not yet perused the message. In this instance:

    • On the sender's device, the message will display with two gray checkmarks (✓✓)
    • The API generates a notification with the message status delivered
      delivered

    Important

    If the recipient has an open chat at the time of receiving the message, the Delivered status will be absent. The message status will change from Sent to Read, in other words, notifications will be sent only for the sending and reading of the message, while a delivery notification will not be received.

  3. Read: The recipient has read your message. In this case:

    • On the sender's device, the message will display with two blue checkmarks (✓✓)
    • The API generates a notification with the message status read
      read

    Read receipts

    • If the recipient has disabled the "Read receipts" function on their device:

      1. The sender will not be able to view blue checkmarks
      2. The API will not generate an incoming notification indicating the read status

    • If the sender has disabled the "Read receipts" function on their device:

      1. The sender will not be able to view blue checkmarks
      2. The API will generate an incoming notification indicating the read status

    read-off

Message statuses when sent to an account connected to the API#

To ensure the sender receives real-time statuses when sending messages to an account connected to the API, the following settings need to be enabled:

  1. keepOnlineStatus - to set the device status to online and send the status delivered
  2. markIncomingMessagesReaded - to mark incoming messages as read

    Ignored if markIncomingMessagesReadedOnReply is set to yes

  3. markIncomingMessagesReadedOnReply - to mark incoming messages as read when sending a message to the chat via the API

These settings can be adjusted in the personal account or through the method SetSettings. The method readChat should be used to manually mark incoming messages as read.