Connect WhatsApp with Meta

Who it is for: whoever manages the account

What it is for

It connects your WhatsApp Business number to TalkAI in a few minutes. The recommended way is Embedded Signup: an official Meta wizard that does almost everything for you, in a single window.

💡

Tip:If it is your first time, use Embedded Signup. You do not need to copy tokens or IDs by hand: TalkAI gets them on its own.

Option A: Embedded Signup (recommended)

➡️

Step:In TalkAI, go to Settings > External APIs > WhatsApp Business Cloud API and click Connect WhatsApp Business.

The Meta popup opens. There you will:

Log in with your company's Facebook account.
Choose (or create) your Meta Business and your WhatsApp Business Account (WABA).
Add and verify the phone number (by SMS or call).
Accept the permissions TalkAI asks for.

When the popup closes, TalkAI automatically receives the number, the WABA and the token. The number is also registered and a 6-digit two-step verification PIN is generated and stored.

ℹ️

Note:We keep that PIN for you. If you ever reconnect the same number, the PIN is reused (it avoids the 409 "PIN already set" error).

Option B: Manual credentials

If Embedded Signup is not available for your account, you can load the credentials by hand. From your app at developers.facebook.com you need:

Phone Number ID: in WhatsApp > API Setup, next to the number.
WABA ID (WhatsApp Business Account ID): also in API Setup.
Access Token: a permanent system token (Business Settings > System Users) with permissions over the WABA.

🚫

Important:TalkAI configures the webhook automatically when you connect. If you load things by hand and messages do not arrive, check in Meta (WhatsApp > Configuration) that the Callback points to TalkAI and that you are subscribed to the messages field.

Business verification (Meta Business)

To send campaigns and templates at scale, Meta asks you to verify your business (1 to 7 business days): at business.facebook.com/settings/security > Business verification. You can connect and test before verification is complete.

Check that it works

Send a WhatsApp message to your number from another phone.
It should appear in the TalkAI Inbox within seconds.

Enable calls on the number

To receive and make WhatsApp calls from TalkAI, the calling feature must be enabled on the number. It is managed from Meta Business Suite:

Go to business.facebook.com.
Open WhatsApp Manager > Account settings > Phone numbers.
Choose the number and, in the business profile, turn on the calling option.
Save the changes.

Then set where calls go in Service mode and reopening window. If you prefer the opposite (your contacts should not see the call button), turn the same option off.

The change can take a few minutes to show up.
It is per number: if you have several, repeat it on each one.

Common errors

Problem	Fix
The popup does not open or closes by itself	Turn off the pop-up blocker and try again
Messages do not arrive	Reconnect from Settings; check the number is verified in Meta
Authentication error	The token expired or lost permissions: reconnect with Embedded Signup
Error when sending	The number or the WABA is not yet approved in Meta