What you can do:
Use cases
Customer support. Your AI agent answers from its Data Sources and can read the photos and documents customers send, such as a picture of a damaged item. When it can’t help, the Escalations Action opens a ticket and the AI agent tells the customer a ticket was opened. With Chatbase Helpdesk as the ticket platform, the conversation is handed to your team: the AI agent stops replying, your team’s replies show up live in the WhatsApp chat, and closing the ticket hands it back to the AI agent. Order questions. With Shopify connected, the Retrieve and display orders Action works on WhatsApp, so customers can ask “Where is my order?” and get the status from Shopify. Proactive messages. WhatsApp Campaigns send approved templates to the contacts you choose, for example a Utility template about orders or a Marketing template about a sale. Replies go to your AI agent or, if you choose Human takeover, to a Helpdesk ticket. Sales in the chat. With WhatsApp Catalog, the Retrieve and display products Action sends your Shopify products as native WhatsApp product cards. Customers browse them, add items to a WhatsApp cart, and send the cart to your AI agent to continue to checkout. Customers can also send a photo of a product, and the AI agent finds matching products with search by image.Before you start
The WhatsApp phone number integrated with the AI agent can only be used by the AI agent. It can’t also be used on WhatsApp or WhatsApp Business.The number is already used with WhatsApp
The number is already used with WhatsApp
- Open the WhatsApp or WhatsApp Business app.
- Navigate to Settings > Account.
- Select Delete my account. This may take a few minutes, after which the number becomes available.
You previously used WhatsApp through Meta Developer for business
You previously used WhatsApp through Meta Developer for business
- Log in to your WhatsApp Business Account.
- Choose the phone number you’d like to integrate.
- Navigate to Settings > Two-step verification and turn it off.
How to connect WhatsApp
Open the WhatsApp channel
Log in with Facebook


Choose or create a business profile



Add a phone number


Finish the connection


Update your WhatsApp settings (optional)

Automatic lead collection
Chatbase can automatically collect basic customer information from WhatsApp conversations, including the phone number and name when available. To enable it:- Go to Channels → WhatsApp → Manage → Leads.
- Toggle Enable Automatic Collection of Leads.
- Select the WhatsApp number or numbers you want to apply this to.
Response delay
Customers on WhatsApp often send several short messages in a row. If your AI agent replies too fast, it answers each message separately before the customer has finished. The WhatsApp response delay sets how long your AI agent waits after the latest customer message before it replies. Messages sent during that wait are grouped into one reply instead of one reply per message. To set it:- Go to Channels → WhatsApp → Manage → Delay.
- For each WhatsApp number, set a Minimum delay and a Maximum delay in seconds.
- Click Save.
Messaging limits and billing
WhatsApp conversations involve two separate costs: Chatbase message credits for your AI agent’s replies, and Meta’s charges for messages sent through WhatsApp. Chatbase message credits. Each reply your AI agent sends uses message credits based on its AI model (Auto is the default). A reply that triggers an Action, such as looking up an order, costs twice the model’s usual credits. Attachments customers send add credits per image or per PDF page. Meta charges. Once your integration is active, the first 1000 messages your AI agent sends each month are free. To send more, add a payment method in your Meta billing settings. Meta also charges for each template message, whether you send it from the Helpdesk or in a campaign, with fees that vary by country and template category. See Meta’s WhatsApp pricing for current rates. The 24-hour window. Your AI agent and your team can send free-form replies within 24 hours of the customer’s last message. After that, the only way to reach the customer is an approved template. When the customer replies, the window opens again. Messaging tiers. Meta assigns your WhatsApp Business Account a messaging tier based on quality and volume, which sets how many unique contacts you can message per day. Your current usage is shown as Meta limits on the Outbound campaigns page. See WhatsApp Campaigns.Limitations
- The number is exclusive to the AI agent. A number connected to Chatbase can’t also be used in the WhatsApp or WhatsApp Business app. To keep using the WhatsApp Business app, use coexistence.
- 1000 free AI messages per month. Meta doesn’t charge for the first 1000 messages your AI agent sends each month. Beyond that, a payment method is required in Meta billing.
- Free-form replies are limited to a 24-hour window. After that you must use an approved template. See WhatsApp Templates.
Best practices
Give WhatsApp its own instructions
Turn on the commerce Actions together
Set up a path to your team
Add Meta billing before you need it
Troubleshooting
The number can't be connected
The number can't be connected
The AI agent stopped replying in a conversation
The AI agent stopped replying in a conversation
You can't send a free-form message to a customer
You can't send a free-form message to a customer
Template or campaign messages fail to send
Template or campaign messages fail to send
Frequently asked questions
Can I keep using my number in the WhatsApp Business app?
Can I keep using my number in the WhatsApp Business app?
Can the AI agent message customers first?
Can the AI agent message customers first?
How much does WhatsApp cost?
How much does WhatsApp cost?
Can customers buy products inside WhatsApp?
Can customers buy products inside WhatsApp?
Can I connect more than one number?
Can I connect more than one number?