Not Sent - Number Opted Out

The Not Sent - Number Opted Out status allows you to identify that the recipient has opted out of receiving messages, ensuring you do not resend messages to the recipient’s phone number that was being used to send the message.

Prerequisites

An active WhatsApp plan on Kaleyra platform.
An active WhatsApp for Business API plan that includes:
1. A WhatsApp business number.
2. An associated profile with the business number.
3. A WhatsApp verified and approved profile.
4. A WABA ID onboarded on Kaleyra WhatsApp API V2.
You must have the callback registered in the WhatsApp channel for the phone numbers.

Sample Webhook

The following is the sample webhook.

{
    "code":"WAV2400",
    "status": "not sent",
    "reason": "message delivery failed as the number belongs to the blocklist",
    "message_id": "wamid.XXXXXHE5NXXXXXXXXXXDAQ==",
    "extra_info": {
        "enable_url_tracking_body": false,
        "enable_url_tracking_button": false,
        "message_id": "wamid.HBgMOTE5NDAXXXXXX3MDFQIAERgSMEYxMEM1QjQ3QjXXXXXXQ2N0YA",
        "waba_id": "12XXXXX34512345",
        "ref": "campaign_2025_summer_sale",
        "ref1": "Trasaction_TX_1234",
        "ref2": "payment_pending"
    }
}