Connect WhatsApp

WhatsApp works through the official WhatsApp Business Platform (Cloud API). There are two ways to connect a number, and you pick one on the same screen:

• A number I use on the WhatsApp Business app (best for most businesses). The number stays on your phone and you keep replying from the app. The same chats also reach the inbox, and the last 180 days of chats are imported.
• A new number, or one not used on WhatsApp. The number works from the inbox only, with no app on a phone. It needs a verification code by SMS or a call.

Option 1: a number you already use on the WhatsApp Business app

Before you start

• The number runs on the WhatsApp Business app (not the personal WhatsApp app), updated to version 2.24.17 or later. Keep the phone in your hand during the connection.
• The number is not already connected to the WhatsApp Business Platform anywhere else.
• A Facebook account to sign in with. In the Meta window you choose your business (Meta business portfolio) or create one; the WhatsApp Business Account is created for you.
• Linked devices (WhatsApp Web, the desktop app, a tablet) are signed out when you connect. Link them again afterwards by scanning the QR code as usual.

Connect

1. Open the STS Connect Inbox and go to Settings → Inboxes → Add Inbox, then choose WhatsApp.
2. Choose A number I use on the WhatsApp Business app, read the Before you start list, and press Connect with WhatsApp Business.
3. In the Meta window, sign in, pick or create your business, and choose the number. Meta shows a code: copy it.
4. On the phone, open the message from the Facebook Business account in the WhatsApp Business app and tap Connect.
5. Choose to share your chat history so the last 180 days are imported. If you skip this, only new chats reach the inbox.
6. Back in the inbox, add the agents who should answer this number under Collaborators.

The inbox settings show a Data sync from the app card with the number of contacts synced and the progress of the history import. Imported conversations arrive as resolved, so they do not notify your team or trigger automations. Replies you send from the phone appear in the inbox with a From phone badge.

What changes on the phone

• One-to-one chats keep working in the app and in the inbox at the same time.
• Groups and calls stay in the app only; they do not reach the inbox.
• Broadcast lists become read-only, and disappearing messages, view-once messages and live location are turned off for one-to-one chats.
• Up to 4 linked devices keep working (WhatsApp for Windows and Wear OS are not supported). For more people, give each one an inbox seat instead.
• Open the app on the phone at least once every two weeks. Otherwise Meta disconnects the number from the inbox. If that happens we email your administrators and show a banner in the inbox with a reconnect button.

Option 2: a new number, or one not used on WhatsApp

Before you start

• A Meta Business Manager account (business.facebook.com). Create one if you don't have it.
• A phone number that is not currently registered on the WhatsApp or WhatsApp Business app, and that can receive an SMS or a call. To move a number that is on the app without keeping the app, delete the WhatsApp account on the phone first (Settings → Account → Delete my account), or use Option 1 instead.
• Your business display name as customers should see it.

Connect

1. Open the STS Connect Inbox and go to Settings → Inboxes → Add Inbox, then choose WhatsApp.
2. Choose A new number, or one not used on WhatsApp and press Connect with WhatsApp Business.
3. In the Meta window, sign in, pick or create your business, and create your WhatsApp Business Account.
4. Add the phone number, enter the verification code sent by SMS or call, and finish.
5. Back in the inbox, add the agents who should answer this number under Collaborators.

Send a test message from your own phone to the number. It appears as a new conversation within seconds.

Prepare the number for campaigns (optional)

Inbound and outbound chats work as soon as the inbox is connected. To send WhatsApp campaigns from the portal, register the number there too:

1. In Meta Business Manager open WhatsApp → API Setup and copy the Phone number ID and the WhatsApp Business Account ID.
2. Create a system user with a permanent access token that has the whatsapp_business_messaging and whatsapp_business_management permissions.
3. In the portal open WhatsApp Numbers → New, paste the three values, and mark the number as Default for campaigns.

The token is stored encrypted and never shown again.

Good to know

• Meta bills the WhatsApp Business Account directly, so add a payment method to it in Meta Business Suite. Without one, Meta does not deliver your replies from the inbox. Messages you send from the WhatsApp Business app stay free, and incoming messages are free.
• Customer-initiated conversations can be answered with free-form messages for 24 hours (Meta charges these replies after 1,000 a month per number; see Lower your WhatsApp bill). After that, or to start a conversation, you must use an approved message template (portal → WhatsApp Templates).
• Meta limits how many new conversations a new number can start per day. The limit rises automatically as customers keep engaging with you.
• Complete business verification in Meta Business Manager to show your display name and raise limits.