Pular para o conteúdo principal
Este guia explica como funciona a Coexistência: a opção que permite usar o mesmo número do WhatsApp no aplicativo móvel e na Cloud API (Jelou) simultaneamente.

​
O que é a Coexistência?

A Coexistência permite que o mesmo número funcione ao mesmo tempo em: 📱 WhatsApp Business App (móvel) ☁️ WhatsApp Cloud API (Jelou) Isso significa que você pode:
  • Enviar campanhas e automações pelo Jelou
  • Continuar usando o aplicativo para suporte manual 1-a-1
  • Manter o histórico sincronizado entre os dois ambientes

​
Como funciona?

Durante a conexão do canal:
  1. A empresa insere seu número atual do WhatsApp Business App.
  2. A Meta envia um código de verificação.
  3. O usuário confirma a conexão pelo aplicativo.
  4. O usuário pode, opcionalmente, autorizar o compartilhamento de:
    • Histórico de mensagens
    • Contatos
Após concluído:
  • O número é conectado à Cloud API
  • O Jelou pode enviar mensagens em massa e automatizadas
  • O aplicativo continua funcionando normalmente para suporte manual

​
Requisitos

Antes de ativar a Coexistência, certifique-se de atender aos seguintes requisitos: ✅ Versão 2.24.17 ou superior do WhatsApp Business App ✅ Número com código de país compatível ✅ Empresa verificada no Facebook Business Manager ✅ Jelou configurado com: ✅ Webhooks ativos ✅ Cloud API habilitada

​
⚠️ Capacidades e limitações

​
API (Jelou)

  • Limite fixo de 20 mensagens por segundo (mps)
🚫Não suportado:
  • Chats em grupo
  • Listas de transmissão
  • Atualizações de status
  • Chamadas e videochamadas
  • Mensagens temporárias
  • Mensagens de visualização única

​
Pelo WhatsApp Business App (móvel)

Você pode continuar usando normalmente: ✅ Chamadas e videochamadas ✅ Listas de transmissão ✅ Atualizações de status ✅ Participação em grupos ✅ Suporte manual 1-a-1
📌 Essas ações não utilizam IA ou automação, pois são realizadas diretamente pelo aplicativo.

​
Janela de 24 horas ⏱️

A janela de suporte se abre quando:
  • O usuário escreve após o número já estar registrado na API.
Se o usuário escreveu antes do registro:
  • Somente templates aprovados podem ser usados para responder.

​
O que é sincronizado com o Jelou?

​
Chats individuais (1:1)

  • Até 6 meses (180 dias) de histórico podem ser sincronizados.
  • As mensagens são refletidas entre:
    • Aplicativo
    • Jelou

​
Contatos

  • Contatos que possuem número do WhatsApp são sincronizados.

​
O que acontece durante a sincronização

Após o registro do número: Você tem 24 horas para:
  • Sincronizar contatos
  • Sincronizar histórico de mensagens
O aplicativo deve:
  • Permanecer aberto
  • Ter uma conexão estável
📌 O processo pode levar vários minutos dependendo do volume de mensagens.

​
Estados do histórico

A empresa pode decidir: ✅ Compartilhar histórico
Mensagens de até 180 dias são sincronizadas. ❌ Não compartilhar histórico
O Jelou recebe o evento, mas não as mensagens anteriores.

​
Eventos recebidos pelo Jelou (webhooks)

Para manter a sincronização, o Jelou escuta eventos como: account_update
Alterações na conta ou desconexão. messages
Edições ou exclusões de mensagens. history
Sincronização de mensagens históricas. smb_app_state_sync
Alterações de contatos. smb_message_echoes
Mensagens enviadas pelo aplicativo.

​
Como remover a conexão?

⚠️ Não é possível desconectar pela API.
A empresa deve fazer isso pelo aplicativo:WhatsApp Business App → Configurações → Conta → WhatsApp Business Platform → Desconectar
Isso enviará automaticamente o evento de desconexão ao Jelou.