> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/canal/canal-pt-br/conexao-de-canais-da-vambe/guia-de-conexion-whatsapp-api-metodo-qr.md).

# Guia de Conexão: WhatsApp API (Método QR - Coexistência Dual)

Método Oficial. Aprenda a conectar seu WhatsApp Business API com o novo fluxo de segurança: primeiro registrando o número na Meta e depois vinculando-o por meio de Código QR na Vambe.

## Guia de Conexão: WhatsApp API (Método QR - Coexistência Dupla)

Este método híbrido permite conectar um número do WhatsApp Business utilizando tanto elementos da conexão oficial por API quanto o vínculo por código QR. É uma alternativa rápida e flexível quando é necessário conectar um número sem concluir o processo completo 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 do **WhatsApp Business** instalado (não é compatível com o WhatsApp pessoal).

<img src="https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/QuVHU0Oz1pxLh80m9eLj/WhatsApp%20Image%202025%2012%2012%20at%209%2058%2059%20AM%20jpeg.jpeg" alt="" width="375">

* Acesso a um **Business Portfolio** da Meta.
* [Ter o **Business Portfolio** Meta Verificado](https://academy.vambe.ai/canal/configuracion-en-meta/como-verificar-tu-negocio-business-manager-en-meta)
* Um **conta de Facebook Business** 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**, deve **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 o seu **Meta Business Suite.**
2. No menu da esquerda, vá para Configurações (Settings).
3. Procure a seção Contas do WhatsApp.\ <br>

   <figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2FkwSkjLk8kpwqITy4pl1p%2Fimage.png?alt=media&#x26;token=9755e71c-e11d-418e-9431-1f3234ebdef5" alt=""><figcaption></figcaption></figure>
4. Clique em **Adicionar** > Vincule uma conta do WhatsApp Business.\ <br>

   <figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2F4o3vy2zJOtaDYTFHp8yJ%2Fimage.png?alt=media&#x26;token=fa0e0213-0de0-4e2d-82fa-7428a9f1f348" 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. Insira-o para confirmar que o número é seu.<br>

   <figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2FUveOLZaIzkGjN72pIUQA%2Fimage.png?alt=media&#x26;token=b7841364-cbbf-497d-aa62-505f63e89a8b" alt="" width="563"><figcaption></figcaption></figure>
6. Uma vez 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á para o menu lateral Canais.
2. Clique no botão azul + Adicionar canal (no canto inferior esquerdo).
3. Selecione a opção WhatsApp API (Recomendado).<br>

   <figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2FjwvmYtjdQtQHGQC2Fejj%2FCaptura%20de%20pantalla%202026-02-17%20a%20la(s)%203.30.31%E2%80%AFp.m..png?alt=media&#x26;token=f3317ba0-0476-46de-803d-205d09ed1040" alt=""><figcaption></figcaption></figure>
4. Escolher se queremos conectar um **WhatsApp Business existente** ou se você tem um **chip novo**\ <br>

   <figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2F3OSypZDLdORgJJHiAqlT%2Fimage.png?alt=media&#x26;token=f658ae9f-994e-4dc4-bd67-6d970a70f37a" alt=""><figcaption></figcaption></figure>
5. **Faça login** com sua conta do Facebook/Meta (a mesma em que você fez a Parte 1).
6. Ele perguntará se você quer conectar sua conta com "Vambe AI Main". Clique em Continuar e depois em Começar.\ <br>

   <figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2FQ8vzT35AKkLwJru9ZbEf%2Fimage.png?alt=media&#x26;token=351a6d7a-c7c7-49d8-8e6e-fcd427bfbc3c" alt="" width="338"><figcaption></figcaption></figure>

***

**Parte 3: Seleção de Ativos**

O sistema irá 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="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2FZB3Dk4lMMK13w6Xdtsm2%2Fimage.png?alt=media&#x26;token=3a2bf215-18f6-474b-907a-2fb4fac40d99" alt="" width="334"><figcaption></figcaption></figure>
3. **Número de Telefone:**

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

     <figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2F3Kn2ae6OHuaHLexd63rq%2Fimage.png?alt=media&#x26;token=66b33149-d0b8-4872-93cc-2e3241fdd44f" alt="" width="375"><figcaption></figcaption></figure>
   * Assim que você clicar em avançar verá uma lista. Selecione o número que registrou anteriormente (deve aparecer marcado como "**Registrado**").<br>

   <figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2FQ7hTpPd0JfboWVajflDo%2Fimage.png?alt=media&#x26;token=55edba17-5ecf-4a34-8fa4-c04aa5be8cb9" alt="" width="375"><figcaption></figcaption></figure>

   \
   Para finalizar clique em **avançar**

***

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

<figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2F5qZV5k3SNbyZn0jGNt94%2Fimage.png?alt=media&#x26;token=7da6859d-b59c-4484-a7c4-90366d1ff66e" alt="" width="287"><figcaption></figcaption></figure>

A Meta exibirá um código QR na tela. Neste ponto, a conexão é validada fisicamente com o 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 app. Isso sempre deve ser feito a partir do 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 o escaneamento.
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 Avançar.
4. Permissões: a Meta mostrará um resumo do que será compartilhado com a Vambe (administrar conversas, eventos, etc.). Clique em Confirmar.
5. Você verá o status "Conectando à sua conta...". Quando finalizar, clique em Concluir.

<figure><img src="https://502444442-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCFdmz6HrosBiYP1q1BJ6%2Fuploads%2FUCK5mQDzrgShZXWxt0a7%2Fimage.png?alt=media&#x26;token=86de1337-6c81-4f59-a97d-ea0358987c65" 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]


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.vambe.ai/canal/canal-pt-br/conexao-de-canais-da-vambe/guia-de-conexion-whatsapp-api-metodo-qr.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.