Skip to main content

​
Prerequisites

  • A Meta Business account
  • A WhatsApp Business API account
  • A running Suji instance

​
Set Up WhatsApp Business API

1

Create a Meta Business account

Go to business.facebook.com and create a business account if you don’t have one.
2

Set up a WhatsApp Business app

Go to developers.facebook.com, create a new app, and select Business as the app type. Add the WhatsApp product.
3

Get API access

In the WhatsApp section of your app, you’ll find:
  • A test phone number for development
  • An access token for API calls
For production, you’ll need to register your own phone number and complete Meta’s business verification.
WhatsApp Business API requires Meta’s approval for production use. During development, you can use the test phone number to send messages to up to 5 verified recipients.

​
Connect to Suji

1

Go to your instance

Open your instance in the Suji dashboard and click the Connectors tab.
2

Add WhatsApp connector

Click Add Connector and select WhatsApp.
3

Enable the connector

Toggle the WhatsApp connector to enabled.
4

Save

Click Save. The WhatsApp connector will be configured on your instance.

​
Configure Webhooks

WhatsApp requires a webhook URL to receive incoming messages. Your Suji instance provides this automatically at: 
https://your-subdomain.suji.fr/webhook/whatsapp
In the Meta Developer Portal, set this URL as your webhook callback URL and configure the necessary webhook subscriptions (messages, message_deliveries).

​
Troubleshooting

  • Verify the webhook URL is correctly configured in the Meta Developer Portal
  • Check that webhook subscriptions are active for messages
  • Ensure the instance is in the Running state
  • Verify your access token is valid and not expired
  • Check that the recipient’s phone number is in the correct format (with country code)
  • For test numbers, verify the recipient is in your allowed test contacts
  • Production WhatsApp access requires Meta business verification
  • This process can take several days — use the test phone number while waiting