Telemantix Docs
Back to Integrations

Connect WhatsApp Cloud API

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

What you'll need

  • A Facebook Business account verified by Meta
  • A WhatsApp Business Account (WABA)
  • A phone number not previously registered with WhatsApp
  • 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 (also called WABA ID).

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, Business Account ID, and WABA 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.
Business Account IDYour WhatsApp Business Account (WABA) ID — shown in Business Settings → WhatsApp Accounts.
WABA IDUsually the same as Business Account ID. Used for campaign-level operations.
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.