Skip to main content

WhatsApp

Connect your WhatsApp Business number to send templates, run flows and receive evidence. Menu: Marketing › Channels › WhatsApp onboarding for onboarding and Marketing › Channels › Channels for the channel.

Availability

Permissions Meta health (view) and Connecting WhatsApp (Embedded Signup) (connect) · Edition: Growth and Enterprise (WhatsApp Channel feature)

WhatsApp onboarding screen with the connected WhatsApp Business accounts

Connect your number​

You do not paste credentials: the connection is made with Meta's wizard (Embedded Signup).

  1. Go to Marketing › Channels › Channels, create a channel of type WhatsApp and open it, or open Marketing › Channels › WhatsApp onboarding.
  2. Click Connect WhatsApp. Meta's wizard opens.
  3. Sign in with your Meta Business account, choose or create your WhatsApp Business account and register the number.
  4. When finished, the channel shows as Connected with the WABA ID, the Phone number ID, the Messaging tier and the Business verification.

If the button is disabled you will see "El Embedded Signup de WhatsApp todavía no está configurado para este entorno". Contact support.

WhatsApp onboarding​

This screen lists the WhatsApp accounts of your IncentIA account and the progress of each onboarding.

ColumnWhat it isNotes
WABA IDWhatsApp Business accountThe refresh icon updates its status
Phone number IDNumber at Meta
Display NameBusiness display name
StatusPending, Awaiting customer acceptance, Verifying, Active or Error
Provisioned numberNumber delivered by the partnerOnly for partner-initiated onboardings
App subscribed, Phone registered, Business profile set, Credit line sharedTechnical onboarding stepsYes / No
Messaging tierContacts allowed every 24 hRequest tier upgrade asks to raise it
Business verificationStatus with MetaIn red, Complete verification in Meta Business Manager appears
Last checked, Last errorTracking

The header buttons are:

ButtonWhat it doesPermission
Connect WhatsAppLaunches Meta's wizardConnecting WhatsApp (Embedded Signup)
Copy onboarding linkCopies a link so your customer can connect their own WhatsAppConnecting WhatsApp (Embedded Signup)
Iniciar solicitudAsks for the customer's Meta Business Manager ID and creates a partner-initiated requestInitiating Partner-initiated WABA request
Messaging tier / Business verificationRefreshes that data from MetaRefreshing Meta Health
RefreshReloads the table

Onboarding for a customer (360dialog)​

If you work as an agency with the partner-hosted mode, the brand or customer of a campaign owns the 360dialog account and the number is anchored to that campaign.

  1. In WhatsApp onboarding, choose For campaign (optional) or, if you do not choose a campaign, For brand (optional). Empty = account-level number.
  2. Click Connect WhatsApp if you do the onboarding yourself, or Copy onboarding link and send it to the customer.
  3. The customer completes the wizard from the link, without access to your panel.
  4. Follow the Status until it changes to Active.

These selectors only appear when your environment has partner mode configured. Otherwise "La incorporación de WABA iniciada por el partner todavía no está configurada para este entorno." is shown.

WhatsApp templates​

Messages you send first need a template approved by Meta. Below the onboarding table, the Message templates section lists the templates submitted to Meta.

  1. Click Create template (requires Creating/submitting WhatsApp message templates).
  2. If you have several accounts, choose the WABA ID.
  3. Fill in Name, Language, Category (UTILITY, MARKETING or AUTHENTICATION) and Body.
  4. Click Create.

The table shows the Approval status (Pending, Approved, Rejected or Disabled), the Rejection reason and the Submission error. For the text with variables the platform uses, see Templates.

Evidence over WhatsApp​

If a flow asks for a receipt photo, the participant sends it over WhatsApp and it is recorded as evidence. It reaches Operations › Evidence review like any other. With the channel paused, photos are not processed.

Protections against blocks​

WhatsApp can limit or block a number for sending too much, with low-quality templates, or to people who opted out. The platform protects you in two ways:

  • Account monitoring: queries Meta periodically and stores the quality, tier and statuses. See Meta health.
  • Reading errors on send: if Meta says the account is restricted, the platform stops sending and notifies you; if a template is disabled, it does not use it until you fix it; if a recipient has blocked you, it does not retry. Rate limits are retried automatically.
warning

Do not keep pushing after an account restriction: fix the cause first (template quality, recipient list, consents) or Meta may block the number.

Statuses and limits​

  • Meta reviews your business before allowing bulk sends; the process can take weeks.
  • Quality drops quickly if you send promotions to contacts who do not know you.
  • The Messaging tier limits (250, 1,000, 10,000, 100,000 or unlimited contacts every 24 h) depend on Meta.
  • A paused channel does not run flows; see Channels.

Permissions​

ActionPermission (UI text)Technical id
View Meta health and WhatsApp onboardingMeta healthPages.Communications.MetaHealth
Refresh statusesRefreshing Meta HealthPages.Communications.MetaHealth.Refresh
Connect and copy linkConnecting WhatsApp (Embedded Signup)Pages.Communications.MetaHealth.Connect
Start a partner requestInitiating Partner-initiated WABA requestPages.Communications.MetaHealth.InitiatePartnerRequest
Create WhatsApp templatesCreating/submitting WhatsApp message templatesPages.Communications.MetaHealth.ManageTemplates
Request tier upgradeRequesting messaging-tier upgradePages.Communications.MetaHealth.RequestTierUpgrade

Several of these permissions appear untranslated on the roles screen.