> For the complete documentation index, see [llms.txt](https://docs.helena.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helena.app/duvidas-e-novidades/faq/conexao-via-qr-code-api-oficial.md).

# Conexão via QR Code API Oficial

A conexão via **QR Code** na **API Oficial** da **HelenaCRM** é 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.

{% 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 **HelenaCRM**.
* Ter a página do **Facebook** atrelada a conta do **WhatsApp Business**.
* Ter acesso ao aplicativo **WhatsApp Business** no celular para escanear o **QR Code**.
  {% endhint %}

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

<figure><img src="/files/ytOqw0QFcLdudK8uP7ct" alt=""><figcaption></figcaption></figure>

**Passo 2:** Em seguida clique em **“Canais de Atendimento”** e por fim no **ícone “** ![](/files/FAgUzjTNeaOS2Thq8rnY)**”.**

![](/files/49B7AYN9bZ7pmO7Z0FaA)

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

![](/files/iYxII9OBFTecBCLSTAbz)

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

![](/files/f2q0HbkwRjlOSoRwGpAj)

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

![](/files/I3HftxqNl26B019fdUJh) ![](/files/pD1cQMgNahz0T42nWsMw)

**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="/files/8zTi2lJWweoHRIvAYTfA" 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**”.

<img src="/files/1NDWWD9vTNkR51uHBs26" alt="" width="345">

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

<img src="/files/x8pWIzfiWBjCZGCAI11u" alt="" width="335">

**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="/files/NNgl5fPRgzeLcDYvAx23" alt=""></div>

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

<img src="/files/UD21Vy5n2VMsNKX5ZwfG" alt="" width="344">

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

<img src="/files/1dFWWjcPPhcxaUH4NeRc" alt="" width="344">

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

<img src="/files/xu5q818kMaNGmYrbGofn" alt="" width="288">

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

<img src="/files/GzlEfhByiUaSO5fPtrzj" alt="" width="341">

**Passo 14:** Clique em [**adicionar forma de pagamento** ](https://docs.helena.app/~/changes/180/atalhos/faq/configurar-forma-de-pagamento-padrao)em seguida clique em **“Continuar”**.

<img src="/files/gcOCWR2U5ipVuhQtiX1d" alt="" width="341">

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

<figure><img src="/files/zXdpewKJTlxrYZawCrCs" alt=""><figcaption></figcaption></figure>

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

![](/files/17MYhx46bDcZz7HHrNaG)

**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.
* **Atualmente, o WhatsApp Desktop para Windows não é compatível com** a Cloud AP&#x49;**.** 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 não são suportadas na API Oficial, como **Canais, Status, Grupos, enquetes, eventos e localização em tempo real**.
* **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.
* 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)**.**