Coexistence

Esta guía explica cómo funciona Coexistence: la opción que permite usar un mismo número de WhatsApp en la app del celular y en la Cloud API (Jelou) simultáneamente.

​

¿Qué es Coexistence?

Coexistence permite que un mismo número funcione al mismo tiempo en: 📱 WhatsApp Business App (celular) ☁️ WhatsApp Cloud API (Jelou) Esto significa que puedes:

• Enviar campañas y automatizaciones desde Jelou
• Seguir usando la app para atención manual 1 a 1
• Mantener el historial sincronizado entre ambos entornos

---

​

¿Cómo funciona?

Durante la conexión del canal:

1. El negocio ingresa su número actual de WhatsApp Business App.
2. Meta envía un código de verificación.
3. El usuario confirma la conexión desde la app.
4. Puede autorizar (opcionalmente) compartir:
   • Historial de mensajes
   • Contactos

Una vez finalizado:

• El número queda conectado a la Cloud API
• Jelou puede enviar mensajes masivos y automatizados
• La app sigue funcionando normalmente para atención manual

---

​

Requisitos

Antes de activar Coexistence, asegúrate de cumplir con lo siguiente: ✅ WhatsApp Business App versión 2.24.17 o superior ✅ Número con código de país admitido ✅ Negocio verificado en Facebook Business Manager ✅ Jelou configurado con webhooks activos y Cloud API habilitada

---

​

Capacidades y limitaciones

​

API (Jelou)

• Límite fijo de 20 mensajes por segundo (mps)

Desde la API no están disponibles (usa la WhatsApp Business App en el celular si aplica):

• Grupos (chats grupales)
• Mensajes temporales
• Mensajes de visualización única
• Ubicación en tiempo real
• Listas de difusión
• Llamadas de voz y video
• Catálogo, pedidos y estados
• Respuestas rápidas, etiquetas y otras herramientas de negocio
• Perfil del negocio (la administración del perfil comercial corresponde a la app; la API no ofrece un equivalente completo en coexistencia)
• Limitación de Meta: los mensajes de pauta (anuncios u originación pagada hacia WhatsApp) no se entregan como mensajes dentro del chat de WhatsApp de la misma forma que las plantillas aprobadas o las conversaciones orgánicas; revisa las políticas vigentes de Meta para Click to WhatsApp y campañas

---

​

Desde la WhatsApp Business App (celular)

Puedes seguir usando normalmente:

• Llamadas y videollamadas
• Listas de difusión
• Estados
• Participación en grupos
• Catálogo, pedidos y estados (según lo que ofrezca tu cuenta en la app)
• Respuestas rápidas, etiquetas y herramientas de negocio
• Perfil del negocio
• Atención manual 1 a 1

---

​

Ventana de 24 horas ⏱️

La ventana de atención se abre cuando:

• El usuario escribe después de que el número ya está registrado en la API.

Si el usuario escribió antes del registro:

• Solo se puede responder usando plantillas aprobadas.

---

​

¿Qué se sincroniza con Jelou?

​

Chats individuales (1:1)

• Se pueden sincronizar hasta 6 meses (180 días) de historial.
• Los mensajes se reflejan entre:
  • App
  • Jelou

​

Contactos

• Se sincronizan contactos que tengan número de WhatsApp.

---

​

Qué ocurre durante la sincronización

Una vez registrado el número: Tienes 24 horas para:

• Sincronizar contactos
• Sincronizar historial de mensajes

La app debe:

• Permanecer abierta
• Tener conexión estable

📌 El proceso puede tardar varios minutos dependiendo del volumen de mensajes.

---

​

Estados del historial

El negocio puede decidir: ✅ Compartir historial
Se sincronizan mensajes de hasta 180 días. ❌ No compartir historial
Jelou recibe el evento, pero no los mensajes anteriores.

---

​

Eventos que recibe Jelou (webhooks)

Para mantener la sincronización, Jelou escucha eventos como: account_update
Cambios en la cuenta o desconexión. messages
Edición o eliminación de mensajes. history
Sincronización de mensajes históricos. smb_app_state_sync
Cambios en contactos. smb_message_echoes
Mensajes enviados desde la app.

---

​

¿Cómo se elimina la conexión?

⚠️ No se puede desconectar desde la API. Esto enviará automáticamente el evento de eliminación a Jelou.