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 app do celular e na Cloud API (Jelou) simultaneamente.

​
O que é Coexistência?

A Coexistência permite que o mesmo número funcione ao mesmo tempo em:
  • WhatsApp Business App (celular)
  • WhatsApp Cloud API (Jelou)
Isso significa que você pode:
  • Enviar campanhas e automações pela Jelou
  • Continuar usando o app para atendimento manual 1 a 1
  • Manter o histórico sincronizado entre ambos os ambientes

​
Como funciona?

Durante a conexão do canal:
  1. O negócio informa 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 app.
  4. O usuário pode autorizar (opcionalmente) o compartilhamento de:
    • Histórico de mensagens
    • Contatos
Uma vez finalizado:
  • O número fica conectado à Cloud API
  • A Jelou pode enviar mensagens em massa e automatizadas
  • O app continua funcionando normalmente para atendimento manual

​
Requisitos

Antes de ativar a Coexistência, certifique-se de cumprir o seguinte:
  • WhatsApp Business App versão 2.24.17 ou superior
  • Número com código de país compatível
  • Negócio verificado 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 suportados:
  • Chats em grupo
  • Listas de transmissão
  • Status
  • Chamadas e videochamadas
  • Mensagens temporárias
  • Mensagens de visualização única

​
Pelo WhatsApp Business App (celular)

Você pode continuar usando normalmente:
  • Chamadas e videochamadas
  • Listas de transmissão
  • Status
  • Participação em grupos
  • Atendimento manual 1 a 1
Essas ações não usam IA nem automação, pois são realizadas diretamente pelo app.

​
Janela de 24 horas

A janela de atendimento é aberta quando:
  • O usuário escreve após o número já estar registrado na API.
Se o usuário escreveu antes do registro:
  • Só é possível responder usando templates aprovados.

​
O que é sincronizado com a Jelou?

​
Chats individuais (1:1)

  • É possível sincronizar até 6 meses (180 dias) de histórico.
  • As mensagens são refletidas entre:
    • App
    • Jelou

​
Contatos

  • São sincronizados os contatos que possuem número do WhatsApp.

​
O que acontece durante a sincronização

Uma vez registrado o número: Você tem 24 horas para:
  • Sincronizar contatos
  • Sincronizar histórico de mensagens
O app deve:
  • Permanecer aberto
  • Ter conexão estável
O processo pode levar vários minutos dependendo do volume de mensagens.

​
Estados do histórico

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

​
Eventos recebidos pela Jelou (webhooks)

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

​
Como remover a conexão?

Não é possível desconectar pela API.
O negócio deve fazer pelo app:WhatsApp Business App → Configurações → Conta → Plataforma WhatsApp Business → Desconectar
Isso enviará automaticamente o evento de desconexão para a Jelou.