WhatsApp Integration

​

Overview

​

Prerequisites

• A Meta business portfolio with a WhatsApp Business phone number on Cloud API

​

Step 1: Create a Meta App

1. Go to developers.facebook.com/apps and click Create App
2. Enter an app name and contact email, then click Next
3. Select Connect with customers through WhatsApp and click Next
4. Select the business portfolio that owns your WhatsApp number, click Next, then click Create app

​

Step 2: Collect Credentials

1. In your app, open Use cases → Connect on WhatsApp → API Setup
2. Select any of your numbers in the From dropdown
3. Copy the WhatsApp Business account ID shown below it. One AiLunaPro configuration covers every number on the account.

1. Open Business settings → Users → System users and select a system user with Admin access (click Add to create one)
2. Click ⋯ → Assign assets, and give the system user full control of your app and your WhatsApp account
3. Click Generate token, select your app, set expiration to Never, and grant whatsapp_business_messaging and whatsapp_business_management
4. Copy the token — Meta shows it only once

1. In your app, open App settings → Basic
2. Click Show next to App secret and copy it

​

Step 3: Configure in AiLunaPro

1. Navigate to /telephony-configurations, click Add configuration, and select WhatsApp
2. Enter the Access Token, WhatsApp Business Account ID, and App Secret, then click Create. AiLunaPro checks them with Meta and subscribes your app to the account’s webhooks before saving.
3. Open the new configuration. Under Webhook for your Meta app, copy the Callback URL and the Verify token — you’ll paste both into Meta in Step 4
4. In Phone numbers, click Refresh numbers. AiLunaPro imports the numbers Meta lists on the account. The result names any number it had to skip, so check it before assigning workflows.
5. Edit each number that should take calls and set its Inbound workflow to the agent that should answer. A number with no workflow rejects calls.

​

Step 4: Configure the Webhook in Meta

1. In your app, open Use cases → Connect on WhatsApp → Configuration
2. Paste the Callback URL and Verify token from Step 3, then click Verify and save
3. In the Webhook fields list that appears, turn on Subscribe for calls

​

Step 5: Turn On Calling

1. Open WhatsApp Manager → Account tools → Phone numbers
2. Click the gear icon next to each number and open Call settings
3. Turn on Allow voice calls

curl -X POST "https://graph.facebook.com/v26.0/<PHONE_NUMBER_ID>/settings" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "calling": {
      "status": "ENABLED",
      "call_icon_visibility": "DEFAULT"
    }
  }'

​

Step 6: Test

​

Troubleshooting