Skip to main content

​
Overview

Dograh AI answers voice calls that WhatsApp users place to your WhatsApp Business number. Only inbound calls are supported.

​
Prerequisites

  • A Meta business portfolio with a WhatsApp Business phone number on Cloud API
  • Dograh AI reachable from the internet over HTTPS
Follow the steps in order. Meta verifies the webhook against a saved Dograh configuration, and won’t turn on calling until a calls webhook exists.

​
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

Phone Number ID and WhatsApp Business account ID
  1. In your app, open Use cases → Connect on WhatsApp → API Setup
  2. Select your number in the From dropdown
  3. Copy the Phone number ID and the WhatsApp Business account ID shown below it
Access token
  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
App secret
  1. In your app, open App settings → Basic
  2. Click Show next to App secret and copy it

​
Step 3: Configure in Dograh AI

  1. Navigate to /telephony-configurations, click Add configuration, and select WhatsApp
  2. Enter the Access Token, Phone Number ID, and App Secret, then click Create. Dograh checks them with Meta 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 5
  4. Click Add phone number, enter your WhatsApp Business number with its country code (for example +15551234567), set the Inbound workflow to the agent that should answer, and click Add. Dograh checks the number against Meta before saving it.
On self-hosted Dograh, the Callback URL must be your backend’s public HTTPS URL. If the page shows a localhost address, expose your backend (for example with a tunnel) and use that hostname instead.

​
Step 4: Subscribe Your App to the WhatsApp Business Account

A successful call returns {"success": true}.

​
Step 5: 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 6: Turn On Calling

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

​
Step 7: Test

Call your business number from the WhatsApp app on a phone. Your Dograh AI agent answers.

​
Troubleshooting

Calling is off for the number. Complete Step 6.
The app has no calls webhook yet. Complete Step 5, then turn on calling.
Meta could not read the Phone Number ID with the access token. Check the Phone Number ID against the API Setup page, and that the token’s system user has full control of your WhatsApp account.
Save the Dograh configuration first, and make sure the Verify token in Meta matches the one on the configuration page exactly.
Dograh asks Meta which number sits behind your Phone Number ID and only accepts that one. Check that the number you typed matches the number shown on the API Setup page, and that the access token’s system user has full control of your WhatsApp account.