Glosario de la Coexistencia de WhatsApp
Los términos alrededor de la Coexistencia de WhatsApp son fáciles de confundir, y la mayor parte de la confusión en la práctica viene de dos personas usando una palabra para cosas distintas. Estas son las definiciones que usa este sitio, cada una enlazada a la página que la cubre bien.
EasyCoexistence conecta un número por el flujo de la propia Meta y luego vigila la conexión.
- CoexistenciaCoexistence
El modo oficial de Meta para usar la app de WhatsApp Business y la Cloud API en un mismo número a la vez. No es una API aparte: es la misma Cloud API, conectada de forma que la app siga funcionando.
Coexistencia de WhatsApp- Cloud API
La API de WhatsApp Business Platform alojada por Meta. Cada envío, plantilla y webhook de este sitio pasa por ella.
Cloud API o Coexistencia- App de WhatsApp BusinessWhatsApp Business app
La app que una empresa usa en el teléfono. Es distinta de la app de WhatsApp de consumo, y el número tiene que estar en ella antes de que la Coexistencia pueda conectarlo.
- Cuenta de WhatsApp BusinessWABA
El objeto de Meta que guarda los números de teléfono y las plantillas. Está dentro de un Portafolio Comercial. Los overrides de webhook se aplican en este nivel, no por número.
- Portafolio ComercialBusiness Portfolio
El contenedor de nivel de empresa en Meta Business Manager. Guarda una o más cuentas de WhatsApp Business. El número de un cliente se queda en su propio portafolio, no en el de un proveedor.
Meta Tech Provider- Phone number id
El identificador de Meta para un número conectado. Los envíos apuntan a él y no al número en sí, y aparece en cada payload de webhook entrante.
- Embedded Signup
El popup de onboarding de la propia Meta. Elige el portafolio, la cuenta y el número, y en la Coexistencia incluye un código que se escanea en la app de WhatsApp Business.
Cómo se conecta un número- Tech Provider
Un estatus de Meta que permite a una empresa conectar números de otros negocios mediante su propia app aprobada. Es gratuito y depende de la verificación de la empresa y del App Review. No es un respaldo de Meta.
Qué significa- BSPBusiness Solution Provider
Una empresa que vende una plataforma de mensajería, normalmente una bandeja de entrada compartida. Se solapa con Tech Provider, pero describe el producto y no el estatus en Meta.
Coexistencia o un BSP- Destino de webhookwebhook override
Adonde Meta entrega los eventos de una cuenta de WhatsApp Business. Se define como un override sobre la suscripción de una app, y por eso eliminar una conexión lo desinstala.
Webhooks de WhatsApp- hub.challenge
Un valor que Meta envía en su GET de verificación. El endpoint tiene que devolverlo como cuerpo sin formato. Devolver JSON en su lugar es la razón más común de que un webhook nunca reciba nada.
Verificación del webhook- messages
El campo de webhook que trae lo que envían los clientes. Forma parte de la ruta de los mensajes, que es lo que un override de webhook desvía de un proveedor.
- smb_message_echoes
El campo de webhook que trae lo que un equipo envía desde la app de WhatsApp Business. Solo existe en números con Coexistencia, y es como un software ve las respuestas de una persona.
- Ventana de atenciónla ventana de 24 horas
Veinticuatro horas desde el último mensaje del cliente, durante las cuales se entrega texto libre. Fuera de ella, solo se entrega una plantilla aprobada.
Error 131047- PlantillaTemplate
Un mensaje enviado a Meta para revisión por adelantado. Lo único que se entrega fuera de la ventana de atención, y en un número con Coexistencia solo puede enviarse por la API.
Error 132001- Calificación de calidadQuality rating
Verde, amarilla o roja, asignada por Meta según cómo reaccionan los destinatarios. Baja antes de costar nada, y nada anuncia la bajada.
Error 131048- Nivel de mensajeríaMessaging tier
Con cuántos clientes únicos puede iniciar conversaciones un número al día. Se mueve en ambas direcciones. Es distinto del throughput, que es una tasa.
- Throughput
Mensajes por segundo que puede enviar un número. En un número con Coexistencia lo fija Meta, en lugar de crecer con la calidad y el nivel.
Error 130429- Dispositivo vinculadoLinked device
El cliente de WhatsApp de consumo con sesión iniciada en otro sitio, como hace WhatsApp Web. Es lo que automatizan las herramientas no oficiales, lo que prohíben los términos de WhatsApp y lo que hace que baneen números.
Riesgos de la API no oficial- MCPModel Context Protocol
Cómo un asistente de IA llega a una herramienta que no es suya. Solo petición y respuesta: un servidor MCP no puede despertarse con un mensaje entrante.
Servidor MCP de WhatsApp
¿Por qué el vocabulario da tantos problemas?
Porque varios de estos términos nombran cosas de niveles distintos que parecen todas del mismo nivel.
Un Portafolio Comercial contiene una cuenta de WhatsApp Business, que contiene números de teléfono, cada uno con un phone number id. En la conversación los cuatro acaban siendo la cuenta, y una frase como comprueba si la cuenta funciona puede significar cuatro comprobaciones distintas. Lo mismo pasa con las dos ventanas de veinticuatro horas de esta plataforma, que miden cosas sin relación y se intercambian constantemente.
La otra mitad es que Meta y los proveedores usan palabras distintas para lo mismo, y los proveedores tampoco se ponen de acuerdo entre sí. Esta página usa el vocabulario de la propia Meta donde existe, y dice con claridad cuándo un término es nuestro.
¿Qué distinciones importan de verdad en la práctica?
Tres, y cada una le ha costado un día a alguien.
La ventana de atención y la ventana de sincronización duran ambas veinticuatro horas y no tienen nada que ver entre sí. Una gobierna si el texto libre se entrega, contada desde el último mensaje del cliente. La otra gobierna si el historial todavía puede traerse, contada desde el onboarding.
Un dispositivo vinculado no es una API. Es el cliente de consumo de WhatsApp con sesión iniciada en otro sitio, que es lo que automatizan las herramientas no oficiales y lo que banea números.
Y un destino de webhook no es un ajuste del número. Es un override sobre la suscripción de una app a una cuenta, y por eso desaparece cuando se elimina una conexión y hay que reponerlo al reconectar.
Preguntas frecuentes
¿La Coexistencia es una API distinta de la Cloud API?
No. La Coexistencia es una forma de conectar un número a la Cloud API que deja la app de WhatsApp Business funcionando en él. Los endpoints, el formato de mensaje y las reglas son idénticos.
¿Cuál es la diferencia entre Portafolio Comercial y WABA?
El Portafolio Comercial es el contenedor de nivel de empresa en Meta Business Manager. Una cuenta de WhatsApp Business vive dentro y guarda los números. Un portafolio puede contener varias WABA.
¿Un BSP es lo mismo que un Tech Provider?
Se solapan, pero describen cosas distintas. Tech Provider es un estatus de Meta que permite a una empresa conectar números de otros negocios mediante su propia app. BSP suele describir a una empresa que vende una plataforma de mensajería, que puede tener ese estatus o no.
¿Qué tiene que ver MCP con WhatsApp?
Nada por naturaleza. MCP es un protocolo para dar a un asistente de IA acceso a una herramienta, y un servidor MCP de WhatsApp expone un número como una de esas herramientas. No recibe mensajes, solo actúa cuando se le pide.
¿Listo para empezar?
Configura WhatsApp Coexistence en minutos, no en meses. La app sigue funcionando en el teléfono.
Empezar prueba gratisNo se cobra nada durante 3 días. Cancela cuando quieras.