Casi todos los proyectos de integración de WhatsApp se atascan en el mismo punto, y nunca es el que se presupuesta. La mensajería funciona la primera tarde. Lo que se lleva las semanas restantes es la fontanería de alrededor: qué número puedes usar, de quién es, dónde vive la prueba del consentimiento, sobre qué identidad enlazas a los clientes, y qué tiene que saber tu sistema de un reloj de 24 horas que no controla.
Esta guía explica qué exige de verdad conectar la API de WhatsApp Business a una pila existente: las decisiones caras de deshacer, las restricciones que se comportan como problemas de ingeniería más que como normas, y los casos en los que no deberías integrar en absoluto.
El número es un compromiso, no un ajuste
Un número de teléfono solo puede estar conectado a un Business Solution Provider a la vez. De ese único hecho se derivan casi todas las decisiones iniciales.
Usa un número dedicado que no esté ya activo en WhatsApp. Un número que ya ejecuta la app de consumo o la app de WhatsApp Business tiene que migrarse, y migrar significa interrupción en ese número. Meter ahí tu línea principal de atención sin planificarlo es la forma en que un equipo descubre la restricción un lunes por la mañana.
Cuenta con una puerta de verificación antes del volumen real. La verificación de empresa en el Business Manager de Meta es lo que te saca del nivel inicial: hasta que pasa, estás limitado a unos pocos destinatarios únicos al día, lo cual sirve para probar y no sirve para una campaña. Arráncala pronto: pide documentación societaria y un sitio verificable, y es el paso que más fácilmente queda esperando a otra persona.
Decide de quién es el activo. Si el BSP mantiene el número por ti, salir más adelante exige portabilidad, no una exportación. Pregúntalo antes de firmar, no cuando quieras irte. La mecánica del cambio está en cómo elegir un BSP de WhatsApp.
El consentimiento es un registro, no una casilla
Toda integración necesita un sitio donde viva el opt-in, y tiene que ser un registro que puedas enseñar: quién consintió, cuándo, desde qué superficie, a qué texto.
El error es guardar un booleano. Un booleano dice que el cliente está inscrito; no dice si puedes demostrarlo, y no aguanta la pregunta del canal: un consentimiento recogido para el correo no se extiende a WhatsApp. Guarda la marca de tiempo, el origen y el texto exacto mostrado, y mantenlo unido al contacto en lugar de en un log de envíos de formulario que nadie puede consultar.
Las reglas en sí, y cómo se documentan bajo el RGPD, están en nuestra guía del opt-in de WhatsApp.
El problema de identidad que nadie prevé
WhatsApp se indexa por número de teléfono. Casi todas las pilas de comercio electrónico y los CRM se indexan por correo. Integrar ambos obliga a decidir, de forma explícita, qué es un cliente.
Los duplicados aparecen de inmediato: la misma persona como ficha solo-correo y como ficha solo-teléfono. Encontrarás números guardados en cinco formatos, algunos sin prefijo internacional, que no casan con nada hasta normalizarlos a E.164. Y encontrarás clientes cuyo número de WhatsApp no es el del pedido.
Normaliza al escribir, no al leer, y decide desde el principio si la clave primaria de una conversación es el número o el identificador del CRM. Hacerlo tras unos miles de conversaciones es una migración.
La ventana de 24 horas es una restricción de ingeniería
Los documentos de política describen la ventana de atención como una norma. En tu sistema se comporta como estado: cuando un cliente te escribe se abre una ventana, y mientras esté abierta puedes responder libremente; cuando se cierra, volver a alcanzarlo exige una plantilla preaprobada, que cuesta dinero y tiene una categoría.
Eso significa que tu aplicación tiene que saber si hay una ventana abierta antes de decidir cómo enviar. Los sistemas que se saltan este paso mandan todo como plantilla y pagan mensajes que podían ser gratuitos, o intentan respuestas libres que fallan en silencio. En ambos casos el fallo es invisible en el panel hasta que llega la factura.
Las plantillas añaden su propio estado: cada una se envía a aprobación, y la aprobación no es instantánea. Encola con mucha antelación todo lo que tenga fecha. La mecánica de la ventana y de los tipos de mensaje está en la ventana de 24 horas y en marketing con la API de WhatsApp Business.
Qué vuelve, y dónde debe aterrizar
Una integración que solo envía está construida a medias. Decide antes del lanzamiento qué recibe el resto de la pila:
Estado de entrega y lectura por mensaje, unido al cliente; si no, no distingues una campaña fallida de una impopular.
Los mensajes entrantes, enrutados a donde una persona los vea. Es el requisito que los equipos subestiman: abrir un canal crea la obligación de contestarlo.
La conversación misma, o al menos un resumen, en la ficha del cliente. Los agentes que no ven lo que ya dijo el asistente automático lo contradirán.
Qué se rompe en el segundo mes
La calificación de calidad. Meta puntúa tu número según cómo reaccionan los destinatarios: bloqueos y reportes la bajan, y una puntuación baja recorta tus límites de envío. Es el mecanismo que castiga las listas compradas y el exceso de envíos, y se degrada poco a poco en vez de fallar con estrépito.
La plantilla rechazada en el peor momento. Una plantilla que suena a marketing pero se presentó como utilidad acaba rechazada o reclasificada, y la campaña que dependía de ella pierde su ventana.
Que no conteste nadie. El fallo más común es organizativo, no técnico: llega el volumen entrante y no hay turno. Un WhatsApp sin respuesta, para el cliente, es peor que no tener WhatsApp.
Cuándo no integrar
Si tus volúmenes mensuales son bajos y el caso de uso es la conversación uno a uno, la app gratuita de WhatsApp Business hace el trabajo y la API es complejidad que no necesitas. La API se gana su complejidad cuando hacen falta automatizaciones, varios agentes en un mismo número o una conexión con tus datos de pedido.
Si no tienes a nadie para atender el buzón, no lo abras. Si tu lista no se recogió con consentimiento para este canal, no la importes: la calificación de calidad te encontrará. Y si el único objetivo es la difusión masiva, comprueba antes que salgan las cuentas: cada mensaje iniciado por la empresa tiene un precio, tratado en cuánto cuesta la API de WhatsApp Business.
El orden que funciona
Número y verificación primero, porque llevan esperas externas. El registro de consentimiento después, porque la prueba no se reconstruye a posteriori. La normalización de identidades en tercer lugar, antes de que el volumen la convierta en una migración. Luego el envío consciente de la ventana, luego las plantillas, luego la automatización. Los equipos que invierten este orden entregan una demo en una semana y se pasan un trimestre haciéndola segura de usar.
Para la capa de conserjería que se apoya encima una vez lista la fontanería, mira el WhatsApp AI Concierge de TikJoy.