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


---

# 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://ajuda.hotmobile.com.br/whatsapp/integracao-whatsapp-oficial-api-cloud.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.