# 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.

{% hint style="success" %}
**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**.
  {% endhint %}

## 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.

**Passo 1: Acesse o site do Meta Business Manager**

Acesse o site oficial:[ https://business.facebook.com/](https://business.facebook.com/) e clique em **"Configurações de Negócio"**.

<figure><img src="https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-1d19d3aa6693af9d2909d4c2b26a03e382612191%2F0%20(42).png?alt=media" alt=""><figcaption></figcaption></figure>

**Passo 2: 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**".

<figure><img src="https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-beb41b0745abc996cd531d9749595690dbb82de4%2F1%20(46).png?alt=media" alt=""><figcaption></figcaption></figure>

**Passo 3: Gerenciador do WhatsApp**

Uma nova aba será exibida. Clique em **"+Adicionar"**.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-22f8f0eb1716faae09425db046bc87847dd0283d%2F2%20\(54\).png?alt=media)

**Passo 4: Insira o número que deseja conectar**

Insira o número que deseja conectar e clique em continuar.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-37c7acf8462334b38d36c00e705890296e0ae4ba%2F3%20\(49\).png?alt=media)

**Passo 5: Insira o código de verificação**

Em seguida insira o **código** enviado para o **app WhatsApp Business** e clique em continuar.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-344b42e316f0bb1bfeabb8bb5272bea653439348%2F4%20\(37\).png?alt=media)

**Passo 6: 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"**.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-ff74f045df2a4cf6e17d6f13d19570674b977b0a%2F5%20\(24\).png?alt=media)

**Passo 7: Verificação**

Após a finalização do processo a tela apresentará os seguintes dados.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-c39c53c40c403bcef3c9bbaa134b321e87cff31a%2F6%20\(16\).png?alt=media)

## 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.

**Passo 1: Acesse a Integração do WhatsApp:** No menu principal da **plataforma**, clique em **"Ajustes"**. Em seguida, acesse **"Conta"**

<figure><img src="https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-091afd19e9225883353da285a88c9d309e8566f7%2F0%20(52).png?alt=media" alt=""><figcaption></figcaption></figure>

**Passo 2:** Em seguida clique em **“Canais de Atendimento”** e por fim no **ícone “** ![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-78c8eed7149ee89c0314d206d735469c36de58a0%2Fimage%20\(35\).png?alt=media)**”.**

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-e9922c8bf235401627385b0326cb1de1d1bcaa44%2F1%20\(56\).png?alt=media)

**Passo 3:** **Gerar o QR Code:** Dentro da seção de **“Canais de Atendimento”**, clique em **"WhatsApp QR Code" e “Cloud Meta (QRCode)”**.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-a48c482ef83629acd1a6e149ca26fb8003c5a76f%2F2%20\(53\).png?alt=media)

**Passo 4:** Clique em **“Entrar com Facebook”.**

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-09172d9293d6bdfad21e8510bd57805cb14c7fc7%2F3%20\(48\).png?alt=media)

**Passo 5:** Faça login com sua conta **Facebook.**

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-ad1202457645c6e2034acb64592ee55a0bb7ae0c%2F4%20\(36\).png?alt=media) ![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-828e5af60526553b72b62bfc98405f52cc3b9f3f%2F5%20\(23\).png?alt=media)

**Passo 6:** Selecione o “**Portfólio empresarial ”** e confira os **dados da empresa** (nome, site e país), em seguida clique em **“Avançar”**.

<figure><img src="https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-923e7e6d55bf6b1f40d2afaf88a9292fb3ec181f%2F6%20(15).png?alt=media" alt="" width="345"><figcaption></figcaption></figure>

**Passo 7:** Selecione sua configuração. Marque a opção "**Conecte seu app WhatsApp Business”** existente e clique em **“Avançar**”.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-4297f1abc41b68d8f9f2dd93bb9bfd7a83ae36ff%2F7%20\(12\).png?alt=media)

**Passo 8:** Informe o número do País (BR+55) e insira o número que deseja conectar.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-44c2a54125861efb8ebb9378de53b0817bccae3d%2F8%20\(9\).png?alt=media)

**Passo 9:** A meta enviará um código para o “**aplicativo do WhatsApp”**. Insira o código recebido e clique em “**Avançar”**.

<div data-full-width="true"><img src="https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-1cf5ee0ac2b402322f17bac6b2378c385c211fcb%2F9%20(8).png?alt=media" alt=""></div>

**Passo 10:** Confirme o **Display name** e o **fuso horário** em seguida clique em **“Avançar”**.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-cd5b76c2e7454cb05595298a4c4a2e0a4145e80c%2F10%20\(6\).png?alt=media)

**Passo 11:** Conexão com a hunion. Clique em **“continuar”** para seguir com a conexão.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-9030bef828e87cfd69693c3838e9d97453c70dbb%2F11%20\(5\).png?alt=media)

**Passo 12:** Leitura do **QR Code**. Chegará uma mensagem no **App do WhatsApp Business** para que você faça a leitura do **QR Code**.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-09a30d571a5477537cba39d1c37907089e7f5d82%2F12%20\(6\).png?alt=media)

**Passo 13:** Clique na mensagem recebida e leia o **QR Code**.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-61ae236069544d2f53b247a6a2e81a9db61e941e%2F13%20\(4\).png?alt=media)

**Passo 14:** Clique em [**adicionar forma de pagamento**](https://docs.flw.chat/guide/atalhos/faq/pagamentos/configurar-pagamento) em seguida clique em **"Continuar"**.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-e766d59cf3b39335503623f559dc9928ddae5717%2F14%20\(4\).png?alt=media)

**Passo 15:** Para finalizar a conexão, selecione o número que está integrando e em seguida clique em **“Continuar”.**

<figure><img src="https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-60306e9f7d9352bfa61dacb447a8f39ce3a4b8a1%2F15%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

**Passo 16:** Clique em **“Finalizar”** para concluir o processo.

![](https://3968359699-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0XQAa61DIC97kqwpbOKn%2Fuploads%2Fgit-blob-69d219417784912870f272ef47726ec824f9dcf6%2F16%20\(2\).png?alt=media)

**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 s**erão desconectados, mas poderão ser reconectados após o vínculo;
* Após o víncul&#x6F;**, 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)**.**
