Overview

WhatsApp uses acknowledgment (ACK) statuses to indicate the delivery and read status of messages. Periskope displays these statuses using visual indicators to help you understand the current state of your messages.

Message Status Types

Message Failed

ack: -1
The message has failed to be sent. This indicates a delivery failure. What to do: Please retry sending the message or restart the phone connection.

Pending Send

ack: 0
The message is not sent yet. It’s queued and waiting to be sent to the WhatsApp server. What this means: The message is in your outbox and will be sent when the connection is available.

Sent to WhatsApp

ack: 1
Message is pending - sent to WhatsApp server, awaiting acknowledgment or delivery confirmation. What this means:
  • The message has been sent to WhatsApp servers
  • For messages with delivery confirmation: awaiting delivery confirmation
  • For messages without delivery confirmation: sent to WhatsApp but no delivery confirmation received

Delivered (Individual Chat)

ack: 2
Message was sent to WhatsApp servers and delivered to the recipient’s device. What this means: The message has been delivered to the chat. For detailed delivery status by participant, check the message info.

Delivered (Group Chat)

ack: 3
Message was sent to everyone in the group. What this means: All group participants have received the message on their devices.

Read by All

ack: 4+
Message was read by everyone (blue double tick). What this means: The message has been read by all participants of the chat.

Troubleshooting

Message Stuck at Status 0 or 1

  • Check your phone connection
  • Try restarting your phone on Periskope
  • Ensure that WhatsApp on your phone is updated to the latest version

Message Failed (Status -1)

  • Ensure that WhatsApp on your phone is updated to the latest version
  • Verify the recipient’s phone number is correct
  • Check if the recipient has blocked your number
  • Try restarting your phone on Periskope

Read Receipts Not Showing

  • Read receipts depend on the recipient’s privacy settings
  • Some recipients may have read receipts disabled
  • In group chats, at least one member needs to have read the message for status to update

API Integration

When integrating with Periskope’s API, these status codes are returned as integers in the message object’s ack field. You can use these values to build custom notification systems or delivery tracking in your applications.