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: #1201 Aug 26, 13:38:27
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "wa_id": "919136383880",
                                "user_id": "IN.1282683830523656"
                            }
                        ],
                        "messages": [
                            {
                                "from": "919136383880",
                                "from_user_id": "IN.1282683830523656",
                                "id": "wamid.HBgMOTE5MTM2MzgzODgwFQIAEhgSNTQ0RjIxMzU2NzQzQTBCOTk5AA==",
                                "timestamp": "1787751504",
                                "errors": [
                                    {
                                        "code": 131051,
                                        "title": "Message type unknown",
                                        "message": "Message type unknown",
                                        "error_data": {
                                            "details": "Message type is currently not supported."
                                        }
                                    }
                                ],
                                "type": "unsupported",
                                "unsupported": {
                                    "type": "unknown",
                                    "raw_type": "unknown"
                                }
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1200 Aug 26, 00:56:03
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "profile": {
                                    "name": "Pravinkumar Yadav"
                                },
                                "wa_id": "917507856848",
                                "user_id": "IN.1393224042138424"
                            }
                        ],
                        "messages": [
                            {
                                "from": "917507856848",
                                "from_user_id": "IN.1393224042138424",
                                "id": "wamid.HBgMOTE3NTA3ODU2ODQ4FQIAEhggQUM1RDRBRDc5NEZEM0YxQzk4ODg1QzVGMEZBOTEzMEEA",
                                "timestamp": "1787705761",
                                "text": {
                                    "body": "Good morning \nI am Pravinkumar Yadav from Aditya Engineering.\nI have 10 member team in field. I want to know plan details"
                                },
                                "type": "text"
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1199 Aug 26, 00:54:42
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "profile": {
                                    "name": "Pravinkumar Yadav"
                                },
                                "wa_id": "917507856848",
                                "user_id": "IN.1393224042138424"
                            }
                        ],
                        "messages": [
                            {
                                "from": "917507856848",
                                "from_user_id": "IN.1393224042138424",
                                "id": "wamid.HBgMOTE3NTA3ODU2ODQ4FQIAEhggQUNCNjcyMjQ2MDUzMjhCM0IxNzcxMTk2REU2QjAzNTYA",
                                "timestamp": "1787705679",
                                "text": {
                                    "body": "Hello GeoProof, I would like to know more about your services."
                                },
                                "type": "text"
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1198 Aug 13, 10:37:51
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "profile": {
                                    "name": "Thakurrrr"
                                },
                                "wa_id": "918011073306",
                                "user_id": "IN.1290689816381501"
                            }
                        ],
                        "messages": [
                            {
                                "from": "918011073306",
                                "from_user_id": "IN.1290689816381501",
                                "id": "wamid.HBgMOTE4MDExMDczMzA2FQIAEhgWM0VCMDBDRTg1MjFGMEY2QkEwRTRENQA=",
                                "timestamp": "1786617469",
                                "text": {
                                    "body": "we have a sales team of 30 nos"
                                },
                                "type": "text"
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1197 Aug 13, 10:37:29
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "profile": {
                                    "name": "Thakurrrr"
                                },
                                "wa_id": "918011073306",
                                "user_id": "IN.1290689816381501"
                            }
                        ],
                        "messages": [
                            {
                                "from": "918011073306",
                                "from_user_id": "IN.1290689816381501",
                                "id": "wamid.HBgMOTE4MDExMDczMzA2FQIAEhgWM0VCMDc4NEE5NDEzQkFEMDBFQzFCNgA=",
                                "timestamp": "1786617448",
                                "text": {
                                    "body": "Specially the price"
                                },
                                "type": "text"
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
ID: #1196 Aug 13, 10:37:05
{
    "object": "whatsapp_business_account",
    "entry": [
        {
            "id": "963997403298005",
            "changes": [
                {
                    "value": {
                        "messaging_product": "whatsapp",
                        "metadata": {
                            "display_phone_number": "918929721558",
                            "phone_number_id": "1220425137812129"
                        },
                        "contacts": [
                            {
                                "profile": {
                                    "name": "Thakurrrr"
                                },
                                "wa_id": "918011073306",
                                "user_id": "IN.1290689816381501"
                            }
                        ],
                        "messages": [
                            {
                                "from": "918011073306",
                                "from_user_id": "IN.1290689816381501",
                                "id": "wamid.HBgMOTE4MDExMDczMzA2FQIAEhgWM0VCMDY5MjdFQzBFOENGRUYxNDNENQA=",
                                "timestamp": "1786617421",
                                "text": {
                                    "body": "Hello GeoProof, I would like to know more about your services....."
                                },
                                "type": "text"
                            }
                        ]
                    },
                    "field": "messages"
                }
            ]
        }
    ]
}
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"
                }
            ]
        }
    ]
}