How to set webhook to receive incoming messages

🔔
Updated Webhook Guide · 2026

Configure WhatsApp Cloud API Webhooks
for WinSender

Follow this updated step-by-step guide to connect Meta WhatsApp Cloud API webhooks to WinSender, so incoming messages and message status updates can be received correctly.

✅ Official Meta Cloud API
✅ Receive incoming messages
✅ Subscribe to message events

What are WhatsApp Cloud API webhooks?

WhatsApp Cloud API webhooks allow Meta to notify your application when specific events happen on your WhatsApp Business Account, such as receiving an incoming message, receiving delivery/read status updates, or getting template-related updates.

In WinSender, the webhook is used to receive incoming WhatsApp messages and keep message activity synchronized with the software.

Before you start

📱
WhatsApp Cloud API configured
Your Meta app and WhatsApp Business Account should already be created.
🔑
Admin access
You need access to the Meta app dashboard and Business Settings.
🌐
Public HTTPS callback URL
Meta must be able to reach and verify the webhook endpoint.

Webhook configuration steps

The current Meta interface may show this area as WhatsApp → Configuration or Quickstart → Configuration, depending on your dashboard layout.

Quick index

1. Open your Meta app dashboard
2. Go to WhatsApp → Configuration
3. Edit the callback URL
4. Verify and save
5. Manage webhook fields
6. Subscribe to messages
7. Final check

1

Open your Meta app dashboard

Go to Meta for Developers → My Apps and open the app connected to your WhatsApp Cloud API setup.

2

Go to WhatsApp → Configuration

In the left menu, open WhatsApp and then click Configuration. In some dashboards, you may see this as Quickstart → Configuration.

Look for the Webhook box. This area usually shows the Callback URL, the Verify token, and the Webhook fields section with an Edit or Manage button.

3

Edit the webhook callback URL

Click Edit in the Webhook section. A modal window named similar to Edit webhook’s callback URL will open.

Enter the following WinSender values:

Callback URL:
https://www.winsender.net/meta-wa-api/index.php

Verify token:
winsender

4

Click Verify and save

Click Verify and save. Meta will send a verification request to the Callback URL. If the endpoint responds correctly and the token matches, the webhook will be saved.

Troubleshooting: If verification fails, check that the URL is copied exactly, the endpoint is reachable over HTTPS, the Verify token is exactly winsender, and there are no extra spaces before or after the token.

5

Manage webhook fields

After the callback URL has been saved, go back to the Webhook section and click Manage next to Webhook fields.

A list of available webhook fields will appear. Find the messages field.

6

Subscribe to the messages field

Click Subscribe next to messages. This is the most important subscription for WinSender because it allows the software to receive incoming WhatsApp message events.

After subscribing, the button should change to Unsubscribe, or Meta may display a confirmation message such as Successfully subscribed to messages.

Recommended: If you also want to monitor delivery/read status changes, make sure the webhook is configured to receive message status events as supported by your current Meta app configuration.

7

Final check

Return to WhatsApp → Configuration and check that:

  • The Callback URL is saved.
  • The Verify token is saved or masked.
  • The messages webhook field is subscribed.
  • WinSender is using the correct Access Token, Phone Number ID, Business Account ID, and phone number.

✅ Your webhook is now configured to receive incoming WhatsApp Cloud API events in WinSender.

Common problems and fixes

Meta says the callback URL could not be verified

Check that the Callback URL is public, uses HTTPS, is copied exactly, and that the Verify token is exactly the same as the one expected by the endpoint.

Incoming messages are not appearing in WinSender

Make sure the messages webhook field is subscribed. Saving the Callback URL alone is not enough; you must also subscribe to the relevant webhook field.

The dashboard layout looks different

Meta frequently updates the dashboard interface. If you cannot find the exact same screen, look for WhatsApp, Configuration, Webhook, Edit, and Manage webhook fields.

Can I use another callback URL?

Use the WinSender callback URL provided in this guide unless your WinSender installation or support team gives you a different endpoint.

Need help configuring webhooks?

If webhook verification fails or incoming messages are not received correctly, contact WinSender support and include a screenshot of your WhatsApp → Configuration page.

Contact Support

Leave a Reply

Your email address will not be published. Required fields are marked *