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


---

# 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://docs.helena.app/duvidas-e-novidades/faq/conexao-via-qr-code-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.