Cómo integrar WhatsApp Business API a tu sistema

Cada pocos meses un cliente nos pregunta cómo integrar WhatsApp Business API a mi sistema sin que la bandeja de soporte se convierta en un reenvío de capturas de pantalla. La pregunta llega como un tema técnico, pero casi nunca la conexión es la parte difícil. Lo que consume tiempo es decidir qué conversaciones debe manejar el software y cuáles tiene que responder una persona.

Casi todas las empresas ya tienen una costumbre con WhatsApp: los vendedores usan su teléfono personal, los pedidos llegan como notas de voz y después nadie puede decir qué se prometió. Eso funciona hasta que crece el volumen o se va la persona que tenía el chat.

Este artículo cubre los mensajes que vale la pena automatizar, los requisitos que exige Meta y los errores que rompen las integraciones después del lanzamiento.

Primero separa las tres capas

Una integración de WhatsApp son tres piezas en movimiento, y nombrarlas hace más fácil cualquier conversación con un proveedor.

El canal. La mayoría de los proyectos nuevos se conectan por la Cloud API que aloja Meta, así que no tienes que administrar contenedores de mensajería por tu cuenta. Esa documentación es la referencia oficial sobre endpoints, estructuras de datos (payloads) y límites.

Tu sistema. El CRM, el helpdesk o la herramienta de pedidos donde guardas al cliente y su historial. Si un número de teléfono no se resuelve en un único registro de cliente, arregla eso primero: todo flujo depende de ello.

Los flujos. Plantillas para las conversaciones que tú inicias, respuestas libres dentro de la ventana de servicio al cliente (customer service window) que se abre cuando el cliente escribe, y las reglas de enrutamiento que deciden quién responde.

Qué puedes automatizar y qué debe seguir en manos de una persona

Automatizaciones que aguantan en producción

• Confirmaciones y recordatorios disparados por eventos de tu base de datos, no porque alguien se acordó.
• Triaje de entrada: detectar la intención, etiquetar la conversación y enviarla a la cola correcta.
• Respuestas a las preguntas que siempre son idénticas, con un enlace al registro completo.
• Estado de entrega escrito de vuelta en el ticket, para que el agente vea lo mismo que el cliente.
• Seguimientos solo para contactos con un opt-in guardado y un límite de frecuencia que tú definas.

Conversaciones que necesitan a una persona

Reclamos, devoluciones, negociación de precio, incidentes de seguridad y cualquier mensaje que muestre molestia. Una respuesta educada del bot a un cliente enojado cuesta más que el agente que lo habría resuelto en dos minutos. Envía esos casos a un humano de inmediato, con el historial adjunto.

También mantén claras las reglas: todo lo que tú inicias necesita una plantilla aprobada, mientras que las respuestas libres solo funcionan dentro de la ventana de servicio que se abre cuando el cliente escribe.

Requisitos técnicos antes de escribir código

Cuentas, números y verificación

Una cuenta de Meta Business verificada, una WhatsApp Business Account y un número de teléfono que no esté activo en la app de consumo. Si el número está en uso, hay que eliminarlo de la app antes de registrarlo. El nombre visible pasa por revisión, así que sigue las reglas de nombres de Meta. Usa un usuario de sistema con token permanente en lugar de un login personal que vence cuando cambian los roles.

La plomería que los equipos subestiman

• Un webhook sobre HTTPS con verificación de firma del payload.
• Idempotencia: el mismo evento puede llegar dos veces, así que guarda los IDs de mensaje y descarta duplicados.
• Reintentos con espera progresiva (backoff) cuando tu CRM no está disponible, más una cola de fallos para que nada desaparezca en silencio.
• Manejo de archivos: las imágenes y documentos entrantes llegan como identificadores que descargas en una segunda llamada.
• Nombres de plantilla y variables guardados en configuración, no en el código.

Consentimiento y registros

Guarda el opt-in con su fecha, hora y origen, y respeta las bajas a nivel de número. La Business Messaging Policy de Meta marca la base, y tu aviso de privacidad tiene que describir lo que realmente haces con los datos de las conversaciones. Automatizar un canal no reduce esas obligaciones.

Los errores que vemos con más frecuencia

Usar un cliente no oficial como atajo

Las librerías que manejan una sesión de WhatsApp Web parecen rápidas y se rompen sin avisar. Ponen el número en riesgo y te dejan sin plantillas, sin estado de entrega y sin canal de soporte.

Saltarse el registro del opt-in

Un consentimiento que se dio en un chat y nunca se guardó no se puede probar después. Cuando una plantilla llega a alguien que nunca aceptó, no hay nada que mostrar.

Construir el webhook al final

La ingesta decide si la integración sobrevive. Valida firmas, elimina duplicados, registra los payloads crudos por unas semanas y vigila los fallos desde el primer día.

No tener traspaso a un humano

Los agentes necesitan el hilo de WhatsApp en la misma bandeja que el correo y el chat. Si tienen que cambiar de aplicación, responden desde un teléfono personal y el CRM vuelve a quedar ciego.

Cómo definir el alcance del primer lanzamiento

Publica en cuatro pasos: registrar los mensajes entrantes en el CRM, sumar una plantilla saliente con variables reales, después las reglas de enrutamiento y las respuestas guardadas, y solo entonces respuestas con IA o una segunda familia de plantillas. Cuando la herramienta que conectas no tiene una API usable, el trabajo queda en una capa intermedia que mapea eventos a registros y se hace cargo de los reintentos. Esa capa es pequeña pero no opcional, y suele ser donde el software a medida le gana a forzar el comportamiento de un plugin. Es el tipo de desarrollo que resolvemos como proyecto de integración de API.

Preguntas frecuentes

¿Necesito un número de teléfono nuevo?

No necesariamente. Un número que ya está en la app de consumo se puede registrar, pero primero hay que eliminarlo de la app. Muchos equipos empiezan con un número de negocio dedicado.

¿Puedo conectar un CRM que no se diseñó para mensajería?

Por lo general, sí. Si el CRM expone una API o acepta webhooks, la conexión es directa. Si no, una capa intermedia recibe los eventos, los mapea a registros y maneja los reintentos.

¿Meta cobra por la API?

Meta factura las conversaciones por categoría y país según su propia tarifa, y las tarifas cambian. Consulta la página oficial de precios en lugar de un artículo viejo. El alojamiento y el mantenimiento de tu lado son aparte.

Hablemos de lo que necesita tu proyecto

Cuéntanos qué sistemas guardan los datos de tus clientes y qué flujos de mensajes quieres automatizar, y te proponemos un alcance para un primer lanzamiento. Empieza en https://devonauts.com/contact. Si quieres más contexto primero, revisa nuestro trabajo en servicios de integración de API y desarrollo de software a medida.