# Guia de Conexão: API do WhatsApp (Método QR)

Este método híbrido permite conectar um número do WhatsApp Business usando tanto elementos da conexão oficial via API quanto o vínculo por meio de código QR. É uma alternativa rápida e flexível quando é necessário conectar um número sem concluir todo o processo de verificação por SMS.

Ao finalizar este processo, seu número ficará ativo dentro da Vambe e você poderá associá-lo a um funil para que a inteligência artificial gerencie as mensagens recebidas.

#### Pré-requisitos

Antes de iniciar, certifique-se de ter o seguinte:

* Um telefone com o app **WhatsApp Business** instalado (não é compatível com o WhatsApp pessoal).

<img src="/files/e64ce4a9b959e7752adecae0f439337fa2a9458b" alt="" width="375">

* Acesso a um **Portfólio Comercial** da Meta.
* [Ter o **Portfólio Comercial** do Meta Verified](https://academy.vambe.ai/c%C3%B3mo-verificar-tu-negocio-business-manager-en-meta)
* Um **conta comercial do Facebook** com permissões para criar ou administrar contas do WhatsApp Business.

{% hint style="danger" %}
Ao ativar o WhatsApp Dual, a Vambe tentará **conectar automaticamente sua linha de crédito** como método de pagamento para as campanhas e o envio de templates. (Para consultar os preços, você pode acessar *Tarifas de mensagens* em: <https://business.whatsapp.com/products/platform-pricing?lang=es_LA>).

A Vambe, como **Meta Business Partner**, aplica uma **comissão de 10%** pela gestão e uso desta linha de crédito. A cobrança total correspondente ao consumo de campanhas e templates da Meta será realizada por meio da Vambe no início de cada mês.

**Para consultar o consumo desta linha de crédito, você pode verificar em:** <https://business.facebook.com/billing_hub/credit_lines><br>

Para **desativar a linha de crédito**, é preciso **contatar o suporte** pelos canais oficiais
{% endhint %}

#### Parte 1: Configuração inicial na Meta

Antes de entrar na Vambe, precisamos deixar o número "pré-registrado" na plataforma da Meta.

1. Acesse seu **Meta Business Suite.**
2. No menu à esquerda, vá em Configurações (Settings).
3. Procure a seção Contas do WhatsApp.\ <br>

   <figure><img src="/files/b3bb8ac775bebd3c6b5226b0dd7b44c60dff5f3f" alt=""><figcaption></figcaption></figure>
4. Clique em **Adicionar** > Vincule uma conta do WhatsApp Business.\ <br>

   <figure><img src="/files/7dcd7c37f67b66964b19b56838c8872d15f81b10" alt="" width="563"><figcaption></figcaption></figure>
5. **Verificação**: Insira seu número de telefone. A Meta enviará um código por SMS ou Ligação. Digite-o para confirmar que o número é seu.<br>

   <figure><img src="/files/93a4bc305b2aa5725f3179f97d4b56c6b5532da7" alt="" width="563"><figcaption></figcaption></figure>
6. Depois de verificado e criado dentro da **Meta**, clique em **Pronto**.

{% hint style="warning" %}
Observação: Somente quando o número existir aqui, você poderá passar para a Parte 2 na Vambe.
{% endhint %}

***

#### Parte 2: Iniciar a conexão pela Vambe

Agora que o número já existe no seu portfólio, vamos conectá-lo à inteligência artificial.<br>

1. Acesse a Vambe e vá ao menu lateral [Canais](/canal/canal-pt-br/conexao-de-canais-da-vambe/como-ingresar-a-la-seccion-de-conexion-de-canales.md).
2. Clique no botão azul + Adicionar canal (no canto inferior esquerdo).
3. Selecione a opção WhatsApp API (Recomendado).<br>

   <figure><img src="/files/207ae3ea88de977ceef0e4cc8b91d57b17a93254" alt=""><figcaption></figcaption></figure>
4. Será aberta uma janela pop-up. Clique em **Registrar número de telefone**.

   <figure><img src="/files/db89b88fb67b0bea0cec7efadeb69acccf7e2ac6" alt=""><figcaption></figcaption></figure>
5. **Fazer login** com sua conta do Facebook/Meta (a mesma onde você fez a Parte 1).
6. Ela perguntará se você quer conectar sua conta com "Vambe AI Main". Clique em Continuar e depois em Começar.\ <br>

   <figure><img src="/files/1ca7d2db4dc8a5330ee49896620984027c5a5215" alt="" width="338"><figcaption></figcaption></figure>

***

#### Parte 3: Seleção de ativos

O sistema vai guiá-lo por três seleções rápidas para encontrar o número que você criou na Parte 1:

1. **Portfólio Comercial:** Selecione a empresa correta
2. Conta do WhatsApp: Selecione "**Conecte um app do WhatsApp Business"**.\ <br>

   <figure><img src="/files/72733f136475ff2f550d497bf4737fc7f0bf3bcc" alt="" width="334"><figcaption></figcaption></figure>
3. **Número de telefone:**

   * Ao chegar a este passo, selecione Adicionar um novo número do WhatsApp e você deve inserir o mesmo número que inseriu antes.

     <figure><img src="/files/451cb75dae521b10e599349289594d1e5f5ba6fd" alt="" width="375"><figcaption></figcaption></figure>
   * Depois de clicar em seguinte, você verá uma lista. Selecione o número que você registrou anteriormente (deverá aparecer marcado como "**Registrado**").<br>

   <figure><img src="/files/2b314ddb1dec0c3b6e485e6738e623d4cf459295" alt="" width="375"><figcaption></figcaption></figure>

   \
   Para finalizar, clique em **Próximo**

***

#### Parte 4: Escanear o código QR e confirmar

<figure><img src="/files/e8b4b99f700c56d3b59a4186bc23edfa882d0fa4" alt="" width="287"><figcaption></figcaption></figure>

A Meta mostrará um código QR na tela. Nesse momento, a conexão é validada fisicamente com seu celular.

Passos no telefone: No seu telefone, abra o WhatsApp Business e siga exatamente este caminho:

1. Vá para Configurações (ou Menu no Android).
2. Selecione Dispositivos vinculados.
3. Toque em Vincular um dispositivo.
4. Escaneie o código QR que aparece na tela do seu computador.

{% hint style="danger" %}
***Erro muito comum:** Não escanear o QR com a câmera principal do aplicativo. Isso sempre deve ser feito pelo menu "Dispositivos Vinculados" do WhatsApp Business.*
{% endhint %}

O processo de conexão pode levar alguns segundos. Você verá no telefone que uma sessão foi vinculada (geralmente com o nome da empresa ou da Meta).

***

#### Parte 5: Finalizar configuração

De volta ao navegador do seu computador:

1. A tela será atualizada sozinha após a leitura.
2. Nome e Fuso Horário: Confirme o nome da empresa e selecione o fuso horário correto (Ex.: GMT-03:00 America/Santiago).
3. Clique em Próximo.
4. Permissões: A Meta mostrará um resumo do que será compartilhado com a Vambe (gerenciar conversas, eventos etc.). Clique em Confirmar.
5. Você verá o status "Conectando à sua conta...". Quando terminar, clique em Finalizar.

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

***

#### Parte 6: Verificação final

Pronto! O número foi conectado oficialmente.

Para garantir que a IA responda, você deve fazer uma última verificação: 👉 [\[Verifique aqui se o número está associado ao funil correto\]](/canal/canal-pt-br/conexao-de-canais-da-vambe/verificar-que-el-numero-este-asociado-al-embudo-correcto.md)


---

# 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://academy.vambe.ai/canal/canal-pt-br/conexao-de-canais-da-vambe/guia-de-conexion-whatsapp-api-metodo-qr.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.