Connect WhatsApp via the Cloud API (manual method)

📍 Where to find it: Inboxes → Add a channel → WhatsApp → WhatsApp Cloud

Link your WhatsApp Business number to Madyis Hub through Meta's official Cloud API by entering the credentials yourself. All your WhatsApp conversations then land in Conversations.

How it works

You create an app on Meta for Developers, add the WhatsApp product, verify your number and retrieve three pieces of information (the phone number ID, the WhatsApp Business account ID, and a permanent access token). You enter them into Madyis Hub. Finally, you paste the webhook URL and verify token provided by Madyis Hub into the Meta configuration and subscribe to the "messages" field: that is what brings incoming messages through. WhatsApp is a feature of the higher plans (Pro).

Step by step

1. Inboxes → "Add an inbox" → "WhatsApp" card → choose "WhatsApp Cloud".
2. Follow the guide at the top of the page: create a Meta app (type "Business") and add the WhatsApp product.
3. In Meta → WhatsApp → API Setup: verify your number, copy the "Phone number ID" and the "WhatsApp Business Account ID".
4. Create a permanent access token (Meta Business → Settings → System users, with WhatsApp permissions).
5. In Madyis Hub, fill in: inbox name, your number (format +44…), the phone number ID, the Business account ID and the token, then "Create".
6. Open the "Configuration" tab of the new inbox and copy the webhook URL and verify token.
7. In Meta → WhatsApp → Configuration → Webhooks: paste the URL and the token, then subscribe to the "messages" field.

Good to know

• Without subscribing to the "messages" field on the Meta side, incoming messages will never arrive: this is the most forgotten step.
• Follow the WhatsApp opt-in rules (consent) to avoid your number being banned by Meta.
• WhatsApp is reserved for the higher plans: otherwise a padlock is shown.