Campaigns and messages in campaigns can go through a series of states as the campaign goes on. These states represent the current status of the campaign to give you better insight.

​
What are the states that a campaign can go through?

  • In progress state:
    • Queued - This state indicates the campaign has been queued for send; it will begin sending shortly.
    • Sending - This state indicates the campaign has begun sending messages. The campaign will stay in this state for up to 3 days, depending on the size of the campaign (and whether issues are experienced, as explained further down)
  • Success state:
    • Completed - The campaign was sent; this state indicates that at least one of the messages sent was successfully delivered.
  • Failure state:
    • Failed - None of the messages for the campaign were successfully delivered.

​
What are the states that each message can go through within a campaign?

  • In progress states:
    • Sending - The message is currently being sent. This does not indicate success.
    • Queued - The message is queued for sending. It can stay in this state for some hours as the system progresses through the queue.
    • Retrying - An error was encountered when attempting to send a message. We will retry up to 3 times, at which point we will mark it as failed.
      • We retry quickly whenever we see a transient error from WhatsApp, indicating an issue with WhatsApp.
      • We retry in 12 hours if we see issues with WhatsApp messaging limits.
  • Success states:
    • Sent - The message was sent to the contact, but we have not been told if it has arrived on their device or not.
    • Delivered - The message was delivered to the contact, and it has arrived on their device.
    • Read - The contact has read the message (Note: if the user has disabled Read Receipts on WhatsApp, we will never get this state).
    • Responded - The contact has replied to the campaign message.
  • Failure states:
    • Failed (generic) -> Something has gone wrong, and we’re not sure exactly what. We retry up to 3 times to attempt to avoid this.
    • Invalid contact -> The contact was not a valid WhatsApp user.
    • Blocked or spam - The contact has either blocked or reported you as spam, or you have reached your WhatsApp messaging limits.