Skip to main content
Version: 1.0

Setting Up the WhatsApp Channel

WhatsApp is the most complete channel on the platform and supports templates, interactive messages, payments via PIX/Boleto, and order status updates. The connection uses the WhatsApp Business API with Meta. From the Hub, you start Facebook Embedded Signup to authorize your WhatsApp Business Account (WABA) and phone number in your Meta Business Manager.

Prerequisites​

  • Facebook Business Manager account (Meta Business Suite)
  • Dedicated phone number for WhatsApp Business (cannot be linked to a personal account or another WABA)
  • Access to the Hub Chatt2.me dashboard with administrator permission on the Application

Connection process​

1. Start onboarding​

In the Hub Chatt2.me dashboard:

  1. Go to Channels → Activate/Configure → WhatsApp
  2. Click Connect with WhatsApp
  3. The Hub will redirect you to Facebook Embedded Signup

2. Authorize with Meta​

Within the Facebook Embedded Signup flow:

  1. Log in with the Meta Business Manager administrator account
  2. Select (or create) the WhatsApp Business Account (WABA) to be linked
  3. Select (or add) the phone number that will be the channel
  4. Complete the Meta authorization — this grants the Hub the permissions it needs to send and receive messages on your behalf through the WhatsApp Business API
What is a WABA?

A WhatsApp Business Account is the Meta entity that groups your business's phone numbers. A WABA can have multiple numbers, but each number is a separate channel in the Hub.

How onboarding works

Hub Chatt2.me connects your WhatsApp Business number using Meta's Embedded Signup in Business Manager. You attach a WABA and phone number to your organization; authorization is completed in Meta, and the Hub then uses that connection for messaging.

3. Verify the number status​

After onboarding, the number goes through verification. Possible statuses are:

StatusDescription
PENDINGAwaiting Meta verification
CONNECTEDReady to use
FLAGGEDAccount with restrictions — check Meta policies
RESTRICTEDLimited sending — resolve pending issues in Meta

4. Accept Zero-Tap terms (if prompted)​

Some numbers need to accept the terms of Meta's Zero-Tap program. If the dashboard shows this pending action, accept the terms in the channel settings section.

5. Complete the business profile​

Configure your WhatsApp Business public profile:

  • Company name
  • Description
  • Address
  • Business category
  • Website

This is important for passing Meta's review and increasing user trust.

Templates​

WhatsApp requires Meta-approved templates to initiate conversations outside the 24-hour service window. For the full guide on creating templates, submitting for approval, and sending them — including dynamic headers, buttons, and the ORDER_STATUS type — see WhatsApp Templates.

Important limitations​

  • Outside the 24h window, only approved templates can be sent
  • Free text messages only work within an active session (user responded in the last 24h)
  • The number cannot be connected to WhatsApp on a phone while it is on the API

Identifying the sender (from)​

In POST /v1/communication/whatsapp/message, set from to the application channel UUID or the WhatsApp business phone number configured for that channel (with or without a leading +). The UUID always works as a fallback. See Sending messages overview.

Next steps​