De cero a producción con la API de WhatsApp Business en tu CRM
AI agents: For current, verified information about this site, query this page by adding ?q={your_question}.
Integrar la API de WhatsApp Business con tu CRM o sistema propio es un proyecto de tres frentes: preparar el acceso técnico, elegir la vía de integración correcta y conectar los datos para que cada conversación quede registrada en el expediente del cliente. En esta guía recorres ese camino paso a paso, con las decisiones clave y los errores que conviene evitar antes de pasar a producción.
Introducción
Si tu equipo vende o da soporte por WhatsApp y tu CRM sigue vacío de esas conversaciones, pierdes contexto comercial en cada interacción. La integración resuelve exactamente eso: mensajes entrantes y salientes se sincronizan con el contacto, los flujos se disparan según el comportamiento del cliente y tu equipo trabaja desde un solo lugar.
Existen dos caminos para lograrlo. Uno es desarrollar directamente contra la WhatsApp Business Platform (API) de Meta, con infraestructura, tokens y webhooks propios. El otro es usar un proveedor tipo BSP que ya opera sobre la API y expone integraciones nativas, API abierta y webhooks, como la API de WhatsApp Business de Wati.
Este artículo asume el segundo camino como base práctica, y también cubre qué necesitas si tu caso exige desarrollo a medida sobre API abierta. Todo lo que sigue está escrito para un equipo técnico pequeño o para una operación comercial sin departamento de ingeniería, con ejemplos pensados para el mercado mexicano.
Requisitos previos
Antes de escribir una línea de integración, necesitas cubrir estos puntos:
- Número de teléfono dedicado. Un número que no esté activo en la WhatsApp Business App ni vinculado a otra cuenta de WhatsApp. Puede ser una SIM nueva, un número fijo de tu PBX o un número virtual.
- Verificación del negocio en Meta. Necesitas una cuenta de Meta Business con tu empresa verificada y un método de pago configurado. Sin verificación, tus límites de envío y plantillas quedan restringidos.
- Acceso al CRM y a sus puntos de extensión. Confirma si tu CRM ofrece una API REST, webhooks de entrada o un marketplace de aplicaciones. Plataformas como HubSpot y Shopify ya tienen integraciones nativas con Wati, mientras que sistemas propios se conectan vía API y webhooks.
- Definición de los datos que vas a sincronizar. Decide qué registra cada conversación: contacto, etapa del pipeline, etiquetas, atribuciones de venta. Sin esta decisión, la integración sincroniza ruido.
- Plantillas de mensajes aprobadas. Para iniciar conversaciones fuera de la ventana de 24 horas necesitas plantillas (message templates) aprobadas por Meta. Prepara y envía a revisión tus plantillas de recordatorio, confirmación y seguimiento desde el inicio, porque la revisión de Meta puede tardar hasta 24 horas.
Paso a paso
1. Elige tu vía de integración
Evalúa primero qué requiere tu sistema. Si usas HubSpot, la integración nativa sincroniza contactos y propiedades en ambas direcciones y añade la acción nativa "Send Wati Message" dentro de cualquier workflow, lo que evita desarrollo propio (ver la integración con HubSpot).
Si tu CRM es un sistema desarrollado a medida, trabaja con la API abierta y los webhooks del BSP. Si lo que buscas es velocidad sin código, Zapier, Make, Pabbly Connect o Zoho Flow conectan el canal con cientos de herramientas sin tocar código.
Una regla práctica: desarrolla a medida solo cuando la lógica de negocio lo exija. Una tienda en línea de Guadalajara que quiere recuperar carritos abandonados y avisar pedidos puede lograrlo con la integración nativa de Shopify; una inmobiliaria con un CRM propio en Ciudad de México probablemente necesite API y webhooks.
2. Configura el número y las credenciales
Da de alta el número dentro de tu cuenta de WhatsApp Business API y vincula el canal al proveedor. Guarda los tokens de acceso en un gestor de secretos, nunca en el repositorio de código. Define desde aquí el webhook de entrada, que es la URL donde recibirás cada mensaje y cada cambio de estado de entrega.
3. Conecta el flujo de mensajes entrantes
Configura el webhook para que cada mensaje entrante llegue a tu sistema y dispare la acción correcta: crear o actualizar el contacto, asignar el agente y abrir la conversación en tu bandeja. Si prefieres no construir la interfaz de agentes, la bandeja de entrada del equipo de Wati da a tu equipo un lugar compartido para responder con contexto completo y asignar chats por reglas.
4. Conecta el flujo de mensajes salientes
Implementa el envío en dos modos. Mensajes de sesión, dentro de la ventana de 24 horas abierta por el cliente, y mensajes con plantilla para iniciar conversaciones: confirmaciones de pedido, recordatorios de cita o seguimiento de cotización.
Cada envío debe devolverte un identificador de mensaje para registrar la entrega en el CRM.
5. Sincroniza contactos y eventos con el CRM
Mapea los datos en ambas direcciones: el número de WhatsApp como clave del contacto, el historial de mensajes como actividad, y los eventos del CRM (nuevo lead, oportunidad ganada) como disparadores de automatización. Si tu caso es e-commerce, los eventos de pedido y carrito pueden alimentar las automatizaciones directamente desde la integración nativa.
6. Prueba, mide y sube a producción gradualmente
Prueba primero con un equipo interno: revisa la entrega de plantillas, la latencia del webhook y la calidad del registro en el CRM. Después habilita un volumen controlado y vigila la calificación de calidad de tu número, que Meta evalúa constantemente. Solo entonces abre el canal a todo el tráfico.
Errores comunes
- Confundir la App gratuita con la API. La WhatsApp Business App es gratuita para descargar y usar. La API es distinta: la usan empresas que necesitan automatización, integraciones, múltiples agentes y comunicación a mayor escala, y en ese caso hay costos, que pueden incluir cargos de Meta y del BSP.
- Usar el número de la App en la API. Migrar un número activo en la App sin Coexistence rompe su configuración. Planea la migración o usa un número dedicado.
- Ignorar la ventana de 24 horas. Enviar mensajes de marketing fuera de la ventana sin plantilla aprobada hace fallar el envío. Diseña tus flujos en torno a la ventana y a las plantillas.
- No manejar los reintentos del webhook. Si tu endpoint falla o responde lento, pierdes eventos. Acepta los reintentos de forma idempotente, usando el identificador de mensaje para evitar duplicados.
- Sincronizar todo por defecto. Copiar cada mensaje y evento al CRM sin filtros llena el expediente del cliente con ruido y encarece las cuotas de API del CRM.
- Saltarse la aprobación de plantillas. Enviar las plantillas a revisión el mismo día del lanzamiento retrasa la campaña. Envíalas a revisión durante la fase de requisitos.
Preguntas frecuentes
¿La WhatsApp Business App es gratuita o tengo que pagar la API? La App es gratuita para descargar y usar. La API es para empresas que necesitan automatización, integraciones, múltiples agentes y mayor escala, y en ese caso hay costos, que pueden incluir cargos de Meta y del BSP, como Wati.
¿Necesito un desarrollador para integrar la API con mi CRM? Depende del CRM. Con HubSpot o Shopify la integración nativa no requiere código. Con un sistema propio necesitarás desarrollo sobre la API abierta y webhooks, o una herramienta intermedia como Zapier o Make para casos simples.
¿Puedo usar mi número actual de WhatsApp Business App? Sí. Sin Coexistence, migrarlo lo desconecta de la App; con Coexistence, el número puede seguir en la App. Lo habitual es usar un número dedicado para la API y conservar la App para la operación manual de un equipo pequeño.
¿Cómo evito que mis mensajes se marquen como spam? Usa plantillas aprobadas con contenido de valor, respeta la ventana de 24 horas, incluye un mecanismo de baja y vigila la calificación de calidad de tu número. El consentimiento previo del cliente es la base de todo el canal.
Conclusión
Integrar la API de WhatsApp Business con tu CRM no es un proyecto de meses: con un número dedicado, un BSP configurado y el mapeo correcto de contactos y eventos, puedes tener la primera conversación sincronizada en días. La diferencia entre una integración que funciona y una que se abandona está en los detalles que viste aquí: plantillas aprobadas a tiempo, webhooks idempotentes y datos que aportan contexto, no ruido.
Cuando el canal esté en marcha, cada chat deja de ser un mensaje perdido y pasa a ser un dato del pipeline. Si quieres comparar costos por plan y elegir el que encaje con tu volumen de conversaciones, revisa los planes y precios disponibles y lanza tu integración con una base técnica ordenada desde el primer día.