# Coexistencia: API de WhatsApp y la app Business

URL: https://wa.genuka.com/es/docs/guides/coexistence
Language: Spanish

> Conserva la app WhatsApp Business en tu número mientras usas la API: requisitos (2.24.17+), pasos de conexión, qué se sincroniza y los límites.

Sí, puedes usar la API de WhatsApp sin dejar la app WhatsApp Business: es la coexistencia
(Coexistence) de Meta. Con la app en la versión 2.24.17 o posterior, conectas el mismo número a Genuka WA,
sigues respondiendo a mano desde el teléfono y envías en volumen por la API. Los mensajes nuevos de las
conversaciones individuales aparecen en ambos lados.

*Última actualización: 8 de octubre de 2026*

## ¿Mi número puede usar la coexistencia?

Depende de la app en la que funciona el número hoy. Meta no registra en la Cloud API un número que ya se usa
en WhatsApp, salvo que se elimine primero
([Meta, Business phone numbers](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers));
la coexistencia es la excepción creada para la app WhatsApp Business
([Meta, Onboard WhatsApp Business app users](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)).

| Tu número hoy                                | Qué hacer                                                                                                                                                            |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| En la app **WhatsApp Business**              | No elimines nada. Actualiza la app y conecta el número: Meta ofrece la coexistencia durante el registro, la app sigue funcionando y tus conversaciones se conservan. |
| En **WhatsApp** (la app normal, no Business) | Libéralo primero: elimina la cuenta de WhatsApp de ese número, o conecta otro número. La coexistencia solo cubre la app WhatsApp Business.                           |
| En ninguna app de WhatsApp                   | No hay nada que liberar: se registra directamente en la Cloud API, sin app.                                                                                          |

> [!WARNING]
> **Nunca elimines una cuenta de WhatsApp Business para conectarte**
>
> Eliminar la cuenta de la app Business destruye su historial, y no sirve de nada: la coexistencia existe
> precisamente para que ese número pueda quedarse como está.

## Lo que necesitas antes de empezar

* **Una cuenta de Facebook.** Meta te pide iniciar sesión con ella; una cuenta personal sirve.
* **La app WhatsApp Business en la versión 2.24.17 o posterior**
  ([Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)),
  en el teléfono que tiene el número, **al alcance de la mano**: la conexión se confirma desde la app.
* Para enviar plantillas después, **un método de pago en tu cuenta de WhatsApp Business**: Genuka es
  un Tech Provider, así que Meta factura directamente a tu cuenta
  ([Meta, Partners](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview)).

## ¿Cómo conecto un número en coexistencia a Genuka WA?

1. ### Abre el enlace de conexión

   Desde tu panel, en la página **Números** (o **Enlace de conexión** si gestionas clientes), o desde
   tu enlace público `/connect/{your-slug}` — consulta [Conectar un número](https://wa.genuka.com/es/docs/onboarding). Genuka
   muestra primero una breve lista de verificación: cuenta de Facebook, número en WhatsApp Business (no en WhatsApp
   normal), teléfono en mano con la app actualizada. Marca las tres casillas y luego haz clic en
   **Estoy listo: abrir Meta**.

2. ### Elige tu app WhatsApp Business existente

   En la ventana de Meta, inicia sesión con Facebook y elige o crea el portafolio comercial. Genuka abre
   el Embedded Signup con la opción de incorporación de la app WhatsApp Business, para que Meta te ofrezca conectar tu
   cuenta existente en lugar de crear una nueva. Ingresa el número: la ventana de Meta queda entonces a la espera de un
   código de verificación.

3. ### Confirma desde el teléfono

   En la app WhatsApp Business llega un mensaje de la cuenta oficial "Facebook Business". Toca
   **Connect**, luego **Connect to the Business Platform** y después **Confirm** — es el paso en el que
   Meta ofrece compartir tu historial de chats (Genuka WA todavía no lo importa, ver más abajo). Copia el
   código de verificación.

4. ### Termina en la ventana de Meta

   Pega el código y completa el flujo. De vuelta en Genuka, la conexión se finaliza: la cuenta
   y el número aparecen en tu espacio de trabajo, la cuenta de WhatsApp queda suscrita a los webhooks y el
   número no se vuelve a registrar en la Cloud API — Meta lo registra por sí mismo en coexistencia.

Una vez conectado, llama a `GET /api/v1/numbers?refresh=true` una vez. Genuka lee entonces el número desde
Meta y registra su modo de coexistencia; sin esa llamada, la lista predeterminada
(`"source": "database"`) sigue mostrando `coexistence: false` para un número que acaba de conectarse.

```bash title="GET /api/v1/numbers?refresh=true"
curl "https://wa.genuka.com/api/v1/numbers?refresh=true" \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY"
```

```json title="Respuesta (extracto)"
{
  "data": [
    {
      "id": "con_1",
      "displayPhoneNumber": "+237 6 90 00 00 01",
      "platformType": "SMB_APP",
      "coexistence": true,
      "messagesPerSecond": 20,
      "status": "connected",
      "metaStatus": "CONNECTED",
      "refreshed": true
    }
  ],
  "source": "meta"
}
```

La respuesta completa también incluye, para cada número, las `alerts` de estado detectadas durante la lectura,
y un objeto `limits` con los rendimientos de referencia. Una actualización consulta a Meta número por número y
se detiene en 25 números por llamada: más allá, acótala con `?companyId=`.

## ¿Se importa el historial de mi app?

Por ahora no. Meta solo envía los contactos y el historial de la app si el proveedor los solicita, dentro
de las 24 horas siguientes a la conexión; pasado ese plazo, hay que desconectar el número y volver a ejecutar
el flujo
([Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)).
Genuka WA todavía no hace esa solicitud. En la práctica:

* **Tus conversaciones anteriores se quedan en la app**, intactas, pero no aparecen en Genuka WA. Meta
  permite importar las conversaciones individuales de los últimos 180 días, sin grupos (misma página);
  Genuka WA no lo hace hoy.
* **Todo lo posterior a la conexión sí llega**: los mensajes recibidos en `message.received`,
  los mensajes enviados por la API y los que escribes en la app (ver más abajo).
* **Los contactos agregados o modificados después en la app** los anuncia Meta por webhook (misma
  página); Genuka los retransmite en `coexistence.contacts_synced` — consulta [Webhooks](https://wa.genuka.com/es/docs/webhooks).

## ¿Qué se sincroniza y qué no?

Según la página de coexistencia de Meta, con lo que Genuka WA hace hoy con cada elemento:

| Función                                                             | En la app después de conectar                                                                                      | Por la API                                                                            |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------- |
| Chats individuales                                                  | Siguen funcionando; se admite editar o eliminar un mensaje                                                         | Mensajes nuevos replicados en ambos sentidos; el historial anterior aún no se importa |
| Contactos                                                           | Sin cambios                                                                                                        | Sin importación inicial; Meta anuncia los contactos agregados y modificados después   |
| Grupos                                                              | Sin cambios                                                                                                        | No se sincronizan                                                                     |
| Mensajes temporales                                                 | Desactivados en los chats individuales                                                                             | No                                                                                    |
| Mensajes de visualización única                                     | Desactivados en los chats individuales                                                                             | No                                                                                    |
| Ubicación en tiempo real                                            | Desactivada en los chats individuales                                                                              | No                                                                                    |
| Listas de difusión                                                  | Desactivadas; las listas existentes pasan a solo lectura                                                           | No                                                                                    |
| Llamadas de voz y video                                             | Sin cambios                                                                                                        | No                                                                                    |
| Catálogo, pedidos, estados                                          | Sin cambios                                                                                                        | No                                                                                    |
| Respuestas rápidas, etiquetas, mensajes de ausencia y de bienvenida | Sin cambios                                                                                                        | No                                                                                    |
| Dispositivos vinculados (WhatsApp Web, etc.)                        | Se desvinculan al conectar y se vuelven a vincular después; WhatsApp para Windows y para WearOS no son compatibles | —                                                                                     |

## ¿Qué cambia para los envíos por la API?

* **El rendimiento queda fijado en 20 mensajes por segundo** en un número en coexistencia, frente a 80 por
  defecto en la Cloud API
  ([Meta, coexistence](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/),
  [Meta, Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput)).
  Genuka ajusta el ritmo de tus [campañas](https://wa.genuka.com/es/docs/guides/campaigns-api) a ese valor una vez que el número queda registrado como
  en coexistencia (la llamada `?refresh=true` de arriba). Un lanzamiento también tiene un límite de tiempo: limita las campañas a unos
  cientos de destinatarios (ver las limitaciones en la guía de campañas).
* **Los mensajes enviados desde la app siguen siendo gratuitos; los enviados por la API siguen los precios
  de la Cloud API** ([Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)).
* **Lo que escribes en el teléfono aparece en Genuka.** Meta reenvía esos mensajes (los "echoes");
  Genuka los archiva en la conversación, con la etiqueta "Enviado desde la app WhatsApp Business". No consumen
  nada de tu plan y quedan fuera de las estadísticas de entrega, que solo cuentan lo que envió la API:
  nunca les sigue una confirmación de entrega. Suscripción de webhook:
  `coexistence.message_echoed`.
* **Los límites de Meta se aplican como en cualquier otro caso**: plantillas aprobadas fuera de la ventana de 24 horas, el
  límite de mensajes del portafolio comercial, el límite de marketing por usuario.

## ¿Cómo desconecto la API de la app?

La desconexión se hace en la app, no por la API: **Settings > Account > Business Platform**,
luego **Disconnect Account** (etiquetas tal como aparecen en la documentación de Meta). Meta envía entonces un
webhook `account_update` con el evento `PARTNER_REMOVED`
([Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)).

En Genuka, el número pasa entonces a `disconnected` y la API ya no puede enviar desde él. No se elimina
nada: los mensajes, las plantillas y las estadísticas siguen asociados al número. Volver a pasar por el mismo
enlace de conexión lo pone de nuevo en servicio en el mismo registro, sin ocupar un nuevo espacio en tu
plan.

## Preguntas frecuentes

### ¿Tengo que eliminar mi cuenta de WhatsApp Business para usar la API?

No. Ese es todo el sentido de la coexistencia: la app sigue funcionando en el mismo número. Solo un
número usado en WhatsApp normal debe liberarse antes de conectarlo.

### ¿Los mensajes enviados desde el teléfono cuentan en mi plan de Genuka?

No. Solo los envíos hechos por la API o por una campaña consumen la asignación de mensajes de tu plan. Los mensajes
escritos en la app se sincronizan para que la conversación esté completa, sin contabilizarse.

### ¿Qué pasa si mi app es anterior a la 2.24.17?

Actualízala antes de abrir la ventana de Meta. Meta exige la versión 2.24.17 o posterior para ofrecer
la coexistencia.

### ¿Puedo seguir usando WhatsApp Web?

Sí, una vez que lo vuelvas a vincular: los dispositivos vinculados se desvinculan al conectar y pueden vincularse de nuevo,
salvo WhatsApp para Windows y para WearOS.

### ¿Cuántos mensajes por segundo puedo enviar en coexistencia?

20, sea cual sea tu nivel en Genuka o en Meta. Es un techo que Meta fija para los números compartidos con la
app.

## Fuentes

* Meta — [Onboard WhatsApp Business app users](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users/)
* Meta — [Business phone numbers](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers)
* Meta — [Throughput](https://developers.facebook.com/documentation/business-messaging/whatsapp/throughput)
* Meta — [Partners (Tech Providers and Solution Partners)](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview)
* Genuka — [Guía de coexistencia del SDK](https://wa.genuka.com/sdk/coexistence)
