coexistence | Referencia de Coexistencia

Qué es

El modo oficial de Meta para correr la app de WhatsApp Business y la Cloud API en un mismo número de teléfono al mismo tiempo. No es una API aparte: es la misma Cloud API, con un onboarding hecho de manera que la app siga funcionando en el número después.

Por qué la usan los equipos

Cuatro motivos explican casi toda conexión.

• Conservar el número que ya está impreso en vehículos, recibos y un sitio web.
• Agregar envío por API, webhooks y plantillas sin mover a nadie a una herramienta nueva.
• Mantener las conversaciones fuera de la bandeja compartida de un proveedor.
• Permitir que una agencia sostenga muchos números de clientes, cada uno en el portafolio del propio cliente.

Cómo funciona la comunicación

Las dos superficies ven el mismo hilo. Lo que envía la API aparece en la app. Lo que el equipo escribe en la app llega al software como un evento smb_message_echoes, que es lo que impide que la automatización responda encima de una persona.

Comportamiento de precios

Meta cobra por conversaciones y no por mensajes, y los carga al método de pago de tu propia Cuenta de WhatsApp Business. Las respuestas dentro de la ventana de atención de 24 horas son gratuitas. Abrir una conversación fuera de ella exige una plantilla y se cobra.

Dispositivos vinculados

La Coexistencia no es un dispositivo vinculado y no usa ninguno. Un dispositivo vinculado es el cliente de consumo con sesión iniciada en otro lugar, que es lo que automatizan las herramientas no oficiales y lo que prohíben los términos de WhatsApp. Nada de esto usa ese mecanismo.

Limitaciones funcionales

Fijadas por Meta, idénticas en todo proveedor.

• Los chats de grupo no están disponibles por la API.
• Las plantillas no se pueden enviar desde la app del teléfono, solo por la API.
• El throughput de envío es fijo, en lugar de crecer con la calidad y el nivel.
• El compartir historial de conversaciones se decide una sola vez, durante el onboarding.

Elegibilidad

El número tiene que cumplir todas estas condiciones antes de poder conectarse.

• Ya estar activo en la app de WhatsApp Business, y no en la app de consumo.
• Estar en un Portafolio Comercial al que tengas acceso.
• No estar ya conectado a la app de otro proveedor.

Notas operativas

Cosas que son ciertas después de conectar y que es fácil pasar por alto.

• La app tiene que abrirse periódicamente, o Meta desconecta el lado de la API.
• Una desconexión desinstala el override de webhook junto con la app.
• La calificación de calidad se consulta por polling, no se empuja, así que nada anuncia una caída.
• Un token revocado se ve idéntico a un número eliminado, si no hay una segunda credencial.

Salvedad sobre la elección de la cuenta

Durante el Embedded Signup, el Portafolio Comercial y la Cuenta de WhatsApp Business se eligen en pasos separados. Elegir la cuenta equivocada vincula el número en un lugar que no pretendías, y moverlo después significa desconectar y correr el flujo entero otra vez.

Decisiones sin vuelta atrás

Compartir el historial de conversaciones existente se pregunta una vez y no se puede revisar. La sincronización además tiene que empezar dentro de las 24 horas del onboarding y solo puede correr una vez. Las dos cosas producen errores poco familiares en lugar de avisos cuando se pierden.

Desconectar o revertir

Un número puede desconectarse en cualquier momento, desde el panel o por el conector. La app de WhatsApp Business sigue exactamente igual que antes, con sus conversaciones e historial intactos, y nada del número en sí queda alterado de forma permanente por haber estado conectado.

Errores comunes

• Tratar la Coexistencia como una API distinta. Es la Cloud API con un onboarding distinto.
• Construir alrededor de los chats de grupo. Quedan excluidos en todo proveedor.
• Suponer que una reconexión restaura el destino del webhook. No lo restaura.

Preguntas frecuentes

Sigue leyendo