# Conexões

# Conexões

O módulo de Conexões é onde você gerencia os números de WhatsApp vinculados ao Apre.Chat. Cada conexão representa um número de WhatsApp ativo que recebe e envia mensagens pela plataforma. Você pode ter múltiplas conexões simultâneas, cada uma com suas configurações independentes.

<span style="white-space: pre-wrap;">O Apre.Chat suporta dois tipos de conexão: via </span>**QR Code (Baileys)**<span style="white-space: pre-wrap;">, que conecta diretamente o número sem custo por mensagem, e via </span>**API Oficial Meta (Business API)**, para números verificados com número de telefone empresarial.

**Rotina:**<span style="white-space: pre-wrap;"> Conexões</span>

#### **1. Navegação no módulo**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/scaled-1680-/Lcdimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/Lcdimage.png)

<span style="white-space: pre-wrap;">Para acessar, clique em </span>**Conexões**<span style="white-space: pre-wrap;"> no menu lateral esquerdo do Apre.Chat.</span>

#### **2. Como funciona**

A tela principal exibe todas as conexões cadastradas. Cada cartão mostra:

- **ID e nome**<span style="white-space: pre-wrap;"> da conexão.</span>
- **Status**<span style="white-space: pre-wrap;"> atual: Conectado, Falha ao iniciar a sessão, Desconectado ou Aguardando QR Code.</span>
- **Número**<span style="white-space: pre-wrap;"> de WhatsApp vinculado (quando disponível).</span>
- **Tipo**<span style="white-space: pre-wrap;"> da conexão: BUSINESS API (API Oficial) ou conexão via QR Code (Baileys).</span>
- **Última Atualização**<span style="white-space: pre-wrap;"> , data e hora da última alteração de status.</span>
- **Desconectado em**<span style="white-space: pre-wrap;"> , data e hora da última desconexão (quando aplicável).</span>

Dois botões de ação estão disponíveis no topo:

- **Adicionar**<span style="white-space: pre-wrap;"> , cria uma nova conexão.</span>
- **Transferir Atendimentos**<span style="white-space: pre-wrap;"> , move atendimentos abertos de uma conexão para outra. Útil quando uma conexão precisa ser desativada.</span>

#### **3. Status das conexões**

<table id="bkmrk-statussignificadoo-q" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 220px;"></col><col></col><col></col></colgroup><tbody><tr><th style="width: 220px; white-space: nowrap;">Status

</th><th>Significado

</th><th>O que fazer

</th></tr><tr style="height: 10px;"><td>Conectado

</td><td>A conexão está ativa e recebendo mensagens normalmente.

</td><td>Nenhuma ação necessária.

</td></tr><tr><td>Aguardando QR Code

</td><td>A conexão Baileys foi iniciada e aguarda leitura do QR Code no WhatsApp do celular.

</td><td>Escaneie o QR Code com o WhatsApp do número correspondente.

</td></tr><tr><td>Falha ao iniciar a sessão

</td><td>A conexão perdeu o vínculo, geralmente porque o WhatsApp foi desconectado manualmente ou o celular ficou sem bateria/internet.

</td><td><span style="white-space: pre-wrap;">Clique em </span>

**Novo QR Code**

<span style="white-space: pre-wrap;"> para gerar um novo código e reconectar.</span>

</td></tr><tr><td>Desconectado

</td><td>A conexão foi desconectada pelo sistema ou pelo usuário.

</td><td><span style="white-space: pre-wrap;">Clique em </span>

**Novo QR Code**

<span style="white-space: pre-wrap;"> (Baileys) ou reconecte via painel Meta (API Oficial).</span>

</td></tr></tbody></table>

#### **4. Tipos de conexão**

<table id="bkmrk-tipodescri%C3%A7%C3%A3obaileys" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 200px;"></col><col></col></colgroup><tbody><tr><th style="width: 200px; white-space: nowrap;">Tipo

</th><th>Descrição

</th></tr><tr><td>Baileys (QR Code)

</td><td>Conexão via QR Code escaneado pelo aplicativo do WhatsApp. Não tem custo por mensagem e funciona com qualquer número pessoal ou empresarial. Requer que o celular com o WhatsApp esteja com bateria e internet. Pode desconectar se o celular ficar muito tempo sem conexão.

</td></tr><tr><td>Business API (Oficial Meta)

</td><td>Conexão via API Oficial da Meta. Utiliza um número de telefone empresarial verificado. Mais estável e não depende de celular físico, mas cobra por mensagem iniciada fora da janela de 24 horas. Exige aprovação de templates para envio ativo.

</td></tr></tbody></table>

<p class="callout info">O Apre.Chat usa o servidor Evolution API para gerenciar as conexões Baileys, oferecendo mais estabilidade do que a conexão direta.</p>

#### **5. Configurações da conexão**

Ao criar ou editar uma conexão, as configurações disponíveis incluem:

<table id="bkmrk-configura%C3%A7%C3%A3odescri%C3%A7%C3%A3" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 220px;"></col><col></col></colgroup><tbody><tr><th style="width: 220px; white-space: nowrap;">Configuração

</th><th>Descrição

</th></tr><tr><td>Nome

</td><td>Identificação da conexão no sistema.

</td></tr><tr><td>Conexão padrão

</td><td>Quando marcada, esta conexão é usada por padrão ao criar novos atendimentos.

</td></tr><tr><td>Ler mensagens

</td><td>Quando ativo, o sistema marca automaticamente as mensagens como lidas após o atendimento.

</td></tr><tr><td>Sempre online

</td><td>Mantém o status do número como "Online" no WhatsApp.

</td></tr><tr><td>Rejeitar chamadas

</td><td>Rejeita automaticamente chamadas recebidas no número e envia uma mensagem de resposta configurável.

</td></tr><tr><td>Ignorar grupos

</td><td>Não cria atendimentos a partir de mensagens recebidas em grupos.

</td></tr><tr><td>Expirar atendimento

</td><td>Fecha automaticamente atendimentos sem interação após o tempo configurado.

</td></tr><tr><td>Chatbot padrão

</td><td>Fluxo de chatbot ativado automaticamente para novos atendimentos nessa conexão.

</td></tr><tr><td>Tipo de recepção

</td><td>Define como os atendimentos são distribuídos: para um setor específico ou para todos os operadores.

</td></tr></tbody></table>

#### **6. Transferindo atendimentos entre conexões**

<span style="white-space: pre-wrap;">Use o botão </span>**Transferir Atendimentos**<span style="white-space: pre-wrap;"> para mover todos os atendimentos abertos de uma conexão para outra. Útil quando uma conexão precisa ser desativada ou substituída por um novo número.</span>

<p class="callout warning">Não é possível excluir uma conexão com atendimentos abertos. Transfira ou encerre os atendimentos antes de remover a conexão.</p>

#### **7. Perguntas frequentes**

**Quantas conexões posso ter?**  
O número máximo de conexões depende do plano contratado. Ao atingir o limite, o sistema bloqueia a criação de novas conexões.

**O que fazer quando a conexão Baileys cai frequentemente?**  
Verifique se o celular com o WhatsApp tem bateria e conexão estável com a internet. Evite usar o mesmo número em múltiplos dispositivos. Considere usar a API oficial para maior estabilidade.

**Posso ter dois números diferentes conectados?**  
Sim. Cada conexão representa um número diferente. Você pode ter quantos números o seu plano permitir.

**A API oficial funciona sem celular?**  
Sim. Conexões via Business API da Meta não dependem de celular físico. A conexão é mantida diretamente com os servidores da Meta.

# Como conectar ao WhatsApp Business API - Apre.chat

O WhatsApp Business API Oficial é a integração que permite utilizar um número oficial do WhatsApp dentro do Apre.chat para atendimentos, automações, notificações e comunicações com clientes. Diferente de conexões informais, este canal é homologado diretamente pela Meta e oferece recursos avançados como envio de mensagens em massa, modelos pré-aprovados e relatórios de entrega.

No dia a dia, essa integração é usada por equipes de atendimento, cobrança e marketing para contatar clientes fora da janela de 24 horas de conversa ativa, seja para enviar boletos, lembretes de vistorias, contratos para assinatura ou campanhas de novos imóveis disponíveis.

O processo envolve duas etapas principais: conectar uma conta Meta ao Apre.chat e criar modelos de mensagem que precisam ser aprovados pela Meta antes do uso. As cobranças pelas conversas são realizadas diretamente pela Meta, não pelo Apre.chat.

**Rotina:**<span style="white-space: pre-wrap;"> Conexões &gt;&gt; Adicionar</span>

<p class="callout info"><span style="white-space: pre-wrap;">Para começar a utilizar a API Oficial, entre em contato com o time da Apresenta.me </span></p>

#### **1. Navegação no módulo**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/scaled-1680-/GpYimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/GpYimage.png)

<span style="white-space: pre-wrap;">Acesse o menu lateral do Apre.chat e clique em </span>**Conexões**. Nessa tela você visualiza todos os canais já cadastrados, com a situação de cada um, e pode adicionar novas conexões.

#### **2. Como funciona**

A tela de Conexões lista todos os canais ativos na sua conta. Cada cartão exibe o nome da conexão, o tipo de canal e a situação atual (conectado, desconectado ou aguardando). A partir daqui você pode conectar novos canais, visualizar o QR Code de reconexão ou desconectar um número existente.

<p class="callout info">Para utilizar o WhatsApp Business API Oficial, você precisará ter acesso a uma conta Meta (Facebook) com permissão de administrador sobre o número que deseja conectar.</p>

#### **3. Conectando a conta Meta ao Apre.chat**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/scaled-1680-/Jl9image.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/Jl9image.png)

Após a conclusão, o número aparecerá como conectado na listagem de Conexões e estará disponível para uso em atendimentos e automações.

#### **4. Configurando a forma de pagamento**

As conversas realizadas pelo WhatsApp Oficial são cobradas diretamente pela Meta. O Apre.chat não realiza nenhuma cobrança por essas mensagens. Para que o canal funcione sem interrupções, é necessário cadastrar uma forma de pagamento no painel da Meta.

1. <span style="white-space: pre-wrap;">Acesse o </span>**WhatsApp Manager**<span style="white-space: pre-wrap;"> no painel da Meta.</span>
2. <span style="white-space: pre-wrap;">Navegue até </span>**Configurações de Pagamento**.
3. Cadastre um cartão de crédito válido.

<p class="callout danger">Sem uma forma de pagamento ativa na Meta, o envio de mensagens pelo canal oficial será bloqueado, mesmo que a conexão apareça como ativa no Apre.chat.</p>

#### **5. O que são modelos de mensagem**

Modelos de mensagem são textos pré-aprovados pela Meta que permitem iniciar uma conversa com um cliente fora da janela de atendimento de 24 horas. Dentro dessa janela, você pode enviar qualquer mensagem livremente. Após esse período, somente modelos aprovados podem ser usados para retomar o contato.

Exemplos de situações que exigem um modelo aprovado:

- Cobranças de aluguel ou boletos em vencimento
- Lembretes de vistoria ou visita agendada
- Avisos de contrato disponível para assinatura
- Atualizações de cadastro
- Campanhas de marketing com novos imóveis

<p class="callout info">Somente modelos com situação "Aprovado" podem ser usados em automações, campanhas e atendimentos.</p>

#### **6. Criando um modelo de mensagem**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/scaled-1680-/dHLimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/dHLimage.png)

<span style="white-space: pre-wrap;">Para criar um novo modelo, acesse </span>**Mensagens Rápidas** <span style="white-space: pre-wrap;">e clique em </span>**Adicionar**<span style="white-space: pre-wrap;">. Em seguida, clique em </span>**Template Meta** e preencha os campos abaixo.

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/scaled-1680-/G8qimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/G8qimage.png)

<table id="bkmrk-campodescri%C3%A7%C3%A3oobriga" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 160px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr><th style="width: 160px; white-space: nowrap;">Campo

</th><th>Descrição

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">Obrigatório

</th></tr><tr><td>Nome do template

</td><td><span style="white-space: pre-wrap;">Identificador interno do modelo. Use apenas letras minúsculas, números e underline. Exemplos: </span>**cobranca\_aluguel**<span style="white-space: pre-wrap;">, </span>**lembrete\_visita**<span style="white-space: pre-wrap;">, </span>**contrato\_assinatura**. Esse nome não aparece para o cliente.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Categoria

</td><td><span style="white-space: pre-wrap;">Define o tipo de comunicação: </span>

- **Marketing**<span style="white-space: pre-wrap;">: (campanhas e divulgação de imóveis), </span>
- **Utilidade**<span style="white-space: pre-wrap;">: (cobranças, lembretes, contratos), </span>
- **Autenticação**: (códigos de verificação). A escolha errada pode resultar em reprovação pela Meta.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Conteúdo

</td><td><span style="white-space: pre-wrap;">Texto da mensagem que será enviada ao cliente. Use variáveis no formato </span>

**{{1}}**<span style="white-space: pre-wrap;">, </span>**{{2}}**<span style="white-space: pre-wrap;">, </span>**{{3}}**<span style="white-space: pre-wrap;"> para personalizar informações como nome, data e valor. O sistema substitui essas variáveis automaticamente no momento do envio.</span>

</td><td class="align-center" style="text-align: center;">Sim

</td></tr></tbody></table>

<p class="callout warning">Não insira conteúdo promocional em modelos da categoria Utilidade. A Meta reprovará o modelo e você precisará recriá-lo na categoria correta.</p>

#### **7. Usando variáveis nos modelos**

As variáveis permitem personalizar a mensagem para cada destinatário sem criar um modelo diferente para cada situação. No momento do envio, o sistema substitui cada marcador pelo valor correspondente.

**Exemplo de modelo:**

> Olá {{1}}, sua visita ao imóvel localizado em {{2}} está agendada para {{3}}.

**Mensagem recebida pelo cliente:**

> Olá João, sua visita ao imóvel localizado na Rua das Flores está agendada para 10/06/2026 às 14h.

<p class="callout info">Use variáveis apenas para informações que mudam entre um envio e outro. Textos fixos devem estar escritos diretamente no corpo do modelo.</p>

#### **8. Enviando o modelo para aprovação**

<span style="white-space: pre-wrap;">Após preencher todas as informações do modelo, clique em </span>**Salvar**<span style="white-space: pre-wrap;"> e depois em </span>**Enviar para Aprovação**. O modelo será encaminhado para análise da Meta e poderá ficar em uma das seguintes situações:

- **Em análise:**<span style="white-space: pre-wrap;"> o modelo foi enviado e aguarda revisão da Meta.</span>
- **Aprovado:**<span style="white-space: pre-wrap;"> o modelo está liberado para uso em automações, campanhas e atendimentos.</span>
- **Reprovado:**<span style="white-space: pre-wrap;"> o modelo foi recusado. Você precisará revisar o conteúdo e enviá-lo novamente.</span>

<p class="callout success">Para aumentar as chances de aprovação: use linguagem clara e objetiva, informe o motivo da mensagem, escolha a categoria correta, use variáveis somente quando necessário e evite excesso de letras maiúsculas, emojis e linguagem de spam.</p>

#### **9. Exemplos de modelos por categoria**

Abaixo estão exemplos de modelos prontos para uso, organizados por categoria. Adapte o texto conforme a identidade da sua empresa.

**Categoria: Utilidade**

**Cobrança de aluguel:**  
Olá {{1}}, identificamos que o aluguel referente ao período {{2}} possui vencimento em {{3}}. Caso o pagamento já tenha sido realizado, desconsidere esta mensagem. Atenciosamente, {{4}}

**Disponibilização de boleto:**  
Olá {{1}}, seu boleto referente ao contrato {{2}} já está disponível para pagamento. Vencimento: {{3}}. Em caso de dúvidas, estamos à disposição.

**Lembrete de vistoria:**  
Olá {{1}}, gostaríamos de lembrar que sua vistoria está agendada para {{2}} às {{3}}. Em caso de necessidade de alteração, entre em contato conosco.

**Assinatura de contrato:**  
Olá {{1}}, seu contrato referente ao imóvel {{2}} está disponível para assinatura. Acesse o link enviado e finalize o processo.

**Categoria: Marketing**

**Novos imóveis disponíveis:**  
Olá {{1}}, temos novos imóveis disponíveis que podem atender ao seu perfil. Caso tenha interesse, responda esta mensagem para receber mais informações.

**Campanha de venda:**  
Olá {{1}}, confira as oportunidades exclusivas de imóveis disponíveis em sua região. Nossa equipe está pronta para ajudá-lo a encontrar a melhor opção.

**Categoria: Autenticação**

**Código de verificação:**  
Olá {{1}}, seu código de verificação é: {{2}}. Não compartilhe este código com terceiros.

<p class="callout warning">Não use modelos de Utilidade para fins de marketing. A Meta analisa o conteúdo e pode reprovar ou reclassificar o modelo automaticamente.</p>

#### **10. Fluxo completo de ativação**

Para ter o canal 100% operacional, siga esta sequência:

1. <span style="white-space: pre-wrap;">Conectar a conta Meta ao Apre.chat na tela de </span>**Conexões**.
2. Selecionar o número WhatsApp Oficial a ser utilizado.
3. <span style="white-space: pre-wrap;">Configurar a forma de pagamento no </span>**WhatsApp Manager**<span style="white-space: pre-wrap;"> da Meta.</span>
4. <span style="white-space: pre-wrap;">Criar os modelos de mensagem em </span>**Mensagens Rápidas &gt; Adicionar &gt; Template Meta**.
5. Enviar os modelos para aprovação da Meta.
6. <span style="white-space: pre-wrap;">Aguardar a situação mudar para </span>**Aprovado**.
7. Utilizar os modelos em automações, campanhas, cobranças e atendimentos no Apre.chat.

<p class="callout info">O tempo de análise dos modelos pela Meta pode variar. Envie os modelos com antecedência para garantir que estejam aprovados quando você precisar usá-los.</p>

#### **11. Perguntas frequentes**

**O Apre.chat cobra por cada mensagem enviada pelo WhatsApp Oficial?**  
Não. O Apre.chat não realiza cobranças pelas conversas do WhatsApp Oficial. Os valores são cobrados diretamente pela Meta, com base no volume e no tipo de conversa iniciada.

**Posso usar qualquer número de telefone para conectar ao WhatsApp Oficial?**  
O número precisa estar disponível, ou seja, não pode estar ativo em nenhum aplicativo WhatsApp no momento da conexão. Números em uso no WhatsApp pessoal ou no WhatsApp Business convencional precisam ser desvinculados antes de serem conectados ao canal oficial.

**O que acontece se o meu modelo for reprovado pela Meta?**  
Você será notificado sobre a reprovação. Revise o conteúdo seguindo as boas práticas, ajuste o texto ou a categoria conforme necessário e envie novamente para aprovação. Modelos reprovados não podem ser usados até serem corrigidos e aprovados.

**Posso enviar mensagens livremente para clientes que já estão em atendimento?**  
Sim. Dentro da janela de 24 horas após a última mensagem do cliente, você pode enviar qualquer tipo de mensagem sem precisar de um modelo aprovado. Os modelos são obrigatórios apenas para iniciar ou retomar conversas fora dessa janela.

**Quantas variáveis posso usar em um modelo?**  
Não há um limite fixo definido pela Meta para o número de variáveis, mas recomenda-se usar apenas as variáveis necessárias. Modelos com excesso de variáveis e pouco texto fixo têm maior chance de reprovação por parecerem genéricos demais.

**Posso ter mais de um número WhatsApp Oficial conectado ao Apre.chat?**  
Sim, desde que cada número esteja associado a uma conta WhatsApp Business diferente dentro do seu Business Manager na Meta. Cada número aparecerá como uma conexão separada na tela de Conexões.