> For the complete documentation index, see [llms.txt](https://doc.3va.app.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.3va.app.br/conexao-api-oficial-via-qr-code-coexistencia.md).
# Conexão API Oficial via QR Code (Coexistência)
A conexão via **QR Code** na **API Oficial** da **plataforma** é o método utilizado para vincular sua conta de WhatsApp à plataforma de forma segura e eficiente. Esse processo é essencial para garantir a comunicação entre a API e o WhatsApp Business, permitindo o envio e recebimento de mensagens dentro do sistema.
O processo completo envolve duas etapas principais: primeiro, adicionar o número ao portfólio empresarial através do Meta Business Manager e, em seguida, realizar a conexão na plataforma via QR Code.
### Pré-requisitos
Antes de iniciar a conexão via **QR Code**, certifique-se de atender aos seguintes requisitos:
* Ter um número de telefone cadastrado no **WhatsApp Business**.
* Ter um **Portfólio empresarial**.
* Ser um usuário com perfil de **administrador** na **plataforma**.
* Ter a página do **Facebook** atrelada a conta do **WhatsApp Business**.
* Ter acesso ao aplicativo **WhatsApp Business** no celular para receber o **código da Meta** e escanear o **QR Code**.
### Parte 1: Adicionar número ao portfólio empresarial
Antes de conectar o número na plataforma, é necessário adicioná-lo ao seu portfólio empresarial através do Meta Business Manager.
{% stepper %}
{% step %}
### Acesse o site do Meta Business Manager
Acesse o site oficial: e clique em **"Configurações de Negócio"**.
{% endstep %}
{% step %}
### Acesse a Configuração do WhatsApp
No menu lateral esquerdo, localize e clique em **"Contas do WhatsApp"**.
Em seguida, role o cursor da lateral direita até o fim e clique em **"Gerenciador de WhatasApp"**.
{% endstep %}
{% step %}
### Gerenciador do WhatsApp
Uma nova aba será exibida. Clique em **"+Adicionar"**.
{% endstep %}
{% step %}
### Insira o número que deseja conectar
Insira o número que deseja conectar e clique em continuar.
{% endstep %}
{% step %}
### Insira o código de verificação
Em seguida insira o **código** enviado para o **app WhatsApp Business** e clique em continuar.
{% endstep %}
{% step %}
### Finalize a adição ao portfólio
Uma janela surgirá informando que a conta de **WhatsApp Business** foi adicionada ao seu portfólio empresarial. Clique em **"Concluir"**.
{% endstep %}
{% step %}
### Verificação
Após a finalização do processo a tela apresentará os seguintes dados.
{% endstep %}
{% endstepper %}
### Parte 2: Conectar na plataforma via QR Code
Após adicionar o número ao portfólio empresarial, siga os passos abaixo para conectar na plataforma.
{% stepper %}
{% step %}
### Acesse a Integração do WhatsApp
No menu principal da **plataforma**, clique em **"Ajustes"**. Em seguida, acesse **"Conta"**.
{% endstep %}
{% step %}
### Acesse "Canais de Atendimento"
Em seguida clique em **“Canais de Atendimento”** e por fim no ícone **“”**.
{% endstep %}
{% step %}
### Gerar o QR Code
Dentro da seção de **“Canais de Atendimento”**, clique em **"WhatsApp QR Code"** e **“Cloud Meta (QRCode)”**.
{% endstep %}
{% step %}
### Entrar com Facebook
Clique em **“Entrar com Facebook”**.
{% endstep %}
{% step %}
### Faça login com sua conta Facebook
{% endstep %}
{% step %}
### Selecione o Portfólio empresarial
Selecione o **“Portfólio empresarial”** e confira os **dados da empresa** (nome, site e país), em seguida clique em **“Avançar”**.
{% endstep %}
{% step %}
### Selecione sua configuração
Marque a opção **"Conecte seu app WhatsApp Business"** existente e clique em **“Avançar”**.
{% endstep %}
{% step %}
### Informe o número
Informe o número do País (**BR+55**) e insira o número que deseja conectar.
{% endstep %}
{% step %}
### Insira o código recebido
A meta enviará um código para o **aplicativo do WhatsApp**. Insira o código recebido e clique em **“Avançar”**.
{% endstep %}
{% step %}
### Confirme o Display name e o fuso horário
Confirme o **Display name** e o **fuso horário** e, em seguida, clique em **“Avançar”**.
{% endstep %}
{% step %}
### Conexão com a hunion
Clique em **“continuar”** para seguir com a conexão.
{% endstep %}
{% step %}
### Leitura do QR Code
Chegará uma mensagem no **App do WhatsApp Business** para que você faça a leitura do **QR Code**.
{% endstep %}
{% step %}
### Clique na mensagem recebida
Clique na mensagem recebida e leia o **QR Code**.
{% endstep %}
{% step %}
### Adicionar forma de pagamento
Clique em [**adicionar forma de pagamento**](/atalhos/comece-aqui/pagamentos/configurar-pagamento.md) em seguida clique em **"Continuar"**.
{% endstep %}
{% step %}
### Finalizar a conexão
Para finalizar a conexão, selecione o número que está integrando e em seguida clique em **“Continuar”**.
{% endstep %}
{% step %}
### Concluir
Clique em **“Finalizar”** para concluir o processo.
{% endstep %}
{% endstepper %}
### Considerações finais
* **Nem todos os números são elegíveis para conexão.** A **Meta** avalia o histórico de uso do número antes de permitir a vinculação à API Oficial. Caso o número não seja elegível, uma mensagem de aviso será exibida durante o processo de conexão, e o cliente deverá utilizar a conexão padrão.
* **O WhatsApp Desktop para Windows não será compatível após a migração.** As mensagens enviadas e recebidas pelo WhatsApp Desktop deixarão de funcionar.
* **Neste momento, a sincronização de contatos, números e conversas ainda não está disponível.**
* Algumas funcionalidades, como **Canais, Status, enquetes, eventos e localização em tempo real**, não são suportadas na **API Oficial**, porém ainda é possível continuar utilizando no APP.
* **O uso de modelos de mensagem e a janela de conversa/cobrança continuam seguindo as regras da API Oficial**, mas há a possibilidade de abrir a janela diretamente pelo app sem a necessidade de usar mensagens modelo.
* Após **reiniciar a conversa** com um contato pelo App, é necessário esperar o mesmo responder para continuar a conversa pela plataforma.
* O aplicativo **WhatsApp Business** deve ser utilizado pelo menos uma vez a cada **15 dias**.
* **É possível vincular e desvincular o número a qualquer momento.**
### O que altera no app WhatsApp Business
* **Não será possível** criar novas Listas de Transmissão, as listas de transmissão existentes se tornarão somente leitura.
* Todos os outros dispositivos como **WhatsApp Web** serão desconectados, mas poderão ser reconectados após o vínculo.
* Após o vínculo, **não será possível mais editar e excluir mensagens**.
* Mensagens que desaparecem e visualização única **não poderão** ser mais usadas.
**Documentação:** [clique aqui](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users).
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://doc.3va.app.br/conexao-api-oficial-via-qr-code-coexistencia.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.