# Whatsapp Cloud API (Oficial)

|                   | QR Code (não oficial)                | Cloud API (oficial) ✅                   |
| ----------------- | ------------------------------------ | --------------------------------------- |
| Como funciona     | Escaneia um QR Code com o celular    | Conecta direto pela API oficial da Meta |
| Estabilidade      | Pode cair ou ser bloqueada sem aviso | Estável, com suporte contínuo da Meta   |
| Custo de mensagem | Nenhum                               | Cobrado pela Meta por mensagem enviada  |
| Templates         | Não precisa                          | Obrigatório para iniciar conversas      |
| Recomendação      | Testes ou uso temporário             | **Uso profissional e contínuo**         |

***

### Conexão via QR Code (não oficial)

Essa é a forma mais simples: basta escanear um QR Code com o celular e o número já aparece no CRM.

> :warning: **Atenção:** essa modalidade **não é oficial e não tem suporte da Meta**. A conexão pode ser bloqueada ou descontinuada a qualquer momento, sem aviso prévio e sem recurso. Use com cautela.

[**→ Passo a passo para conectar via QR Code**](https://bolten.gitbook.io/bolten-docs/ativacao-da-marca/conexao-de-whatsapp)

***

### Conexão via WhatsApp Cloud API (oficial) :white\_check\_mark:

Essa é a forma recomendada. A conexão é feita diretamente com a API oficial do WhatsApp, garantindo estabilidade e suporte contínuo.

#### O que você precisa antes de começar

* **Um número cadastrado no Meta Business Manager**\
  O número de WhatsApp precisa estar vinculado a um portfólio no [Meta Business Manager](https://business.facebook.com/). Não basta ser um número comum — ele precisa estar registrado como número de WhatsApp Business API dentro desse portfólio.
* **Verificação de negócio na Meta (recomendado)**\
  Não é obrigatório para começar, mas amplia os limites de envio de mensagem e dá mais credibilidade à conta.
* **Um PIN de 6 dígitos**\
  Durante o registro do número na API, a Meta pede a criação de um PIN de verificação em duas etapas. Esse PIN será solicitado no momento da conexão e também caso você precise migrar ou reativar a conta. **Guarde-o em um lugar seguro.**

***

#### Passo a passo

**1)** Acesse o componente de WhatsApp do seu projeto

**2)** Selecione a opção **"É usuário do WhatsApp Business API? Clique aqui para conectar"**

<figure><img src="/files/C4DLdMroabqb9YYiXpBt" alt=""><figcaption></figcaption></figure>

**3)** Digite o seu PIN de 6 dígitos e clique em **Conectar via Meta**

<figure><img src="/files/TpKCgFEGuYgOGcwsLJkn" alt=""><figcaption></figcaption></figure>

Você será redirecionado para o login da Meta. Entre com a conta que tem acesso ao portfólio onde o número está cadastrado.

**4)** Siga o fluxo da Meta e selecione o número que deseja conectar

<figure><img src="/files/d1qTyTgDlTmudB3TDmox" alt=""><figcaption></figcaption></figure>

**5)** Confirme as informações e clique em **Confirmar**

<figure><img src="/files/sLuit4H2Q6sSFHCU66E2" alt=""><figcaption></figcaption></figure>

**6)** Pronto! :tada: Seu número está conectado via API oficial.

Para testar, envie uma mensagem para o número conectado e veja se ela aparece na tela de conversas do CRM.

> :bulb: **Já usava a conexão via QR Code?** Desconecte o número antigo antes de conectar pela Cloud API. O número só pode estar ativo em um método por vez.

***

#### Depois de conectar: Templates de mensagem

Com a API oficial, você **não pode iniciar uma conversa enviando qualquer mensagem**. Para dar o primeiro contato pelo seu número, é obrigatório usar um **Template** — uma mensagem pré-cadastrada e aprovada pela Meta.

> Se o cliente mandar a primeira mensagem, você pode responder livremente por até **24 horas** sem precisar de template.

**Como funciona na prática:**

**1)** Crie o template dentro da Bolten, definindo um **atalho** (ex: `/boas-vindas`)

<figure><img src="/files/KNCjYJ4yU3rRttj4YB6a" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/AdcNkVXzunPdtENUJhTI" alt=""><figcaption></figcaption></figure>

**2)** A Meta analisa e aprova (ou reprova) o conteúdo — costuma levar algumas horas

<figure><img src="/files/YZnXCLVdZaWtqisCq1KH" alt=""><figcaption></figcaption></figure>

**3)** Após aprovado, use o template digitando `/atalho` na tela de WhatsApp do CRM

<figure><img src="/files/B7bv6UihYxkGWsVTq6Zc" alt=""><figcaption></figcaption></figure>

***

#### Cobrança por mensagens :moneybag:

Ao contrário da conexão via QR Code, a Cloud API tem custos definidos pela Meta. A cobrança é feita **por mensagem enviada**, e os valores variam conforme o país do destinatário e a categoria da mensagem.

Ao conectar sua conta da Meta no CRM, você terá a opção de adicionar uma forma de pagamento na Business Suite:

<figure><img src="/files/bLSE4io8I2kCgzi3B1z6" alt=""><figcaption></figcaption></figure>

#### **Categorias e preços aproximados**

| Categoria               | Tipo de mensagem                    | Exemplo                                | Preço aprox. (USD) |
| ----------------------- | ----------------------------------- | -------------------------------------- | ------------------ |
| :loudspeaker: Marketing | Promoções, campanhas, reengajamento | Cupom, oferta, carrinho abandonado     | \~$0.0625          |
| :package: Utilidade     | Transacional (ação do usuário)      | Confirmação de pedido, entrega, fatura | \~$0.0080          |

> Valores em dólar americano (USD), definidos e cobrados diretamente pela Meta. Consulte a [tabela oficial de preços](https://developers.facebook.com/docs/whatsapp/pricing) para valores atualizados.

**Regras importantes**

| Regra                           | O que significa                                                          |
| ------------------------------- | ------------------------------------------------------------------------ |
| Cobrança por mensagem           | Você paga por template enviado, não por conversa                         |
| Baseado no país do destinatário | O preço depende de onde está quem recebe                                 |
| Janela de 24h                   | Se o cliente iniciar a conversa, suas respostas são grátis nesse período |
| Só paga se entregar             | Cobrança acontece apenas quando a mensagem é efetivamente entregue       |
| Descontos por volume            | Existem faixas de desconto conforme o volume mensal                      |

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bolten.gitbook.io/bolten-docs/ativacao-da-marca/whatsapp-cloud-api-oficial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.