AI agent
How do I connect WhatsApp?
Start on the shared platform number in minutes, or connect your own number through Meta — the inbox works the same.
Updated 2026-11-09 · 6 min read
WhatsApp lives under Communication → WhatsApp. Conversations land in an inbox there, the AI agent can answer them (ai-agent-basics), and every thread supports human takeover.
Two number modes
Connect the number in the web portal under Workspace → AI agent → Setup, on the WhatsApp number card. Once connected, you can answer its conversations in the web portal and the mobile app:
- Shared number — the fastest start. Your workspace uses a platform WhatsApp number; the page gives you a personalised link and QR code that opens a chat routed to your inbox. Put the QR on your site and counter, and you are reachable today.
- Your own number — your brand in the customer's contact list. Press Connect WhatsApp: the page takes you to the WhatsApp connection page, where you sign in with Facebook and pick or verify your WhatsApp Business number. When you finish there you come back to this page on your own, and the card shows Connected as with your number.
Switching to your own number later
Start shared, switch whenever. During a number change (Change number, then Continue to WhatsApp) the platform serves replies from the shared number until the new connection is finished — the card says so explicitly, so a brief "interim shared" phase is expected, not an outage.
Connecting your own number involves Meta's own business checks, which can take from minutes to days depending on your business profile. Your customers keep being answered on the shared number meanwhile.
The connection did not finish
If you closed the WhatsApp connection page, or it reported a problem, the card says The last connection attempt did not finish with WhatsApp's reason, and the button reads Try again. It clears the old attempt and starts a new one; nothing about your shared number changes.
When the card shows a message instead of the button's result, it names the cause: a number already connected to another account (disconnect it there first, or use another number), or WhatsApp connections being temporarily unavailable (try again later; nothing changed on your number).
Keeping the connection alive
Under Connected as the card shows the connection's status, that it runs through Meta, and until when the connection is valid. Meta's access to your number has to be renewed every so often. From 14 days before it runs out, the card says when it expires and shows Reconnect WhatsApp; you and your team's admins also get a notification, and our team is told too. The same happens when WhatsApp reports a problem with the number.
A number connected before WhatsApp moved to Meta still runs on the old connection, which is being retired. The card says so and offers Reconnect WhatsApp: it takes you through the same WhatsApp connection page, and the shared number answers in the few minutes in between.
The inbox login
Your team also has its own login to the assistant's inbox, created with your business email when the agent is connected. The Inbox login card in the same Setup tab — visible to owners and admins only — shows the email, a temporary password (Show password, or copy it) and Open the inbox. You choose your own password at the first sign-in; after that the temporary one is deleted here and the card reads Login active for your email. If that email already has a login on the assistant platform, the card asks for another address.
The 24-hour window
WhatsApp's rules, not ours: a business may reply freely within 24 hours of the customer's last message. Drafted agent replies show how many hours are left to send them (suggest-mode), and once a window has closed the reply box in that conversation is replaced by a bar that says so, with Send a template. The conversation resumes the moment the customer writes again.
Under every message you send, ticks show how far it got on the customer's phone — Sent, Delivered, Read — or Not delivered when WhatsApp could not deliver it.
Starting a conversation yourself
New conversation, above the WhatsApp list, messages a customer who has never written to you; Send a template does the same in a conversation whose 24-hour window has closed, with the number already filled in. WhatsApp does not allow a free-text opener in either case, so you pick one of your workspace's approved templates instead, enter what the template asks for, confirm the customer actually agreed to be contacted, and send. The Preview tab shows the template's wording with your fill-ins in place. The message goes out immediately — no waiting on a webhook — and the AI agent stays free to answer if they reply.
Templates live under Workspace → AI agent → Templates. Drafting one — its wording, category, language — is self-service with New template; getting it in front of Meta for approval is not, since that needs a staff login on the agent platform, so a freshly drafted template sits at "Pending review" until a colleague on our WhatsApp team submits it. Request a template opens a pre-filled email instead, for when you would rather have someone draft it for you. An empty list means nothing exists for this workspace yet, not a setting you are missing.
Threads that show who is writing
An incoming number is compared with the phone numbers your workspace already knows — the people at your dealers and partner tuners, plus any number you have linked by hand. An exact match heads the thread with that account; no match shows only the sender's WhatsApp profile name or the bare number. Link to an account on an unmatched thread (in its More menu, or under Lead details) teaches the inbox once: the answer is stored against the number, later messages from it match on their own, and a link you made by hand is never overwritten by the automatic matching. A number that could belong to more than one account deliberately stays unmatched rather than guessed.
Who sees what
WhatsApp threads are workspace conversations like any other: your team works them from the same inbox, takeover and release apply, and nothing about a thread leaves your workspace.
Each row keeps the Status you selected — New, Open, Won, Lost or Closed — visible beside separate Replied, Needs reply and agent-attention indicators. Changing the status does not erase a reply or replace the selected status with the conversation's reply state.
Still not connected
If the connection keeps failing, or the number has been verifying for days, open a support ticket with the number you are connecting and what the WhatsApp number card says. That is enough to find your attempt with WhatsApp.
Related articles
Didn’t find your answer?
Sign in and open a ticket, or contact us — a question that needed a person is also how this article gets better.
Last verified 2026-11-09.