# Como conectar a API do WhatsApp (oficial)

Nesta guia passo a passo, você aprenderá como registrar seu número na Meta, configurar sua conta do WhatsApp Business e, por fim, conectar o canal ao seu funil no Vambe.

Esse processo permite utilizar a integração oficial da API do WhatsApp Business, a única que garante estabilidade e conformidade com as políticas da Meta.

***

#### Pré-requisitos

Antes de começar, certifique-se de ter:

* Um número de telefone que possa receber **SMS ou ligações**.
* Um número que **não esteja vinculado atualmente a nenhuma conta do WhatsApp**.
* Uma **carteira comercial ativa na Meta/Facebook** (a mesma usada para gerenciar anúncios).
* Ter a conta [Meta Verificada](/canal/canal-pt-br/configuracao-na-meta/como-verificar-tu-negocio-business-manager-en-meta.md)

***

{% stepper %}
{% step %}

#### Iniciar a conexão pelo Vambe

* Acesse a seção de conexão de canais: <https://academy.vambe.ai/c%C3%B3mo-ingresar-a-la-secci%C3%B3n-de-conexi%C3%B3n-de-canales>
* Selecionar **WhatsApp API (oficial)**.

![](/files/4e777a12aca2724c5da9a490b3fa08d7b0d11a75)

* Clique em **Registrar número de telefone**.

![image.png](/files/60b75e363fba50298b0c0deb224b40ad463f5c85)

Isso abrirá o processo de conexão diretamente com a Meta.
{% endstep %}

{% step %}

#### Registro do número na Meta

Ao clicar em “Registrar número de telefone” dentro do Vambe, uma nova aba da Meta/Facebook será aberta.

![](/files/ed431233ad6e7e74ba6fc1fd779580a24fd4d568)

* A tela mostrará a mensagem **“Conecte sua conta facilmente ao Vambe”**.
* Verifique no canto superior direito se você está usando a **conta correta do Facebook Business**.

{% hint style="warning" %}
Um erro muito comum é que os usuários, sem perceber, estejam conectados com sua conta pessoal, o que impede o acesso à carteira comercial. Você deve garantir que está na conta que administra sua carteira comercial.
{% endhint %}

* Depois de confirmar, clique em **Continuar**.
  {% endstep %}

{% step %}

#### Selecionar a carteira e criar a conta do WhatsApp Business

![](/files/5e761ff9880c85dc7b414d68759f5f736cf2a185)

* A Meta mostrará as **carteiras comerciais** associadas à sua conta. Selecione a carteira correta.
* Selecione sua **conta do WhatsApp Business** existente.
  * Se você não tiver uma, selecione **Criar uma conta do WhatsApp Business**.
* Clique em **Próximo**.
  {% endstep %}

{% step %}

#### Inserir as informações comerciais (Somente se você selecionou "Criar uma conta do WhatsApp Business")

![](/files/7ca254745d4264db115684dc9c6923bdf6bea845)

A Meta solicitará os principais dados da empresa associados ao número da API do WhatsApp. Você deve preencher:

* Nome da empresa
* Categoria do negócio
* País
* Site
* Fuso horário

Depois de concluir, clique em **Próximo**.
{% endstep %}

{% step %}

#### Adicionar o número de telefone

![](/files/0a6e828f7efb35ec30d9725e25bd4826631e7bcd)

* Clique em **Adicionar novo número de telefone**.
* Inserir o **número que você deseja conectar** à API do WhatsApp.
  {% endstep %}

{% step %}

#### Verificação do número

![](/files/196aecee6f2d403cf80c88b66a9f833d883c6bbf)

A Meta pedirá que você selecione um método de verificação:

* **Mensagem de texto (SMS)**
* **Ligação telefônica**

É fundamental anotar o código exatamente como ele chega (formato XXX XXX). Esse mesmo código será usado **duas vezes**: primeiro na Meta e depois no Vambe.

* Selecionar o método de verificação.
* Inserir o código recebido.
* Clique em **Próximo**.
  {% endstep %}

{% step %}

#### Finalizar a verificação na Meta

![](/files/8f9fbfeef5751bf06fd1a80dc99ccdf70b08505d)

Depois de verificar o número:

* Clique em **Continuar**.
* A Meta configurará automaticamente o número dentro da carteira.
* Quando o processo terminar, clique em **Finalizar**.

A Meta o redirecionará automaticamente para a aba do Vambe.
{% endstep %}

{% step %}

#### Concluir a conexão dentro do Vambe

![](/files/435c8b9799226174f1bdd5ff284d2be443b68f2b)

Ao voltar para o Vambe:

* A plataforma solicitará **novamente o código de verificação XXX XXX**.
* Insira o mesmo código que você recebeu anteriormente.
* Clique em **Verificar**.
* Selecione o **funil** ao qual você deseja associar o número.
* Clique em **Finalizar**.
  {% endstep %}

{% step %}

#### Verificar se o número está associado ao funil correto

Consulte o guia de verificação [aqui](https://academy.vambe.ai/verificar-que-el-n%C3%BAmero-est%C3%A9-asociado-al-embudo-correcto)
{% endstep %}

{% step %}

#### Conexão concluída

Depois dessas etapas:

* O número fica oficialmente conectado ao Vambe.
* O canal ficará disponível na lista de canais.
* O funil selecionado começará a receber todas as mensagens recebidas por meio da API do WhatsApp.
  {% endstep %}
  {% endstepper %}


---

# 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/como-conectar-whatsapp-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.