API Credentials

Found in your Meta App Dashboard under WhatsApp > API Setup.
Found in your Meta App Dashboard under WhatsApp > API Setup.
Generate a System User Token with `whatsapp_business_messaging` and `whatsapp_business_management` permissions.
Use this exact string when setting up the webhook callback in the Meta Developer Console.
✓ Active from Database

Meta Webhook Setup

To receive incoming messages and double-tick status updates, configure these values in your Meta App Developer Dashboard:

  1. Go to WhatsApp > Configuration.
  2. Click Edit in the Webhooks section.
  3. Set Callback URL to:
    https://wp.geoproof.in/api/webhook
  4. Set Verify Token to:
    whatsapp_secret_verify_token_123
  5. Click Verify and Save.
  6. Click Manage next to Webhook Fields, and subscribe to messages events.

Local Webhook Simulator

Simulate events locally without needing a public domain (ngrok/expose) or setting up HTTPS.

Recent Webhook Logs

ID: #1195 Jul 02, 06:31:06
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "profile": {
                                    "name": "Mobtel DIGITAL"
                                },
                                "wa_id": "917039748580",
                                "user_id": "IN.1555159969325711"
                            }
                        ],
                        "messages": [
                            {
                                "context": {
                                    "forwarded": true
                                },
                                "from": "917039748580",
                                "from_user_id": "IN.1555159969325711",
                                "id": "wamid.HBgMOTE3MDM5NzQ4NTgwFQIAEhggQTVFOUNGQjFCMTQ1QzU5RTcxQjcwMDkxRUQ3QjM4MzcA",
                                "timestamp": "1782973861",
                                "type": "document",
                                "document": {
                                    "filename": "Commercials for Whatsapp. Business API Services..pdf",
                                    "mime_type": "application\/pdf",
                                    "sha256": "aAnhaG9q89yyqWWfDiZvtXCxFSxJivrqS2MkjQMRM9s=",
                                    "id": "2226711654793978",
                                    "url": "https:\/\/lookaside.fbsbx.com\/whatsapp_business\/attachments\/?mid=2226711654793978&source=webhook&ext=1782974164&hash=ATzd6QdzYRXj61NjauRx5MEArEjp94f-BEZZ4GeLYPXVzQ"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1193 Jul 01, 15:56:38
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "wa_id": "917075922256",
                                "user_id": "IN.986930020890022"
                            }
                        ],
                        "statuses": [
                            {
                                "id": "wamid.HBgMOTE3MDc1OTIyMjU2FQIAERgSOUMyNDE2ODQxMjFDQTVEMDYyAA==",
                                "status": "read",
                                "timestamp": "1782921395",
                                "recipient_id": "917075922256",
                                "recipient_user_id": "IN.986930020890022",
                                "pricing": {
                                    "billable": true,
                                    "pricing_model": "PMP",
                                    "category": "marketing",
                                    "type": "regular"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1194 Jul 01, 15:56:38
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "wa_id": "917075922256",
                                "user_id": "IN.986930020890022"
                            }
                        ],
                        "statuses": [
                            {
                                "id": "wamid.HBgMOTE3MDc1OTIyMjU2FQIAERgSODdBODFCRDYxOEZBQ0YwMjFGAA==",
                                "status": "read",
                                "timestamp": "1782921395",
                                "recipient_id": "917075922256",
                                "recipient_user_id": "IN.986930020890022",
                                "pricing": {
                                    "billable": true,
                                    "pricing_model": "PMP",
                                    "category": "marketing",
                                    "type": "regular"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1192 Jun 27, 17:35:33
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "profile": {
                                    "name": "Pooja Devi"
                                },
                                "wa_id": "918700737208",
                                "user_id": "IN.1196653113525706"
                            }
                        ],
                        "messages": [
                            {
                                "from": "918700737208",
                                "from_user_id": "IN.1196653113525706",
                                "id": "wamid.HBgMOTE4NzAwNzM3MjA4FQIAEhggQUNBOEE3MDgxOTRCMEYwMDkxOTJENTgwMkU3Qzk1NTEA",
                                "timestamp": "1782581731",
                                "text": {
                                    "body": "Lul"
                                },
                                "type": "text"
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1191 Jun 27, 09:32:09
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "wa_id": "918700737258",
                                "user_id": "IN.1198163436708007"
                            }
                        ],
                        "statuses": [
                            {
                                "id": "wamid.HBgMOTE4NzAwNzM3MjU4FQIAERgSNzAxNDVENjM1NDUxRDdCMkFDAA==",
                                "status": "read",
                                "timestamp": "1782552728",
                                "recipient_id": "918700737258",
                                "recipient_user_id": "IN.1198163436708007",
                                "pricing": {
                                    "billable": true,
                                    "pricing_model": "PMP",
                                    "category": "marketing",
                                    "type": "regular"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1189 Jun 27, 09:07:35
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "wa_id": "919311734258",
                                "user_id": "IN.1191148850742799"
                            }
                        ],
                        "statuses": [
                            {
                                "id": "wamid.HBgMOTE5MzExNzM0MjU4FQIAERgSNUI0NkMzODE1RjAwMzVDMzg1AA==",
                                "status": "sent",
                                "timestamp": "1782551254",
                                "recipient_id": "919311734258",
                                "recipient_user_id": "IN.1191148850742799",
                                "pricing": {
                                    "billable": false,
                                    "pricing_model": "PMP",
                                    "category": "service",
                                    "type": "free_customer_service"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1190 Jun 27, 09:07:35
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "wa_id": "919311734258",
                                "user_id": "IN.1191148850742799"
                            }
                        ],
                        "statuses": [
                            {
                                "id": "wamid.HBgMOTE5MzExNzM0MjU4FQIAERgSNUI0NkMzODE1RjAwMzVDMzg1AA==",
                                "status": "read",
                                "timestamp": "1782551254",
                                "recipient_id": "919311734258",
                                "recipient_user_id": "IN.1191148850742799",
                                "pricing": {
                                    "billable": false,
                                    "pricing_model": "PMP",
                                    "category": "service",
                                    "type": "free_customer_service"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1188 Jun 27, 09:07:21
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "profile": {
                                    "name": "Rahul Kumar"
                                },
                                "wa_id": "919311734258",
                                "user_id": "IN.1191148850742799"
                            }
                        ],
                        "messages": [
                            {
                                "from": "919311734258",
                                "from_user_id": "IN.1191148850742799",
                                "id": "wamid.HBgMOTE5MzExNzM0MjU4FQIAEhggQUNEOTZFOTNGMzVBMEFERTBGMjdDNDE1NEYxQTIzQUYA",
                                "timestamp": "1782551239",
                                "text": {
                                    "body": "Hod"
                                },
                                "type": "text"
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1187 Jun 27, 09:06:11
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "wa_id": "919311734258",
                                "user_id": "IN.1191148850742799"
                            }
                        ],
                        "statuses": [
                            {
                                "id": "wamid.HBgMOTE5MzExNzM0MjU4FQIAERgSQjE5RDk4NkRGRjMxREM5NENEAA==",
                                "status": "read",
                                "timestamp": "1782551170",
                                "recipient_id": "919311734258",
                                "recipient_user_id": "IN.1191148850742799",
                                "pricing": {
                                    "billable": true,
                                    "pricing_model": "PMP",
                                    "category": "marketing",
                                    "type": "regular"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1186 Jun 27, 09:05:46
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "wa_id": "919311734258",
                                "user_id": "IN.1191148850742799"
                            }
                        ],
                        "statuses": [
                            {
                                "id": "wamid.HBgMOTE5MzExNzM0MjU4FQIAERgSQjE5RDk4NkRGRjMxREM5NENEAA==",
                                "status": "delivered",
                                "timestamp": "1782551144",
                                "recipient_id": "919311734258",
                                "recipient_user_id": "IN.1191148850742799",
                                "pricing": {
                                    "billable": true,
                                    "pricing_model": "PMP",
                                    "category": "marketing",
                                    "type": "regular"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}