# Conexão WhatsApp Cloud API

A conexão **WhatsApp Cloud API** da **plataforma** é o método tradicional 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="info" %}
**Pré-requisitos:** Antes de iniciar a conexão **WhatsApp Cloud API**, certifique-se de atender aos seguintes requisitos:

* **Número disponível:** Ter um número de telefone cadastrado no **WhatsApp Business**.
* **Desconexão do Aplicativo:** O número não pode estar conectado ao aplicativo WhatsApp no celular. Se estiver, você deverá desconectar a conta no app antes de finalizar o processo.
* **Portfólio Empresarial:** Ter um Gerenciador de Negócios (Meta Business Suite) configurado.
* **Perfil Administrador:** Ser um usuário com perfil de administrador na plataforma e no Facebook.
* **Recebimento de Código:** Ter acesso ao número para receber o código de verificação via SMS ou Ligação Telefônica.
  {% endhint %}

**Passo 1: Iniciando a Integração**

1. No menu superior da plataforma, clique em Ajustes -> Conta.

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

2. Clique na aba **Canais de Atendimento** e em seguida clique no botão de adição **(+)**, navegue até WhatsApp CloudAPI e selecione Cloud Meta.

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

**Passo 2:** Configuração do Número

1. Selecione a opção Conectar novo número.

{% hint style="warning" %}
**Atenção:** Ao vincular o número na Cloud API, você não poderá mais utilizá-lo no aplicativo do Whatsapp.
{% endhint %}

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

2. Na tela de parceria, clique em Entrar com Facebook para iniciar o onboarding oficial.

![](/files/4HXmGBvgCUIWz8HWwyVA)

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

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

**Passo 3: Autenticação e Dados Empresariais**

1. Realize o login na conta do Facebook que administra seu Gerenciador de Negócios.
2. Selecione o Portfólio empresarial correspondente.
3. Confira os dados da empresa (Nome, Site e País) e clique em Avançar.

**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/z00AvX9fmcqj3S3dUcCj" alt="" width="345"><figcaption></figcaption></figure>

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

![](/files/HDig6PUl5eV6Qd9MoK3A)

**Passo 8:** 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/JNCpZNFzMYzdWxbSaCYO" alt=""></div>

**Passo 9:** Confirme o **Display name** e o **fuso horário** em seguida clique em **"Avançar"**.

![](/files/JOfL5r0Sfftn6Mb1byn9)

#### Validação do Número (Migração)

1. Informe o código do país (BR +55) e insira o número que deseja conectar.
2. Importante: O sistema detectará se o número está ativo em um aparelho. Você precisará confirmar a saída do aplicativo móvel para prosseguir.
3. Escolha o método de recebimento do código de verificação de 6 dígitos: SMS ou Ligação Telefônica.
4. Insira o código recebido para finalizar a criação da sua WABA (WhatsApp Business Account).

**Passo 10:** Recebimento do código de verificação. Uma mensagem será enviada para o **WhatsApp Business** com um código de 6 dígitos.

**Passo 11:** Insira o código de 6 dígitos recebido no WhatsApp Business e clique em **"Verificar"**.

**Passo 12:** Clique em [**adicionar forma de pagamento**](/guide/atalhos/faq/pagamentos/configurar-pagamento.md) em seguida clique em **"Continuar"**.

![](/files/fw10KbwXxtG6GuTgObt9)

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

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

**Passo 14:** Clique em **"Finalizar"** para concluir o processo.

![](/files/WBkLiP1oLl8StR7VY7V3)

**Considerações Finais**

* **Este é o método de conexão recomendado quando o número não é elegível para conexão via QR Code.** A **Meta** avalia o histórico de uso do número e pode determinar que alguns números não são elegíveis para a conexão via QR Code. Caso isso aconteça, você deve utilizar este método (WhatsApp Cloud API).
* **Atualmente, o WhatsApp Desktop para Windows não é compatível com** a Cloud API.\*\* As mensagens enviadas e recebidas pelo WhatsApp Desktop deixarão de funcionar.
* **Neste método, o número precisará ser desconectado do WhatsApp Business App.** Diferente da conexão via QR Code, este método não permite o uso simultâneo do número no app e na API.
* **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 número conectado via método convencional **não pode ser usado simultaneamente no WhatsApp Business App**.

**O que altera no app WhatsApp Business**

* **Não será possível usar o número no WhatsApp Business App enquanto estiver conectado à API.**
* Todos os outros dispositivos como **WhatsApp Web** serão desconectados, mas poderão ser reconectados 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: 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.flw.chat/guide/atalhos/faq/conexao-whatsapp/conexao-whatsapp-cloud-api.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.