Cómo integrar WhatsApp Business API con un CRM

Qué es la API y qué no es

WhatsApp Business API —hoy WhatsApp Business Platform— no es una versión mejor de la aplicación WhatsApp Business. Es otra cosa: no tiene interfaz propia, se opera desde el sistema que usted conecte y está pensada para que varias personas atiendan en paralelo sobre un mismo número de empresa.

La aplicación está pensada para uso manual desde un teléfono. Las herramientas que la automatizan por fuera funcionan durante un tiempo y dejan de funcionar cuando Meta bloquea el número, que es un riesgo que no conviene asumir con el canal por el que entra su negocio.

Un número sólo puede estar en un lado: si el teléfono ya está registrado en la aplicación WhatsApp Business, hay que darlo de baja antes de migrarlo a la API. Conviene planificarlo, porque implica una ventana sin atención.

Los tres actores de la integración

• Meta. Es dueña de la plataforma, aprueba las plantillas de mensaje, verifica la empresa y cobra por mensaje entregado.
• El proveedor autorizado (BSP). Da de alta el número, expone el acceso técnico y suele añadir su propio margen sobre la tarifa de Meta. Puede haber también un acceso directo a la Cloud API, según el caso.
• Su CRM. Es donde debe terminar cada conversación convertida en contacto, actividad y estado. Si no llega hasta ahí, la integración no resolvió el problema: sólo movió el chat de sitio.

Al elegir proveedor conviene preguntar dos cosas concretas: a nombre de quién queda el número, y qué pasa con el historial de conversaciones si usted cambia de proveedor. Las respuestas varían más de lo que parece.

Requisitos previos, en orden

Este trámite es el que marca el plazo real del proyecto, y depende de terceros. Conviene iniciarlo en la primera semana, antes de que la automatización esté lista.

• Cuenta de empresa en Meta y verificación de la empresa. Requiere que razón social, RUC y sitio web coincidan exactamente con la documentación. Cuando no coinciden, el trámite pasa de días a semanas.
• Un número de teléfono que no esté registrado en la aplicación WhatsApp Business ni en WhatsApp personal.
• Nombre para mostrar acorde a las políticas de Meta. Un nombre que no se corresponda con la marca verificable se rechaza.
• Plantillas de mensaje redactadas y enviadas a aprobación, categorizadas correctamente entre marketing, utilidad y autenticación.

La ventana de 24 horas y las plantillas

Es la regla que más condiciona el diseño y la que más sorprende a los equipos comerciales. Cuando un cliente le escribe, se abre una ventana de atención de 24 horas durante la cual su empresa puede responder con mensajes libres. Fuera de esa ventana, sólo se puede iniciar la conversación con una plantilla previamente aprobada por Meta.

En la práctica esto significa que el seguimiento a un lead de hace tres días no se puede hacer con un mensaje escrito a mano: hay que tener una plantilla pensada para eso, aprobada de antemano. Diseñar el catálogo de plantillas es parte del proyecto, no un trámite posterior.

Sobre el costo, el modelo cambió: desde el 1 de julio de 2025 Meta cobra por mensaje de plantilla entregado y ya no por conversación, con tarifa según la categoría de la plantilla y el país del destinatario. Los mensajes que su empresa envía dentro de la ventana de atención no se cobran. Si encuentra un artículo que le explica el cobro por conversación, está desactualizado.

La arquitectura de la integración

Una integración de WhatsApp con un CRM tiene dos direcciones, y la mayoría de implementaciones flojas sólo resuelven bien una.

• Entrante. El proveedor envía un webhook por cada mensaje recibido. Su sistema debe identificar al contacto por número, crearlo si no existe, adjuntar el mensaje como actividad y decidir a quién se asigna.
• Saliente. Su sistema envía el mensaje o la plantilla, y debe guardar el identificador que devuelve la plataforma para poder cruzar después los estados de entregado y leído.
• Estados. Los acuses llegan por el mismo webhook, después y por separado. Sin guardar el identificador del envío, no hay forma de saber qué mensaje fue entregado.

La pieza que separa una integración que se puede reintentar de una que hay que reparar a mano es la idempotencia: procesar dos veces el mismo webhook no debe crear dos contactos ni dos actividades. Los webhooks se reenvían cuando su sistema responde lento o falla, y eso ocurre.

Todo lo que no se pueda procesar debe quedar en una cola visible con el motivo del fallo y un botón para reprocesar. Nunca se descarta un mensaje en silencio: ese comportamiento convierte una caída de dos horas en un descuadre que aparece un mes después.

Cinco errores que la rompen en producción

• Usar el número personal de un asesor. Funciona hasta que esa persona se va, y la cartera se va con ella. El número debe quedar a nombre de la empresa.
• No guardar el identificador del mensaje enviado. Sin él no se pueden cruzar los acuses de entrega y el equipo no sabe si el cliente recibió nada.
• Ignorar la ventana de 24 horas en el diseño. El equipo descubre en producción que no puede escribirle a un lead de anteayer y termina usando teléfonos personales, que es exactamente lo que se quería evitar.
• Enviar plantillas de marketing categorizadas como utilidad. Meta recategoriza y, sostenido en el tiempo, afecta la calidad del número.
• No manejar reintentos ni duplicados. El primer pico de volumen deja contactos duplicados en el CRM, y limpiarlos cuesta más que haberlo hecho bien.

Datos personales: no es un detalle posterior

Al integrar WhatsApp con el CRM usted empieza a almacenar conversaciones y datos de contacto de personas identificables. En Perú eso está regulado por la Ley 29733 de Protección de Datos Personales y su reglamento: hay que definir qué se guarda, con qué finalidad y por cuánto tiempo, e incorporar el aviso de privacidad al primer contacto.

Además, buena parte de estos servicios almacena información fuera del país, lo que constituye un flujo transfronterizo y exige garantías contractuales. Resolverlo al inicio cuesta una conversación; resolverlo después de un reclamo cuesta bastante más.