Webhooks can be leveraged to track the delivery status of authentication requests initiated via WhatsApp.

Status Descriptions

The following statuses are delivered through webhooks for WhatsApp authentication:

• SENT: Indicates the message containing the authentication request has been sent to the recipient’s WhatsApp number.
• DELIVERED: Confirms that the message has been successfully delivered to the recipient’s device.
• READ: Indicates the recipient has read the message.
• FAILED: Signifies that the message delivery has encountered an issue.

Sequence of Statuses

Ideally, the sequence of status updates follows the order: SENT -> DELIVERED -> READ. However, variations might occur depending on the recipient’s WhatsApp settings (e.g., read receipts disabled). If a later status is received, it implies all preceding statuses have been fulfilled.

Important Notes

• Webhooks for delivery status updates are not mandatory.
• The availability of status updates depends on the recipient’s WhatsApp settings.
• There might be instances where webhooks are missed due to technical issues on either side (client or server). The system implements retries to mitigate this.

Example Payloads

Here are JSON examples illustrating each status update for WhatsApp delivery:

The CLICKED event for WhatsApp indicates that the recipient has clicked on the authentication link sent via WhatsApp.

Example Payload

{
  "data": {
    "requestId": "unique_request_id",
    "status": "CLICKED",
    "channel": "WHATSAPP"
  },
  "eventType": "DLR",
  "timestamp": 1734615829169
}

The AUTH event is triggered upon successful authentication using a phone number.

Example Payload

{
  "data": {
    "requestId": "unique_request_id",
    "status": "SUCCESS",
    "authenticationDetails": {
      "phone": {
        "channel": [
          "WHATSAPP/SMS/VIBER"
        ],
        "phoneNumber": "USER_NUMBER",
        "countryCode": "COUNTRY_CODE"
      },
      "email": {}
    }
  },
  "eventType": "AUTH",
  "timestamp": 1734513827
}