> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tartini.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect WhatsApp Business API (WABA)

> Connect a business WhatsApp number through Meta's official API and gain more stability in your support.

export const Artigo = ({titulo, href, children}) => <a className="lista-artigos-item" href={href}>
    <span className="lista-artigos-texto">
      <span className="lista-artigos-nome">{titulo}</span>
      {children ? <span className="lista-artigos-desc">{children}</span> : null}
    </span>
    <svg className="lista-artigos-seta" viewBox="0 0 24 24" width="18" height="18" aria-hidden="true">
      <path d="M9 6l6 6-6 6" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
    </svg>
  </a>;

export const Lista = ({titulo, children}) => <div className="lista-artigos">
    {titulo ? <p className="lista-artigos-titulo">{titulo}</p> : null}
    <div className="lista-artigos-itens">{children}</div>
  </div>;

WABA connects your business number through Meta's official API and lets you send approved message templates.

<Note>
  Who connects: Administrator, Company Manager, Area Manager, and Unit Manager. Available on all plans, with usage-based billing.

  The Tartini interface is in Portuguese. Screen and button names appear here exactly as on screen, with the translation in parentheses.
</Note>

***

## Before you connect

You need:

* A Meta Business account with business verification completed.
* A WhatsApp Business Account (WABA) created.
* An exclusive phone number, not active on regular WhatsApp or on WhatsApp Business on a phone.
* A 6-digit two-step verification PIN. If the number doesn't have one yet, you create it during the connection. Write it down and keep it safe: it can't be recovered later.

<Warning>
  The number needs to be exclusive to the API. If it's already active on another WhatsApp, unlink it before continuing.
</Warning>

***

## Get a business number

If you already have a number ready on WABA, skip to the next section. If not, Meta doesn't sell numbers directly: you need a partner authorized by Meta, called a BSP (Business Solution Provider), who handles provisioning, porting, and support. The WABA screen lists Zenvia and 360Dialog as partners, each with its own steps and required documents, plus a link to Meta's full partner list.

<Tip>
  To hire a BSP you'll need an active CNPJ (Brazilian company ID), a verified Meta Business account, and company documentation, plus a decision between registering a new number or porting one you already use.
</Tip>

***

## Connect through Meta, step by step

<Steps>
  <Step title="Open the WABA screen">Go to **Configurações > Canais > WABA** (Settings > Channels > WABA) and click **Conectar ao WhatsApp** (Connect to WhatsApp).</Step>
  <Step title="Confirm the prerequisites">In the prerequisites modal, check the list and click **Já tenho tudo, conectar** (I have everything, connect).</Step>
  <Step title="Fill in the channel details">Choose the **Entidade** (Entity) and give it a **Nome do canal** (Channel name).</Step>
  <Step title="Connect with Meta">Click **Conectar com Meta** (Connect with Meta). A Meta window opens for you to authorize access.</Step>
  <Step title="Authorize in the Meta window">Confirm your Meta Business account and the WABA. When it's done, the window closes on its own.</Step>
  <Step title="Select the number">Choose the number from the list that appears, with its quality rating (High, Medium, or Low).</Step>
  <Step title="Enter the PIN">Type the 6-digit two-step verification PIN and click **Confirmar** (Confirm).</Step>
</Steps>

<Note>
  If the browser blocks the Meta window, allow pop-ups for Tartini and click **Conectar com Meta** again.
</Note>

***

## Reconnect a WABA channel

Use this when Meta's authorization expires or when you need to switch numbers.

<Steps>
  <Step title="Open the channel menu">In **Configurações > Canais > WABA**, click the ⋮ next to the channel.</Step>
  <Step title="Choose Reconectar">Click **Reconectar** (Reconnect) and repeat the authorization in the Meta window.</Step>
</Steps>

***

## Track the channel status

* **Conectado** (Connected): receiving and sending messages.
* **Conectando** (Connecting): the connection is in progress.
* **Desconectado** (Disconnected): the channel stopped. Use **Sincronizar** (Sync) or **Reconectar** (Reconnect) in the channel menu.

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How long does the process take?">
    Between 2 and 5 business days, counting account verification and number provisioning.
  </Accordion>

  <Accordion title="Can I port my current WhatsApp Business number to WABA?">
    Yes. First unlink the number from regular WhatsApp Business, then register it on WABA through an authorized partner (BSP).
  </Accordion>

  <Accordion title="What's the difference from regular WhatsApp Business?">
    WABA is Meta's official API and lets you send approved templates. WhatsApp Business by QR Code uses an unofficial connection, which the screen itself flags as subject to ban risk and instability.
  </Accordion>

  <Accordion title="Does the number show up with the green verified badge?">
    Not automatically. Meta's verification badge follows a separate process, outside Tartini.
  </Accordion>
</AccordionGroup>

***

## Related articles

<Lista>
  <Artigo titulo="Channels explained" href="/en/canais/canais-explicados">The channels available in Tartini and when to use each one.</Artigo>
  <Artigo titulo="Create WhatsApp message templates" href="/en/canais/templates">Messages approved by Meta to start conversations.</Artigo>
  <Artigo titulo="Fix connection issues" href="/en/canais/problemas-de-conexao">Common symptoms and how to fix them.</Artigo>
  <Artigo titulo="Turn on Tino for a channel" href="/en/agentes/tino/ia-por-canal">Set up hours and follow-up for this number.</Artigo>
</Lista>


## Related topics

- [Getting Started with Tartini](/en/primeiros-passos/guias/comecando-com-o-tartini.md)
- [Channels explained](/en/canais/canais-explicados.md)
- [Connect WhatsApp by QR Code](/en/canais/whatsapp-qr-code.md)