> For the complete documentation index, see [llms.txt](https://ajuda.hotmobile.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.hotmobile.com.br/whatsapp/integracao-whatsapp-oficial-api-cloud.md).

# 🚀 Integração WhatsApp Oficial (API Cloud)

A integração via WhatsApp Oficial (API Cloud) oferece maior estabilidade, segurança e conformidade com as políticas da Meta. Diferente das conexões via QR Code, a API oficial permite o envio de mensagens em massa com modelos aprovados (Templates), garantindo uma entrega profissional e reduzindo riscos de banimento.

### 1. Acessando o Painel de Conexões

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

Para iniciar, navegue pelo menu superior do painel Hotmobile.

* Caminho: `WhatsApp` > `Whats Oficial Conexão`.
* Nesta tela, você terá a visão geral de todos os números oficiais integrados à sua conta, o status de conexão e a lista de templates vinculados a cada número.

### 2. Criando uma Nova Conexão com a Meta

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

Para vincular um novo número, clique no botão "Nova Conexão".

* Um pop-up do Facebook será aberto para que você realize o login e selecione a conta empresarial (Business Manager) desejada.
* Siga as instruções da Meta para autorizar a Hotmobile a gerenciar suas mensagens e templates. Este processo é rápido e garante que seu número esteja autenticado diretamente nos servidores da Meta.

<figure><img src="/files/06L8NIMzvNIGhW7osEOa" alt=""><figcaption></figcaption></figure>

### 3. Sincronização de Templates

Os Templates (Modelos de Mensagem) são mensagens pré-aprovadas pela Meta para iniciar conversas com seus clientes.

* Após a aprovação de novos modelos no Gerenciador de Negócios, clique em "Sincronizar Templates" para que eles fiquem disponíveis no painel.
* Você poderá visualizar o ID, Nome, Categoria (Ex: UTILITY) e o status atual de cada um. Certifique-se de que o status esteja como "Aprovado" antes de realizar o envio.

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

### 4. Preparando o Arquivo de Envio

Para realizar disparos em massa, você deve utilizar um arquivo CSV ou Excel.

* O sistema disponibiliza modelos para download, garantindo que a importação ocorra sem erros.
* O painel exibirá uma prévia dos dados importados (Nome, Número, E-mail, etc.), permitindo que você valide as informações antes de prosseguir.

<figure><img src="/files/6eg2eCDkYXNI5LE7bNIF" alt=""><figcaption></figcaption></figure>

### 5. Envio de Mensagem Personalizada

Esta é a tela final para configurar sua campanha.

* Agendamento: Defina data e hora para o envio ou dispare imediatamente.
* Seleção de Template: Escolha o modelo aprovado que deseja utilizar.
* Mapeamento de Parâmetros: Relacione as colunas do seu arquivo (Ex: Coluna 2 para Nome, Coluna 3 para Horário) com as variáveis `{{1}}`, `{{2}}` do seu template.
* Visualização: O campo "Corpo da Mensagem" mostrará como o texto ficará estruturado com os parâmetros dinâmicos.

***

{% embed url="<https://youtu.be/l1eYm-458ZQ>" %}

#### Dicas para um bom uso:

* Saldo: Verifique sempre seu saldo de mensagens oficiais antes de iniciar um grande envio.
* Regras da Meta: Utilize templates da categoria correta (Marketing, Utilidade ou Autenticação) para evitar reprovações.