Connect WhatsApp Manually with Cloud API
Connect an existing Meta app, WABA and business number to Wemblo using verified IDs, a system-user token and webhook.
Overview
Search Aliases: manual WABA setup, WhatsApp API IDs, connect Meta app, Cloud API token
WHEN TO USE MANUAL SETUP
Use Manual Cloud API when the business already controls the Meta developer app and WhatsApp assets, needs direct technical control or cannot use the guided authorization flow.
REQUIRED VALUES
Business Portfolio ID: Identifies the Meta business.
App ID: Identifies the Meta developer app.
WABA ID: Identifies the WhatsApp Business Account.
Phone Number ID: Identifies the registered API phone number.
Registered Number: Customer-facing business phone number.
System-User Access Token: Protected server-to-server credential.
Callback URL: Wemblo endpoint receiving Meta events.
Verify Token: Setup value used during webhook verification.
PROVIDER-SIDE STEPS
- Open https://developers.facebook.com/.
- Open the correct Meta app.
- Add or open the WhatsApp product.
- Open WhatsApp -> API Setup or the current Cloud API setup area.
- Confirm the selected WABA.
- Confirm the registered business phone number.
- Copy the WABA ID.
- Copy the Phone Number ID.
- Copy the App ID from the app dashboard.
- Open Meta Business Settings and copy the Business Portfolio ID from Business Info.
- Create or select a system user.
- Assign the app and WhatsApp assets.
- Generate a suitable access token with the required permissions.
WEMBLO-SIDE STEPS
- Open Wemblo -> Integrations -> WhatsApp.
- Choose Manual Setup.
- Enter the Business Portfolio ID.
- Enter the App ID.
- Enter the WABA ID.
- Enter the Phone Number ID.
- Enter the registered number in international format.
- Paste the system-user token into the protected field.
- Save.
- Copy the Wemblo callback URL and verify token.
- Configure the Meta webhook.
- Run inbound and outbound tests.
COMMON MAPPING ERRORS
WABA ID entered as Phone Number ID: Messages will fail or use the wrong resource.
Verify token entered as access token: API authorization will fail.
Temporary developer token used in production: Connection will stop when the token expires.
App from a different Business Portfolio: Permission or asset errors occur.
Whitespace copied with a token: Authorization may fail.
Official links
Cloud API: https://developers.facebook.com/docs/whatsapp/cloud-api/
Webhooks: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/
Last reviewed: