Connect WhatsApp Cloud API

Send and receive WhatsApp messages from leads directly inside Telemantix CRM.

Who can do this: Roles with the integrations permissionLast updated: 29 September 2026

What you'll need

  • A Facebook Business account verified by Meta
  • A WhatsApp Business Account (WABA)
  • A phone number for your business. A brand-new number is simplest; an existing WhatsApp number also works once it has been removed from the WhatsApp or WhatsApp Business app on the phone (Settings → Account → Delete account) — your contacts stay, but old chat history on that phone is not moved to the API.
  • A Meta Developer App

Step 1 — Set Up WhatsApp Business Account

1
Go to business.facebook.com → Business Settings.
2
Under Accounts → WhatsApp Accounts, create or connect your WABA.
3
Add and verify your business phone number.
4
Note your WhatsApp Business Account ID — Meta also calls it the WABA ID; it is the same number.

Step 2 — Configure Developer App

1
Go to developers.facebook.com → create or open your Business app.
2
Click Add Product → add WhatsApp.
3
Go to WhatsApp → Getting Started.
4
Select your WABA and phone number — note the Phone Number ID displayed.

Step 3 — Generate a Permanent API Token

The temporary token on Getting Started expires after 24 hours. For production, create a permanent system user token:

1
Go to Business Settings → System Users.
2
Create a system user with Admin role.
3
Click Generate New Token → select your app → add whatsapp_business_messaging and whatsapp_business_management permissions.
4
Copy and save the generated token — it won't be shown again.

Step 4 — Connect in Telemantix

1
Go to Integrations → WhatsApp Cloud API → Configure.
2
Enter your Phone Number ID and WhatsApp Business Account ID.
3
Paste your API Token (system user token from Step 3).
4
Set a Verify Token — any string you choose (e.g. tmx_wa_2026).
5
Click Save & Connect.

Step 5 — Register the Webhook

1
In your Meta Developer App, go to WhatsApp → Configuration → Webhook.
2
Set Callback URL to the webhook URL shown in your configure modal.
3
Set Verify Token to the same value you entered above.
4
Click Verify and Save.
5
Under Webhook Fields, click Manage and subscribe to the messages field.

Fields Reference

Phone Number IDThe numeric ID of your WhatsApp phone number — shown in Meta Developer → WhatsApp → Getting Started.
WhatsApp Business Account IDAlso called the WABA ID — one number, shown in Business Settings → WhatsApp Accounts and on WhatsApp → Getting Started.
API TokenSystem user permanent access token with whatsapp_business_messaging permission.
Verify TokenAny string you choose — must match the Verify Token in Meta Webhook settings.

Common Issues

Webhook verification fails

Ensure the Verify Token matches exactly. Also confirm the Callback URL is publicly accessible (not localhost).

Messages not appearing in inbox

Check that the messages webhook field is subscribed in WhatsApp → Configuration → Webhook Fields.

Cannot send messages after 24 hours

WhatsApp restricts free-form messages to a 24-hour window after the last inbound. Use WhatsApp Campaigns to send approved templates to restart the conversation.

API token rejected

Ensure the system user has the whatsapp_business_messaging scope and is associated with the correct WABA.

Still stuck?

WhatsApp us on +91 99103 43016 or raise a ticket from Support Tickets inside the app.