WhatsApp

Connect your WhatsApp Business number so the AI agent answers customers on WhatsApp and your team replies from the same inbox as website chat.

Connect a WhatsApp Business number and the agent that answers on your website also answers your customers on WhatsApp. Each chat opens a conversation in your team inbox, the agent answers from your knowledge base with the same actions and handoff rules as website chat, and your team can step in from the inbox. WhatsApp is on the paid plans: Starter, Growth and Scale.

What WhatsApp in PepoChat is, and is not

The agent answers people who message your number. It does not start conversations, send campaigns or use message templates, and it does not answer WhatsApp calls. Messages are text only in both directions: a photo, voice message or file a customer sends cannot be read by the agent, and your team cannot attach files to a reply.

Before you start

  • Your workspace is on Starter, Growth or Scale. On Free, the Channels page shows one card, WhatsApp and Messenger are available on the paid plans, with a See plans button.
  • You are an owner or admin of the workspace. Members see the page but cannot connect or disconnect.
  • You have a Facebook account that manages your business with Meta. If the business has no business portfolio or WhatsApp Business account yet, Meta creates them during the signup.
  • You have the phone number at hand. A number that is on the WhatsApp Business app can stay there and work in both places. A number that is not on WhatsApp must be able to receive an SMS or a call, for Meta's verification code. A number in use on the regular WhatsApp app cannot be connected as it is.

Connect your number

  1. Open Channels

    Click Channels under Configure in the sidebar. The card Connect WhatsApp or Messenger has both buttons.

  2. Click Connect WhatsApp

    A Meta window opens and the button reads Waiting for Meta…. If nothing opens, your browser blocked the pop-up: allow pop-ups for app.pepochat.com and click again.

  3. Finish Meta's signup

    Log in with Facebook, choose or create your business portfolio and WhatsApp Business account, then add or choose the phone number and confirm it with the code Meta sends. Meta runs these screens, so their wording can change; the last one has a Finish button.

  4. Check the number is listed

    Back in PepoChat a message confirms "WhatsApp connected" with your number, and the number appears under Connected with "no messages yet".

Then send a WhatsApp message to the number from another phone. Within a few seconds the agent replies, a conversation tagged WhatsApp appears in Conversations, and the row under Connected shows when the last message arrived.

How conversations work

  • The conversation is listed under the customer's WhatsApp profile name. Their phone number is kept with the visitor's details.
  • A customer who uses a WhatsApp username may arrive without a phone number. The agent and your team answer them the same way, and the number is added to the visitor's details if Meta shares it later.
  • The agent answers as it does on your website: from the knowledge base, with your custom actions, booking and handoff rules. Its formatting is adapted to WhatsApp, so bold text and lists look right and a link is written out as a web address.
  • When a customer sends a photo, a voice message or a file, the agent cannot read it and asks them to describe it in words.
  • A reply longer than 4,096 characters is sent as several WhatsApp messages.
  • When a conversation is resolved and the customer writes again, a new conversation opens for the same customer.
  • WhatsApp conversations appear under Conversations by channel in Analytics, and the REST API and webhooks report them with the channel whatsapp.

Reply as your team

Open the conversation in the team inbox, type your reply and press Enter. It arrives in the customer's WhatsApp chat, and the conversation becomes escalated so the agent stops answering. Set it back to unresolved to hand it back to the agent.

Meta's 24-hour window

Meta delivers a reply only within 24 hours of the customer's last message. After that, a reply typed in the inbox is not delivered: a line above the reply box says "The last reply was not delivered" with Meta's reason, and the number's row on Channels shows the same. The window opens again as soon as the customer writes.

Keep using the WhatsApp Business app

If your number is on the WhatsApp Business app, Meta's signup offers to keep it there. The app keeps working on your phone, and PepoChat answers the same chats. Two things to know:

  • A reply you send from the app on your phone is not shown in the PepoChat inbox, and it does not pause the agent. To take a chat over, reply from the inbox.
  • Meta sets the conditions for this option, including which app versions and countries qualify. Its signup tells you when a number cannot be used this way.
  • Keep the app open for a few minutes after connecting while Meta finishes the setup. PepoChat requests the contacts and history sync Meta requires, and does not copy your old chats or your contacts.
  • Meta changes a few things in the app: broadcast lists become read-only, disappearing messages, view once and live location are turned off for one-to-one chats, and linked devices are unlinked (you can link supported ones again).
  • Open the app on the main phone at least every two weeks. After about 14 days without it, Meta disconnects the number. PepoChat then shows a warning next to the number on Channels and emails the workspace's owners and admins.

What it costs

WhatsApp is included in Starter, Growth and Scale. There is no fee per number or per message from PepoChat: an AI reply on WhatsApp counts as one AI reply on your plan's monthly allowance, like a reply in the widget, and replies your team types are not counted. See Plans, billing and usage.

Meta bills WhatsApp messages separately, to your own WhatsApp Business account, and never through PepoChat. At the time of writing, Meta delivers the first 1,000 replies a month from each number at no charge, counting the agent's replies and your team's together. Beyond that it charges per message, and it stops delivering replies for the rest of the month unless a payment method is set in your Meta billing settings. PepoChat sends no templates or marketing messages. See Meta's pricing documentation for the current rates. For rates by country and worked examples, see WhatsApp Business API pricing.

If your workspace moves to Free with the number still connected, messages keep arriving in Conversations for your team to answer, and the agent stops answering them until the workspace is on a paid plan again.

Disconnect or move a number

Click Disconnect next to the number on Channels. Messages to it are ignored from then on, and its conversations stay in the inbox; a line above the reply box says the channel is disconnected. Click Connect WhatsApp again to reconnect it.

A number belongs to one workspace at a time. To move it, disconnect it in the first workspace, then connect it in the second.

Troubleshooting

What you seeWhat to do
"WhatsApp and Messenger are available on the paid plans"The workspace is on Free. Click See plans and choose Starter, Growth or Scale.
Nothing opens after Connect WhatsAppAllow pop-ups for app.pepochat.com and click again.
"The signup was closed before finishing"The Meta window closed before its last screen. Click Connect WhatsApp and go through to Finish.
"Meta did not complete the connection" with a reasonThe reason is Meta's. The usual causes are a Facebook account without full control of the business portfolio, or a number still registered somewhere else.
"This number or Page is connected in another PepoChat workspace"Disconnect it in that workspace first.
"WhatsApp connected, but the number is not registered for sending yet"Meta linked the number but refused to register it, often because a previous provider set a two-step verification PIN. Turn two-step verification off for the number in WhatsApp Manager and connect again.
"The last reply was not delivered" in a conversationUsually more than 24 hours have passed since the customer's last message, and the reply goes through once they write again. If it happens inside the window, the number may have used Meta's free replies for the month with no payment method set.
Needs attention next to a number on ChannelsThe line gives Meta's reason. After a move to a new device the number normally comes back by itself within a few minutes. Otherwise fix the cause and click Connect WhatsApp. The warning clears as soon as a reply goes through.
Messages reach your phone but no conversation opensCheck that the number is listed under Connected. If it is and "last message" does not change, contact support.

Something missing or wrong on this page? Tell us and we will fix it.