WhatsApp*
Updated October 11, 2026
On this page
For a personal number, use a QR code or the mobile app’s pairing code. For a business integration, choose Meta Cloud API, which uses separate credentials and messaging rules.
Before you connect
- Personal profile: WhatsApp with an active number and access to Linked devices.
- Business: access to the relevant Meta business account and WhatsApp Business Platform number.
Open the correct workspace in Chatva → Channels → the channel card → Connect. On first connection, use Next to go through the introductory steps. In the mobile app, the same guide is available during onboarding and under Channels.
Choose a scenario
Method 1. QR code
Display the QR code in Chatva
On web, choose Personal profile → Show pairing QR. In the app, choose By QR.
Open WhatsApp Linked devices
On Android, open WhatsApp → ⋮ → Linked devices; on iPhone, open WhatsApp → Settings → Linked devices. Press Link a device and scan the code from another screen. WhatsApp guide.
Wait for your number to appear
The QR may refresh; scan the currently displayed code. Once linked, check the connected number in Chatva.
Method 2. On a single phone
In the Chatva app, choose By phone number
Enter your full WhatsApp number with its country code and press Get code.
Copy or remember the pairing code
Chatva displays a pairing code. It is not an SMS or WhatsApp login code; enter it in Linked devices.
Press Open WhatsApp
Go to Linked devices → Link a device → Link with phone number. Enter the code shown by Chatva, then return to Chatva. WhatsApp phone-number pairing.
Method 3. WhatsApp Business through Meta
On web, choose Business (Meta*). If Connect through Meta is available, sign in, select the correct business and number, and complete the wizard. Otherwise use the manual form. The mobile app’s Business tab provides manual fields.
In Meta: find WhatsApp Business credentials
For manual Cloud API setup, open Meta apps and select your WhatsApp app. If needed, use the official setup guide to create it.
Find your business phone number ID
In your Meta app, open WhatsApp → API Setup (Start using the API in the new wizard). Select your business number under From and copy Phone Number ID. Do not use the phone number, WhatsApp Business Account ID, or a test number’s ID. Meta guide.
Open system users
In Meta business settings, select your business → Users → System users. Select or add the integration user, then assign your app and WhatsApp account under Assign assets. Meta instructions.
Meta Business Settings: System users → Add Assets. This published example uses the author’s app; choose your own. Dashboard layout may differ.
Source: Digital Inspiration · Meta Business Settings ↗Generate the integration access token
In Meta business settings, select Generate token, your app, expiry and the WhatsApp permissions listed in Meta’s guide, including whatsapp_business_messaging and whatsapp_business_management. Copy the result into Chatva’s Access token field.
Generate New Token on a Meta system user. Screenshot from Digital Inspiration’s guide.
Source: Digital Inspiration · Generate New Token ↗App Secret, Verify token and webhook URL
| Chatva field | Where to find it |
|---|---|
| Phone Number ID | Meta Apps → WhatsApp → API Setup → your business number → Phone Number ID. |
| Access token | Business Settings → System users → Generate token, as shown above. |
| Meta App Secret | Meta Apps → your app → App settings / Settings → Basic → App Secret → Show. Field reference. |
| Verify token | Choose a random string and enter the same value in Chatva and Meta. It is separate from App Secret and the access token. |
| Callback URL | Copy the webhook URL from Chatva’s WhatsApp Business form. Save the connection first, then paste it in Meta → WhatsApp → Configuration → Webhook. |
In Meta Apps, enter Callback URL and the same Verify token, verify the endpoint, then subscribe to WhatsApp messages. Official webhook setup.
Test an incoming message and a reply
Write from a different account
Send “Connection test” to the connected WhatsApp number. Use a different account to test an incoming customer message.
Find the conversation in Chatva
Open the correct workspace’s Inbox and check the channel and sender. If an assignee or status filter is active, switch to all conversations.
Reply from the inbox
Send “Message received” and confirm on the customer’s side that it arrived from the correct number, bot or page. Connection status alone does not confirm two-way delivery.
Multiple operators and numbers
After connection, your team handles conversations in the inbox. Use Connect another account for an additional personal number if your plan allows it. Test each new number separately.
Troubleshooting
| What happened | What to check |
|---|---|
| Cannot scan a QR on the same phone | In the Chatva app, switch to By phone number or display the QR on a computer. |
| Linked device disconnected | Check WhatsApp’s device list and reconnect the account in Chatva. |
| Meta cannot verify the URL | Save in Chatva before verification, compare Verify tokens exactly and use this workspace’s URL. |
| Incoming messages work but replies fail | Check the message error, token validity and Meta permissions. Test a reply to a recent customer message. |