--- title: "Integración de WhatsApp con CRM: 3 formas de conectar y sincronizar" description: "Integración de WhatsApp con tu CRM: conectores nativos, middleware o API y webhooks, con flujo de datos, mapeo de campos, consentimiento y una lista para elegir." canonical: "https://omnichannels.ai/es/blog/whatsapp-crm-integration-guide/" language: "es" updated: "2026-11-02" publisher: "BroadNet Technologies" brand: "OmniChannels.ai" category: "integration" primaryQuery: "integración whatsapp crm" keywords: ["integración de WhatsApp con CRM", "conectar WhatsApp a un CRM", "integración WhatsApp HubSpot", "integración WhatsApp Salesforce", "WhatsApp con Zoho CRM", "webhook de la API de WhatsApp Business para CRM", "mapeo de campos WhatsApp CRM"] published: "2026-11-02" author: "OmniChannels.ai Editorial Team" reviewer: "BroadNet Messaging Solutions Team" readingMinutes: 10 answer: "Una integración de WhatsApp con un CRM conecta la API de WhatsApp Business con tu CRM para que los mensajes entrantes, los estados de entrega y los envíos salientes queden vinculados a las fichas de contacto. Hay tres formas de construirla: un conector ya preparado, middleware o herramientas de automatización, o API y webhooks directos. Elige según la lógica que necesites, quién lo mantendrá y lo estricta que deba ser la sincronización del consentimiento." takeaways: ["Integrar WhatsApp con un CRM implica dos flujos de datos: el CRM activa los mensajes salientes mediante una API, y los mensajes entrantes y los estados de entrega vuelven por webhook y actualizan el contacto.", "Los tres enfoques son un conector ya preparado (el más rápido, el menos flexible), middleware o herramientas de automatización (equilibrado) y API más webhooks directos (más control, requiere desarrolladores).", "Identifica a las personas por un número de teléfono normalizado en formato E.164, nunca por el nombre, y guarda el origen y la fecha del consentimiento como campos del CRM.", "Los eventos de webhook pueden llegar duplicados o desordenados, así que guarda el evento en bruto, confirma rápido y procesa de forma asíncrona con deduplicación.", "Los mensajes iniciados por la empresa fuera de la ventana de atención de 24 horas requieren plantillas aprobadas, por lo que tu CRM debe registrar la hora del último mensaje entrante."] faq: - q: "¿Qué es una integración de WhatsApp con un CRM?" a: "Es una conexión entre la API de WhatsApp Business y un CRM para que las conversaciones, los estados de los mensajes y el consentimiento queden asociados al contacto o lead correcto. Normalmente el CRM activa los mensajes salientes desde flujos de trabajo, y los webhooks devuelven los mensajes entrantes y los estados de entrega para actualizar fichas y cronologías. La aplicación WhatsApp Business por sí sola no tiene esa conexión por API." - q: "¿Puedo conectar la aplicación WhatsApp Business a mi CRM?" a: "En general no. Las integraciones con CRM funcionan a través de la WhatsApp Business Platform, la API que usan los proveedores de soluciones empresariales, no de la aplicación Business que se descarga gratis. Registras un número en la plataforma, lo que cambia el modo de usar ese número. Consulta nuestra comparativa entre la API y la aplicación Business antes de trasladar un número que hoy usan agentes desde un móvil." - q: "¿Qué CRM se pueden conectar a WhatsApp?" a: "Cualquier CRM que pueda llamar a una API HTTP o ejecutar webhooks puede conectarse a la API de WhatsApp Business, directamente o mediante una herramienta de automatización. Documentamos los patrones de HubSpot, Salesforce, Zoho CRM, Microsoft Dynamics 365, Zendesk y Freshdesk en nuestras páginas de integraciones. La disponibilidad de acciones integradas depende de tu suscripción al CRM, así que revisa tu plan." - q: "¿Necesito un desarrollador para integrar WhatsApp con un CRM?" a: "No siempre. Los activadores sencillos, como enviar una plantilla cuando cambia la fase de una oportunidad, pueden ejecutarse en una herramienta de automatización o en un flujo del CRM. Hace falta un desarrollador para la lógica de campos a medida, la sincronización bidireccional con deduplicación, las comprobaciones de consentimiento, los reintentos y todo lo que deba escalar. Prevé en cualquier caso una supervisión, porque las integraciones fallan en silencio si no hay alertas." - q: "¿Cómo gestiono el opt-in y el consentimiento en el CRM?" a: "Guarda un campo de consentimiento por canal, junto con el origen, la fecha y el texto mostrado. Compruébalo antes de cada envío de marketing y actualízalo de inmediato cuando alguien se dé de baja. La política empresarial de WhatsApp solo permite contactar a quienes te han dado su número y han dado su opt-in, así que el CRM debe ser el sistema de referencia de ese estado." - q: "¿Puede un agente de IA leer y actualizar mi CRM desde WhatsApp?" a: "Un agente de IA puede usar herramientas para consultar y actualizar registros si lo conectas a tus sistemas, por ejemplo mediante el Model Context Protocol (MCP). Dale permisos acotados, registra cada acción y mantén una vía hacia un agente humano. Nuestro servidor MCP expone la API de mensajería a los clientes MCP; las acciones sobre el CRM necesitan un conector que controles tú." sources: - title: "WhatsApp Business Messaging Policy" url: "https://whatsappbusiness.com/policy/" - title: "Webhooks overview: WhatsApp Business Platform, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview" - title: "Send messages and the customer service window, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/send-messages" - title: "Template categorization, Meta for Developers" url: "https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization" --- # Integración de WhatsApp con CRM: 3 formas de conectar y sincronizar Canonical: https://omnichannels.ai/es/blog/whatsapp-crm-integration-guide/ Language: es Publisher: OmniChannels.ai by BroadNet Technologies Esta guía es para equipos de operaciones comerciales, administradores de CRM y desarrolladores que quieren que las conversaciones y los mensajes de WhatsApp vivan dentro del CRM. Explica las tres formas de conectarlos, los datos que deben viajar en cada dirección y las reglas de consentimiento y fiabilidad que la mayoría de los proyectos pasa por alto. ## ¿Qué es una integración de WhatsApp con un CRM? Una integración de WhatsApp con un CRM es una conexión entre la API de WhatsApp Business y un CRM para que los mensajes, los estados de entrega y el consentimiento queden asociados al contacto, lead o ticket correcto. Siempre implica dos flujos: - **Saliente:** algo en el CRM (el envío de un formulario, una fase de oportunidad, una fecha) activa un mensaje de WhatsApp a través de una API. - **Entrante:** las respuestas de los clientes y los estados de entrega llegan por webhook, se asocian a un contacto y se escriben en el CRM. No lo confundas con un widget lateral que muestra chats. El valor está en los dos flujos y en una identificación limpia de contactos. Para conocer a fondo la mecánica de los webhooks, lee [Cómo conectar un CRM a una bandeja omnicanal con webhooks](/es/blog/connect-crm-omnichannel-inbox-webhooks/). ## ¿Qué necesitas antes de empezar? Necesitas un número de la API de WhatsApp Business, plantillas aprobadas para los mensajes iniciados por la empresa, un CRM que pueda llamar a una API o ejecutar webhooks y un proceso de consentimiento documentado. Lista de comprobación: 1. Un número registrado en la WhatsApp Business Platform (no la aplicación Business gratuita; consulta [API frente a la aplicación Business](/es/blog/whatsapp-business-api-vs-business-app/)). Mira [cómo configurar la API de WhatsApp Business](/es/blog/how-to-set-up-whatsapp-business-api/) y la [lista de preparación](/es/tools/whatsapp-api-readiness-checklist/). 2. Plantillas aprobadas para los mensajes que activará el CRM, en la [categoría](/es/blog/whatsapp-template-categories-approval/) correcta. 3. Números de teléfono guardados en formato [E.164](/es/glossary/e164/) (prefijo de país, sin espacios ni ceros iniciales). 4. Un registro de opt-in por contacto. 5. Un responsable de la integración y un canal de alertas para los fallos. ## ¿Cuáles son las tres formas de integrar WhatsApp con un CRM? Puedes usar un conector ya preparado, middleware o herramientas de automatización, o API y webhooks directos. Cambian rapidez por control. | | Conector ya preparado | Middleware o herramienta de automatización | API y webhooks directos | |---|---|---|---| | Qué es | Una aplicación o función integrada que enlaza un proveedor de mensajería con el CRM | Una herramienta visual de flujos (por ejemplo Zapier, Make o n8n) entre el CRM y la API | Tu propio código que llama a la API REST y recibe webhooks | | Rapidez de arranque | La mayor | Alta | La menor | | Flexibilidad | Limitada a lo que expone el conector | Alta para flujos típicos | La mayor | | Quién lo mantiene | El proveedor del conector | Un analista de negocio | Tus desarrolladores | | Límite habitual | Mapeo de campos fijo; puede no cubrir todos los canales ni objetos personalizados | Límites de tareas, latencia y ejecuciones de la herramienta | Requiere tiempo de ingeniería, supervisión y pruebas | | Ideal para | Necesidades estándar en un CRM compatible | Equipos sin desarrolladores; prototipos | Lógica compleja, gran volumen, reglas de consentimiento estrictas | Desconfía de cualquier afirmación de que un conector "funciona sin más". Pregunta qué hace cuando un webhook llega dos veces, qué hace cuando un número coincide con dos contactos y cómo se comprueba el consentimiento. Una nota sobre nuestro enfoque: OmniChannels.ai se integra mediante su API REST, webhooks y herramientas de automatización, y nuestras páginas de integraciones dicen claramente que no existe una aplicación en un marketplace para estos CRM. ### ¿Qué enfoque deberías elegir? 1. Si tu CRM tiene un conector que cubre tu caso de uso y los campos de consentimiento, empieza por ahí. 2. Si necesitas activadores y actualizaciones de campos pero ningún código a medida, usa middleware. 3. Si necesitas lógica a medida, gran volumen o trazabilidad, usa la API directamente, quizá con middleware como paso previo. 4. Elijas lo que elijas, prueba primero con tus propios números verificados. ## ¿Cómo fluyen los datos? Una imagen paso a paso Dicho con palabras, el flujo funciona así. **Saliente** 1. Se dispara un flujo del CRM (por ejemplo, un lead nuevo con consentimiento). 2. El flujo o el middleware comprueba el consentimiento y la hora del último mensaje entrante. 3. Llama a la API de mensajería con el número E.164 del contacto y una plantilla aprobada, o con un mensaje libre si la ventana de 24 horas está abierta. 4. La API devuelve un ID de mensaje, que guardas en la cronología del contacto. **Entrante y estados** 5. WhatsApp entrega la respuesta de un cliente a la plataforma, que envía un evento a la URL de tu webhook. 6. Tu endpoint guarda el cuerpo en bruto, responde con un 2xx y pone el evento en cola. 7. Un proceso asocia el número del remitente a un contacto, crea uno si el proceso lo permite y registra el mensaje. 8. Los eventos de estado (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED en nuestro formato normalizado) actualizan el mensaje guardado, sin retroceder nunca un estado. 9. Se activan reglas: asignar un propietario, crear una tarea, mover una fase de oportunidad o etiquetar el contacto. Meta describe el webhook de mensajes de WhatsApp como el que cubre los mensajes de los usuarios y el estado de los mensajes que has enviado. Nuestra [documentación de webhooks](/developers/webhooks/) explica los estados de entrega, los reintentos y qué hacer cuando faltan eventos. Los campos de la carga varían según el canal, así que registra los eventos en bruto y haz el mapeo a partir de muestras reales de tu cuenta. ## ¿Qué campos conviene mapear entre WhatsApp y el CRM? Mapea un conjunto reducido de identificadores estables y campos de estado, y deja el contenido de los mensajes fuera del CRM salvo que lo necesites. | Campo del CRM (sugerido) | Origen | Dirección | Notas | |---|---|---|---| | Teléfono móvil (E.164) | CRM o formulario | CRM → API | Normalízalo antes de enviar; valídalo con consultas si hace falta | | Consentimiento de WhatsApp (sí/no/retirado) | Captura del opt-in | El CRM es la fuente de verdad | Compruébalo antes de cada envío de marketing | | Origen y fecha del consentimiento | Formulario, QR, chat o casilla | CRM | Guarda el texto que se mostró al cliente | | Idioma preferido | CRM | CRM → API | Elige el idioma de la plantilla | | Hora del último mensaje entrante | Webhook | API → CRM | Indica si la ventana de 24 horas está abierta | | Último estado del mensaje | Webhook | API → CRM | Actualizaciones solo hacia delante | | ID del mensaje | Respuesta de la API | API → CRM | Necesario para asociar estados a entradas de la cronología | | Enlace a la conversación | Bandeja | API → CRM | Permite al comercial abrir el hilo con un clic | | Propietario o agente asignado | CRM o bandeja | Ambas | Define qué sistema gana en caso de conflicto | | Fase del ciclo de vida o etiquetas | CRM | CRM → bandeja | Permite a los agentes ver el contexto de la oportunidad | Crea estas propiedades personalizadas desde el principio; cambiar los tipos de campo tras el lanzamiento es doloroso. ## ¿Cómo sincronizas el consentimiento entre WhatsApp y el CRM? Trata el CRM como el sistema de referencia del opt-in y compruébalo antes de cada mensaje de marketing iniciado por la empresa. La política empresarial de WhatsApp solo permite contactar a quienes te han dado su número y han aceptado recibir tus mensajes, y espera que respetes las solicitudes de bloqueo, de interrupción o de baja. Un conjunto de reglas viable: 1. Captura el consentimiento con una declaración clara de lo que recibirá la persona y por qué canal. 2. Guarda el consentimiento por canal, con origen, fecha y texto. 3. Actualiza el consentimiento de inmediato ante un mensaje de baja o un bloqueo. 4. Haz que el paso de envío lea el campo, no una lista en caché. 5. Mantén separadas las conversaciones de servicio (respuestas al propio mensaje del cliente) y los envíos de marketing. Lee [opt-in y consentimiento en campañas multicanal](/es/blog/opt-in-consent-multichannel-campaigns/) y genera textos con el [generador de consentimiento opt-in](/es/tools/opt-in-consent-generator/). ## ¿Cómo haces fiable la integración? Confirma los webhooks rápido, guarda antes de procesar y haz que el procesamiento sea idempotente. - **Guarda, confirma y después procesa.** Las llamadas lentas al CRM dentro del manejador provocan reintentos y duplicados. - **Deduplica** por ID de mensaje; trata el mismo evento recibido dos veces como una operación nula. - **Cuenta con eventos desordenados.** Un SENT tardío no debe sobrescribir un DELIVERED. - **Limita la frecuencia de tus llamadas al CRM** y espera más tiempo ante los errores. - **Asocia contactos con seguridad.** Normaliza los números, gestiona de forma deliberada dos contactos con el mismo número y no fusiones nunca solo por el nombre. - **No reenvíes nunca desde un manejador de webhook.** Decide los reintentos en un trabajo aparte tras comprobar el estado. - **Protege el endpoint.** Usa HTTPS, una ruta imposible de adivinar y validación de la forma del cuerpo. Meta documenta mTLS para sus propios webhooks; para los nuestros, consulta la página de webhooks. - **Supervisa.** Alerta ante fallos de webhook, profundidad de la cola y caídas de eventos entrantes. ## ¿Qué CRM y herramientas documentamos? Documentamos patrones de varios sistemas en nuestras páginas de integraciones. Ninguna describe una aplicación de marketplace; cada una explica cómo usar la API REST y los webhooks con ese producto. | Sistema | Patrón típico | Página | |---|---|---| | HubSpot | Código personalizado de un flujo o acción de webhook, o una herramienta de automatización | [HubSpot](/es/integrations/hubspot/) | | Salesforce | Llamada HTTP desde Flow o llamada Apex con una Named Credential | [Salesforce](/es/integrations/salesforce/) | | Zoho CRM | Webhook de flujo de trabajo o función Deluge | [Zoho CRM](/es/integrations/zoho-crm/) | | Microsoft Dynamics 365 | Flujo de Power Automate | [Dynamics 365](/es/integrations/dynamics-365/) | | Zendesk | Webhook activado por un trigger; herramienta de automatización para las respuestas | [Zendesk](/es/integrations/zendesk/) | | Freshdesk | Webhook de regla de automatización; herramienta de automatización para las respuestas | [Freshdesk](/es/integrations/freshdesk/) | | Herramientas de automatización | Zapier, Make, n8n | [Zapier](/es/integrations/zapier/), [Make](/es/integrations/make/), [n8n](/es/integrations/n8n/) | Las acciones disponibles dentro de un CRM dependen de tu plan con ese proveedor, así que confírmalas en su documentación. ## ¿Pueden los agentes de IA trabajar con tu CRM y WhatsApp? Sí, si das al agente herramientas controladas. El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA llamar a herramientas externas. Nuestro servidor MCP expone la API de mensajería (envío, plantillas, informes de entrega) a los clientes MCP con los permisos del token que facilites; leer o actualizar registros del CRM requiere un conector que controles tú. Empieza con consultas de solo lectura, añade acciones de escritura una a una y registra todo. Consulta [la guía del servidor MCP de WhatsApp](/es/blog/whatsapp-mcp-server-ai-agents/) y [agentes de IA para atención al cliente](/es/blog/whatsapp-ai-agent-customer-service/). ## Ejemplo práctico: una inmobiliaria de Yeda "Red Sea Homes", una agencia ficticia, quiere que cada consulta sobre un inmueble reciba una respuesta por WhatsApp y que cada conversación aparezca en la ficha del lead. 1. Una consulta desde un portal crea un lead con el teléfono en E.164 y una casilla de consentimiento del formulario. 2. Un flujo comprueba el consentimiento, envía una plantilla de utilidad aprobada que acusa recibo de la consulta y guarda el ID del mensaje. 3. El cliente responde; el webhook actualiza la "hora del último mensaje entrante" y asigna el propietario del lead. 4. El propietario responde durante 24 horas desde la bandeja con mensajes libres. Tras un silencio, el siguiente seguimiento es una plantilla aprobada, categorizada y con consentimiento. 5. Un cambio de fase a "visita reservada" envía una plantilla de recordatorio el día anterior. 6. Cada semana, el equipo revisa los envíos fallidos y los números que no coinciden. Consulta [seguimiento de leads inmobiliarios por WhatsApp](/es/blog/real-estate-lead-follow-up-whatsapp/) para la parte de mensajería. ## ¿Qué errores conviene evitar? - Asociar contactos por nombre o por números sin formato. - Saltarse el campo de consentimiento y fiarse de la memoria. - Procesar dentro del manejador del webhook y agotar el tiempo de espera. - Enviar contenido de marketing dentro de una plantilla categorizada como utilidad; la categoría la decide Meta. - Olvidar que fuera de la ventana de 24 horas solo se pueden enviar plantillas. - Dejar que ambos sistemas editen el mismo campo sin una regla sobre cuál gana. - No tener alertas, de modo que un webhook roto pasa semanas sin que nadie lo note. ## Cómo ayuda OmniChannels.ai OmniChannels.ai, con tecnología de BroadNet Technologies, ofrece una API REST/JSON, webhooks para los estados de entrega, la Omni Inbox para las conversaciones de los agentes y un servidor MCP para agentes de IA. BroadNet es proveedor oficial de soluciones empresariales de Meta (Meta Business Solution Provider), y nuestro equipo gestiona contigo la incorporación y los registros de WhatsApp. Los desarrolladores pueden empezar en la [documentación de la API](/es/developers/) y en la [guía de la API de WhatsApp](/developers/whatsapp/); el acceso de pruebas se limita a tus propios números verificados y no hay alta autoservicio inmediata.