Connect your agent to a WhatsApp business number so it answers WhatsApp messages for you. Most people connect in a few minutes by signing in with Meta. You don't need a developer account.
WhatsApp is available on the Hobby plan and above. Only agent owners and editors can connect or change it.
Before you start
You need a WhatsApp business number. Either kind works:
- A number on the WhatsApp Business app. You can keep using the app on your phone after you connect.
- A number on the WhatsApp Business Platform (Cloud API).
Regular personal WhatsApp accounts can't be connected. Use a separate business number, or move your existing number to WhatsApp Business. Back up your chats before you move a number.
Connect WhatsApp
- Select your agent from the dropdown at the top of the dashboard.
- Open Install in the sidebar and choose Manage on the WhatsApp card.
- Click Connect WhatsApp. A Meta sign-in window opens.
- Sign in, choose your business and WhatsApp number, and approve access.
- Chatwith finishes the setup for you. When it's done, the dialog says WhatsApp is connected and shows your number.
To test it, send a message to your number from another phone. The conversation shows up in Conversations, labeled WhatsApp.
If the Meta window closes before you finish, the dialog says WhatsApp setup is incomplete. Click Reconnect with Meta to finish.
Pause or disconnect
- Pause: use the switch on the WhatsApp card. Your agent stops replying, but the connection stays. Turn it back on to resume.
- Disconnect: open the WhatsApp dialog and click Disconnect WhatsApp. Your agent stops replying to WhatsApp messages. You can connect again later.
Each WhatsApp business account can be connected to one agent at a time. To move it to another agent, disconnect it first.
Manual setup (advanced)
Use manual setup only if you manage your own Meta developer app and already have WhatsApp Business Platform credentials. Manual setup can't connect a personal WhatsApp account. If you connected with Meta sign-in, manual setup isn't shown.
In Meta
- Go to Meta for Developers, click Create app, and choose Business.
- On the app dashboard, find WhatsApp and click Set up.
- Get two credentials:
- Access token: in Business Settings → System Users, create a system user with the Admin role. Add your app and WhatsApp Business Account as assets with Full control. Click Generate New Token, check
whatsapp_business_messagingandwhatsapp_business_management, and set expiry to Never. - App secret: in App Settings → Basic, click Show next to App Secret and copy it.
In Chatwith
- Open Install in the sidebar, choose Manage on the WhatsApp card, and expand Advanced: manual setup.
- Copy the Webhook Callback URL and Webhook Verify Token.
- In Meta, open WhatsApp → Configuration. Click Edit next to Callback URL, paste both values, and click Verify and save.
- Under Webhook fields, click Manage and subscribe to
messages.
- Back in Chatwith, paste your WhatsApp Access Token and Meta App Secret, then click Connect manually.
The temporary token on Meta's API Setup page expires after 24 hours. Use a System User token, or the connection stops working a day later.
Good to know
Media
Agents on WhatsApp reply to text messages. Messages with media (images, audio, voice notes, documents) are ignored.
The 24-hour window
WhatsApp lets your agent reply freely for 24 hours after a person's last message. To message someone outside that window, WhatsApp requires a pre-approved message template, which you set up in Meta's WhatsApp Manager. When people message you first, you won't hit this limit.
Troubleshooting
- "Upgrade your plan to connect WhatsApp." WhatsApp needs the Hobby plan or above. View plans.
- "This WhatsApp business account is connected to another agent." Disconnect it from the other agent first, then connect it here.
- The Connect button is greyed out. Guests can't change channels. Ask an agent owner or editor.
- Messages don't reach your agent (manual setup). Check that you subscribed to the
messageswebhook field in Meta, and that your access token hasn't expired.