Skip to main content

Step 5 — Verify & Save Credentials in Whoxa CRM

With your Meta App configured, you now enter all credentials into Whoxa CRM and activate the connection.

Open Manual Configuration

  1. Log in to Whoxa CRM.
  2. Go to Settings → Integrations → Connect WhatsApp.
  3. Click the Manual Configuration tab.

Fill in the Form

Enter the following values (all found in your Meta App or Business Manager):

FieldWhere to Find It
Phone Number IDMeta App Dashboard → WhatsApp → API Setup → Phone Number ID
WhatsApp Business IDMeta Business Manager → WhatsApp Accounts → Account ID
Display NameThe name shown to customers (set during phone registration)
Registered Phone NumberThe phone number in international format, e.g., +919876543210
Access TokenGenerated in Step 3 (permanent system user token)
Webhook Verify TokenAuto-filled from the Webhook tab — or copy from Step 4

Save and Verify

  1. Click Save.
  2. Whoxa CRM will validate the credentials by calling the Meta API.
  3. On success, the page shows a green WhatsApp Connected badge.

Send a Test Message

To confirm everything works end-to-end:

  1. Go to the Chat section of Whoxa CRM.
  2. Start a new conversation with a test phone number.
  3. Send a message and confirm it arrives on the recipient's WhatsApp.
  4. Reply from WhatsApp and confirm it appears in the CRM inbox.

Connection is active. Your agents can now send and receive WhatsApp messages directly from the Whoxa CRM dashboard.


Troubleshooting

ProblemLikely CauseFix
"Invalid Access Token"Token expired or wrong scopesRegenerate token with correct permissions (Step 3)
Webhook verification failedServer not reachable or wrong verify tokenCheck API server is live and token matches
Messages not appearing in CRMWebhook fields not subscribedSubscribe messages field in Meta (Step 4)
"Phone number already registered"Number still on WhatsApp consumer appDelete WhatsApp account on that device first