Connecting WhatsApp Business with the Embedded Launcher

The WhatsApp Business Embedded Launcher connects a WhatsApp Business account to TextPeak through a Meta sign-in wizard, so you no longer paste an auth token and a business ID by hand. This article covers what the launcher does, the one change it makes to how WhatsApp channels work, and what to do until it reaches your account.

What the launcher changes

Until now, connecting a WhatsApp Business account meant collecting an auth token and a business ID from Meta and entering them into the channel's WhatsApp settings. CommPeak is now an official WhatsApp Business partner, which allows the sign-in flow to run inside Meta instead.

• You click a Facebook sign-in button in TextPeak.
• A Meta wizard opens in a pop-up window, outside TextPeak.
• You sign in to your Facebook Business account, select the WhatsApp account, select the phone number, and grant the permissions the wizard asks for.
• On finish, TextPeak configures the channel from what the wizard returns. No token and no business ID are entered by hand.

One phone number per channel

To send from more than one number, create one WhatsApp channel per number. The channels can all belong to the same WhatsApp Business account, so this is a change in how the routes are organized rather than a change in what you can send.

This also affects where those numbers appear elsewhere in the platform. Sender profiles, incoming routing, the inbox, and CommPeak Dialer all resolve a WhatsApp channel to its one number.

VERIFY: what happens to existing WhatsApp streams that carry several numbers when the launcher ships, and whether they are split automatically or need manual work. Confirm with Ben C.

Connecting an account with the launcher

VERIFY: the steps below are drafted from the briefing. Confirm the button label, the wizard screens, and the confirmation state against the working launcher.

1. Log in to TextPeak in your browser.
2. Click Channels in the main menu on the left, then open the WhatsApp card.
3. Click Add channel.
4. On the Channel details step, enter a Channel name and a Channel description, then click Next.
5. On the WhatsApp settings step, click the WhatsApp Business sign-in button. A Meta wizard opens in a pop-up window.
6. Sign in to your Facebook Business account.
7. Select the WhatsApp Business account, then select the phone number this channel sends from.
8. Grant the permissions the wizard asks for, then click Finish.
9. The pop-up closes and the channel shows the connected account.

Connecting an account before the launcher is available

Until the launcher reaches your account, the WhatsApp settings step asks for the credentials directly.

1. Follow steps 1 to 4 above.
2. In Auth token, paste the token from your WhatsApp Business account.
3. In Business ID, paste the business ID.
4. Click Save & activate.

For where to find those two values, see Creating a Token for WhatsApp Business.

Replacing the credentials on a connected channel

Open the channel from the WhatsApp channels list, go to WhatsApp settings, and click Replace credentials. The section shows which business the channel is currently connected to.

For the rest of the channel actions, including templates and the lifecycle controls, see Channels Overview.