> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Coexistence

> Conecta un mismo número de WhatsApp Business App y Cloud API (Jelou) al mismo tiempo.

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

<Note>
  Estas acciones se realizan directamente desde la app; no pasan por la automatización ni la API de Jelou.
</Note>

***

## 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.

<Note>
  El negocio debe hacerlo desde la app:

  WhatsApp Business App → Ajustes → Cuenta → Plataforma de WhatsApp Business → Desconectar
</Note>

Esto enviará automáticamente el evento de eliminación a Jelou.