Coexistência

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) ao mesmo tempo.

​

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 os dois 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. Pode autorizar (opcionalmente) compartilhar:
   • 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 configurada com webhooks ativos e Cloud API habilitada

---

​

Capacidades e limitações

​

API (Jelou)

• Limite fixo de 20 mensagens por segundo (mps)

Pela API não estão disponíveis (use o WhatsApp Business App no celular, se for o caso):

• Grupos (chats em grupo)
• Mensagens temporárias
• Mensagens de visualização única
• Localização em tempo real
• Listas de transmissão
• Chamadas de voz e vídeo
• Catálogo, pedidos e status
• Respostas rápidas, etiquetas e outras ferramentas de negócio
• Perfil do negócio (a administração do perfil comercial fica no app; a API não oferece um equivalente completo em coexistência)
• Limitação da Meta: mensagens vindas de anúncios ou de origem paga para o WhatsApp não são entregues como mensagens dentro do chat do WhatsApp da mesma forma que templates aprovados ou conversas orgânicas; consulte as políticas vigentes da Meta para Click to WhatsApp e campanhas

---

​

Pelo WhatsApp Business App (celular)

Você pode continuar usando normalmente:

• Chamadas e videochamadas
• Listas de transmissão
• Status
• Participação em grupos
• Catálogo, pedidos e status (conforme o que sua conta oferece no app)
• Respostas rápidas, etiquetas e ferramentas de negócio
• Perfil do negócio
• Atendimento manual 1 a 1

---

​

Janela de 24 horas ⏱️

A janela de atendimento abre 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. Isso enviará automaticamente o evento de desconexão para a Jelou.