> 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/como-conectar-whatsapp-api-oficial.md). # Como conectar WhatsApp API (oficial) Conexão estável e oficial. Aprenda o novo método passo a passo para conectar seu WhatsApp Business API: primeiro registrando o número na Meta e depois vinculando-o na Vambe por meio de código QR. ## Como conectar a API do WhatsApp (oficial) Neste 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. Este 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 contar com: * Um número de telefone que possa receber **SMS ou chamadas**. * Um número que **não esteja vinculado atualmente a nenhuma conta do WhatsApp**. * Um **portfólio comercial ativo na Meta/Facebook** (o mesmo usado para administrar anúncios). * Ter a conta da Meta verificada *** {% stepper %} {% step %} **Iniciar a conexão pelo Vambe** * Acesse a seção de conexão de canais: * Selecionar **WhatsApp API (oficial)**. * Clique em **Registrar número de telefone**.
![image.png](https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/VvQfmKEpzGApiQfzwGmp/fb358cb463384708952837e4791263c5ed4e35c26b1c494589e5e8079aca337a) 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. ![](https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/dxkj3CjWjDcTverYFY5H/image%20png%20Nov%2027%202025%2003%2036%2056%203610%20PM.png) * 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, estão conectados com sua conta pessoal, o que impede o acesso ao portfólio comercial. Você deve se certificar de estar na conta que administra seu portfólio comercial. {% endhint %} * Uma vez confirmado, clique em **Continuar**. {% endstep %} {% step %} **Selecionar o portfólio e criar a conta do WhatsApp Business** ![](https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/6zE96kRmqQ5TF2cmmyZ0/image%20png%20Nov%2027%202025%2003%2037%2048%206118%20PM.png) * A Meta mostrará os **portfólios comerciais** associados à sua conta. Selecione o portfólio correto. * Selecione sua **conta do WhatsApp Business** existente. * Se você não tiver uma, selecione **Criar uma conta do WhatsApp Business**. * Clique em **Avançar**. {% endstep %} {% step %} **Inserir as informações comerciais (somente se você selecionou "Criar uma conta do WhatsApp Business")** ![](https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/m5bezygbm0zOfCqznK2y/image%20png%20Nov%2027%202025%2003%2039%2020%206970%20PM.png) A Meta solicitará os dados principais da empresa associados ao número do WhatsApp API. Você deve preencher: * Nome da empresa * Categoria do negócio * País * Site * Fuso horário Uma vez concluído, clique em **Avançar**. {% endstep %} {% step %} **Adicionar o número de telefone** ![](https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/INLXHc8y5NJjfD0xghg9/image%20png%20Nov%2027%202025%2003%2039%2057%206863%20PM.png) * Clique em **Adicionar novo número de telefone**. * Insira o **número que você deseja conectar** à API do WhatsApp. {% endstep %} {% step %} **Verificação do número** ![](https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/dEHxyNavn5iGri7Ir3Pz/image%20png%20Nov%2027%202025%2003%2040%2050%208421%20PM.png) 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á utilizado **duas vezes**: primeiro na Meta e depois no Vambe. * Selecionar o método de verificação. * Inserir o código recebido. * Clique em **Avançar**. {% endstep %} {% step %} **Finalizar a verificação na Meta** ![](https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/S0aZxRoeebtyVNAHIAsi/image%20png%20Dec%2012%202025%2012%2037%2057%202845%20PM.png) Uma vez verificado o número: * Clique em **Continuar**. * A Meta configurará automaticamente o número dentro do portfólio. * Quando o processo terminar, clique em **Concluir**. A Meta redirecionará você automaticamente para a aba do Vambe. {% endstep %} {% step %} **Concluir a conexão dentro do Vambe** ![](https://content.gitbook.com/content/CFdmz6HrosBiYP1q1BJ6/blobs/oH4AaRuQLPCOKxxM4oz8/Captura%20de%20pantalla%202025%2012%2004%20a%20la\(s\)%204%2046%2044%E2%80%AFp%20m%20%20png.png) Ao retornar ao 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**. * Selecionar o **funil** ao qual você deseja associar o número. * Clique em **Concluir**. {% endstep %} {% step %} **Verificar se o número está associado ao funil correto** Consulte o guia de verificação [aqui](https://academy.vambe.ai/canal/conexion-de-canales-de-vambe/verificar-que-el-numero-este-asociado-al-embudo-correcto) {% endstep %} {% step %} **Conexão concluída** Depois dessas etapas: * O número fica oficialmente conectado ao Vambe. * O canal aparecerá 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 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/como-conectar-whatsapp-api-oficial.md?ask=&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.