Docs/Messaging Channels/WhatsApp Business

WhatsApp Business

Connect your WhatsApp Business number so your AI agent automatically replies to customer messages on the world's largest messaging platform. Once connected, the agent replies to every inbound message 24/7 using your knowledge base — no human intervention needed.

Requirements

  • A Meta Business Account with WhatsApp Business API access.
  • A verified WhatsApp Business phone number set up in Meta Business Manager.
  • Admin access to your WhatsApp Business Account to authorise the connection.
ℹ️
The WhatsApp Business API is separate from the WhatsApp Business app on your phone. If you only have the mobile app, you need to upgrade to the API through Meta Business Manager before connecting here.

Connecting via OAuth (recommended)

1

Open your agent and go to Deploy → WhatsApp

In the left sidebar, click Deploy, then select the WhatsApp tab.
2

Click Connect with Meta

This opens Meta's secure OAuth flow. Log in with the Facebook account that has admin access to your Meta Business Manager.
3

Grant permissions and select your WhatsApp account

Follow the Meta prompts to grant access and choose which WhatsApp Business Account and phone number to link.
4

Connection confirmed

Once authorised, the page shows your connected phone number, WhatsApp Business Account ID, and connection timestamp. The agent is now live and replying.
5

Test it

Send a WhatsApp message to your business number. You should receive an AI-generated reply within seconds.

What the connected view shows

Once connected, the Connect tab displays your integration details:

  • Phone number — the WhatsApp Business number currently linked.
  • Phone number ID — the Meta API identifier for the number.
  • WhatsApp Business Account ID — your WABA identifier.
  • Connected at — when the integration was first authorised.
  • Status — shows "Live — Replying" when the integration is active.

Stats tab

The Stats tab shows real-time usage for this channel:

MetricWhat it measures
Messages receivedTotal WhatsApp messages forwarded to the agent.
AI repliesCount of replies the agent sent back.
Reply ratePercentage of received messages that got a reply.
Last messageTimestamp of the most recent inbound message.
14-day chartDaily message volume bar chart for the past two weeks.
Message logPaginated list of message/reply pairs with sender and timestamps.

Disconnecting WhatsApp

Click Disconnect on the Connect tab. This immediately stops the agent from replying to WhatsApp messages. Your message history and stats are preserved — you can reconnect at any time to resume. When reconnecting, re-run the OAuth flow to issue a fresh access token.

⚠️
WhatsApp Business API has a 24-hour customer service window. You can only reply to a customer who has messaged you in the last 24 hours. If the window has closed, you must use an approved WhatsApp Message Template to re-initiate contact. The AI agent replies within the window but cannot send proactive template messages.
💡
Add your most frequently asked WhatsApp questions as Q&A pairs in your knowledge base. Q&A answers are always retrieved first in the RAG pipeline, producing precise, consistent replies to common customer messages like "What are your hours?", "How much does it cost?", or "How do I track my order?"

Was this page helpful?