Inicio » Software » Guía definitiva para integrar WhatsApp con Odoo: opciones, pasos y trucos (2026)
Guía definitiva para integrar WhatsApp con Odoo: opciones, pasos y trucos (2026)
La integración de WhatsApp con Odoo está regulada por la API oficial de Meta y requiere cumplir requisitos técnicos concretos.
Odoo Enterprise (v16+) ofrece integración nativa, mientras que Community puede optar por módulos de la OCA o marketplace y soluciones externas como Twilio.
Las posibilidades y límites (ventanas de conversación, uso de plantillas, tipos de mensajes) vienen determinados por las políticas de WhatsApp Business API.
En el entorno empresarial actual, la comunicación directa y eficiente con clientes y contactos es un factor crucial para la competitividad de cualquier compañía. WhatsApp, con su enorme adopción global, se ha convertido en el canal favorito de millones de personas, y no sorprende que las empresas busquen formas prácticas de integrarlo con sus herramientas de gestión como Odoo.
Sin embargo, aunque la idea de conectar WhatsApp con tu ERP parece simple, la realidad es mucho más matizada y técnica de lo que se suele pensar. La integración de WhatsApp con Odoo involucra múltiples actores, normativas y requisitos impuestos por Meta (propietario de WhatsApp) y las propias restricciones del sistema, lo que hace imprescindible contar con una guía clara, completa y a la vez natural y práctica como la que encontrarás a continuación.
Esta mega guía cubre desde los fundamentos básicos de la integración, los diferentes tipos de soluciones (nativas y externas), sus limitaciones reales, requisitos, pasos técnicos detallados, comparativas, errores comunes y hasta casos de uso específicos, para que puedas tomar una decisión informada y evitar sorpresas que habitualmente complican la implementación en el mundo real. Hemos reunido y actualizado la información más útil y reciente de la documentación oficial de Odoo, foros, expertos y comunidades técnicas. Además, encontrarás trucos para Community y Enterprise, consejos para empresas con varios comerciales, alternativas con Twilio y otras plataformas, y una visión realista tanto del potencial como de las limitaciones de las integraciones disponibles.
¿Integrar WhatsApp con Odoo es posible y recomendable?
La integración entre WhatsApp y Odoo es completamente posible y cada vez más utilizada en empresas de todos los tamaños y sectores. Eso sí, hay varios matices a considerar. Aunque Odoo cuenta con un módulo oficial para WhatsApp Business API en sus versiones Enterprise más recientes, la edición Community y versiones anteriores requieren otras alternativas, ya sea mediante módulos de la OCA o soluciones de terceros.
No se trata de convertir Odoo en un «WhatsApp de escritorio» tradicional, sino de permitir la gestión, envío y recepción estructurada de mensajes, notificaciones y ciertas respuestas con trazabilidad y contexto CRM de cliente. Las reglas del juego, además, las pone Meta: hay limitaciones estrictas que debes conocer antes de lanzarte, especialmente si tu negocio necesita agilidad, flexibilidad o cumple normativas específicas.
Integración nativa con Odoo Enterprise: Ventajas y funcionamiento
Desde la versión 16, Odoo Enterprise ofrece un módulo de integración nativo con la API de WhatsApp Business, lo que supone importantes ventajas para empresas que buscan estabilidad, soporte oficial y facilidad de uso. Entre los puntos fuertes de esta integración destacan:
Envío y recepción directos desde la plataforma Odoo
Centralización de la comunicación junto a correos, SMS y notificaciones dentro del ERP
Gestión y almacenamiento automatizado del historial de conversaciones
Automatización de tareas: mensajes automáticos, recordatorios, notificaciones logísticas, respuesta a eventos como ventas o soporte
Creación y uso de plantillas homologadas de WhatsApp Business, tanto en Meta como en Odoo
Compatibilidad con múltiples números de WhatsApp bajo una misma cuenta empresarial
Notificaciones centralizadas para usuarios/departamentos responsables
Integración fluida con otros módulos de Odoo (CRM, Ventas, Soporte, Facturación, etc.)
Cabe destacar que la activación y configuración de esta integración es orientada y sencilla, siempre que cumplas los requisitos previos exigidos por Meta para acceder a la API oficial de WhatsApp Business, como contar con una cuenta de Meta Business Manager verificada, número dedicado y aplicación creada en la consola de desarrolladores de Meta.
Alternativas para usuarios de Odoo Community (y versiones previas)
La versión Community de Odoo no dispone del módulo nativo de WhatsApp. Sin embargo, esto no significa que no puedas integrarlo. Existen dos vías principales:
OCA Mail WhatsApp Gateway permite bidireccionalidad y flexibilidad, aunque requiere mayor configuración técnica y revisión de compatibilidad según la versión.
Website WhatsApp de OCA añade el popular botón flotante en la web, facilitando el contacto con clientes desde la propia página.
Entre los más populares destacan All-in-One WhatsApp Connector o similares, que ofrecen funciones de mensajería, notificación y plantilla.
Conviene comprobar compatibilidad, licencia y soporte antes de adquirirlos, y leer valoraciones previas de otros usuarios y empresas.
La integración vía OCA o módulos de marketplace requiere mayor involucración técnica en la configuración, pero ofrece una personalización avanzada y flexibilidad. Es ideal para empresas con departamentos IT ágiles, necesidades particulares o aquellas que buscan evitar costes adicionales de suscripción.
Cómo funciona realmente la API de WhatsApp Business y sus limitaciones
La integración de WhatsApp Business con Odoo tiene ciertas reglas obligatorias impuestas por Meta:
Sólo permite enviar mensajes a través de plantillas preaprobadas por Meta (facturas, confirmaciones, recordatorios, etc.), a menos que recibas primero un mensaje del cliente. Esto tiende a confundir a usuarios que esperan poder iniciar libremente chat con cualquier contacto.
Ventana de conversación de 24 horas para respuestas: tras recibir un mensaje de un cliente, puedes contestar libremente, pero si la ventana expira deberás recurrir obligatoriamente a plantillas aprobadas.
No está permitido usar números personales de WhatsApp ni WhatsApp Business estándar para acceder a la API, es obligatorio un número dedicado y exclusivamente registrado en el canal API.
No es viable replicar experiencias «chat grupal» o similares desde Odoo, ni gestionar difusión masiva tradicional.
Para iniciar conversaciones proactivas fuera del periodo de 24 horas, sólo podrás utilizar plantillas aprobadas por Meta.
Todo esto está pensado para proteger a los usuarios de WhatsApp frente al marketing invasivo y el spam, y no depende de Odoo, sino que está codificado en el funcionamiento de la API proporcionada por Meta. Conviene estudiar bien estos límites antes de tomar decisiones estratégicas sobre el canal.
Comparativa: Odoo Enterprise VS OCA/community VS soluciones externas (Twilio, Callbell…)
Característica
Odoo Enterprise (nativo)
Odoo Community (OCA / Marketplace)
Soluciones externas (Twilio, Callbell…)
Integración
Directa y guiada por Odoo
Configuración manual, mayor flexibilidad
Integración vía APIs intermedias con posibilidad de más canales
Mensajería bidireccional
Sí
Sí
Sí
Automatización
Reglas CRM, recordatorios, plantillas automáticas
Personalizables por desarrollador
Potentes, además de SMS, Email o Voz
Múltiples números
Sí, oficialmente soportado
Requiere ajustes técnicos (varía por módulo)
Sí, sin límite en general
Soporte y actualizaciones
Oficial de Odoo
Comunidad y desarrolladores independientes
Soporte externo, correspondiente a la plataforma contratada
Botón web flotante
No incluido nativo
Sí, vía Website WhatsApp (OCA)
Varía según el proveedor externo
Costos
Suscripción Odoo Enterprise
Generalmente sólo la implementación inicial
Coste recurrente (Twilio, Callbell, etc.)
La elección dependerá del tamaño de tu empresa, presupuesto, recursos técnicos y prioridad estratégica del canal WhatsApp para tu negocio. Enterprise es ideal para quienes buscan sencillez, soporte y menor mantenimiento, mientras que Community y Marketplace destacan en personalización y coste ajustado. Las plataformas externas son la mejor opción si buscas multicanalidad o si ya empleas esos proveedores para otros servicios.
Limitaciones frecuentes y dudas comunes sobre integrar WhatsApp y Odoo
A lo largo de la experiencia de muchos usuarios y desarrolladores, han surgido dudas habituales y ciertas problemáticas que es importante conocer para evitar frustraciones y retrasos:
“¿Puedo usar varios números de WhatsApp en Odoo?”
Sí, la integración nativa soporta varios números (especialmente desde Enterprise v16), y módulos de la OCA pueden replicar esta funcionalidad, aunque requieren configuración más avanzada.
“¿Mis comerciales pueden usar su propio número conectado simultáneamente?”
Sólo si cada comercial tiene una cuenta API separada y está correctamente configurada, lo que multiplica la complejidad de gestión y altas en la plataforma Meta Business Manager.
“¿WhatsApp Web sigue funcionando en el móvil tras integrar el número con Odoo?”
No, un número dado de alta en WhatsApp API pierde la posibilidad de uso en la app móvil estándar: ni WhatsApp Web ni la app funcionarán, sólo a través de las integraciones/API.
“¿La integración sustituye a un chat real de WhatsApp?”
No es un reemplazo del chat tradicional. Permite enviar comunicaciones y recibir respuestas sólo dentro de los límites detallados antes.
“¿Qué ocurre si recibo el error 190 o problemas con los tokens de acceso?”
Normalmente este error indica caducidad del token temporal. Debes generar y asignar un token permanente desde Meta Business Suite, asegurando el rol adecuado del usuario en la plataforma.
“¿Es posible enviar mensajes a más de un contacto a la vez?”
Sí, siempre que la plantilla esté configurada con la función de «varias plantillas». Meta limita estos envíos para prevenir spam masivo.
“¿Qué tipo de mensajes/plantillas puedo crear en Odoo para WhatsApp?”
Puedes diseñar plantillas para presupuestos, facturas, recordatorios, notificaciones de eventos, autenticaciones y mensajes marketing aprobados. Existen opciones de botones rápidos, enlaces y marcadores de posición dinámicos.
Requisitos imprescindibles para integrar WhatsApp con Odoo
Antes de intentar la integración, asegúrate de tener preparados todos los siguientes puntos. Su ausencia puede darte muchos quebraderos de cabeza:
Cuenta de Meta Business Manager verificada y activa (no personal)
Número de teléfono exclusivo para WhatsApp API (no usado antes en WhatsApp Web ni Business)
Aplicación creada en Meta Developers con WhatsApp como producto activado
Credenciales técnicas listas: Token, ID de cuenta, ID de aplicación y de número de teléfono
Versión Odoo Enterprise 16 o superior para la integración nativa, o el módulo correspondiente para Community/Marketplace
Plantillas preaprobadas por Meta según necesidades específicas de negocio
Permisos técnicos para modificar la configuración avanzada en Odoo
Proceso paso a paso para integrar WhatsApp con Odoo (Guía completa)
Crea tu cuenta de Meta Business Manager: Visita , proporciona los datos de la empresa y verifica el email corporativo. Es fundamental que sean datos válidos y contrastables, ya que Meta realiza comprobaciones exhaustivas.
Accede a Meta for Developers y crea una nueva aplicación «Negocios». Asígnale un nombre identificador claro, como «OdooPro» o similar, y asocia el email corporativo de contacto.
Añade WhatsApp como producto en la aplicación creada. Elige tu cuenta Business Manager cuando se solicite.
Registra tu número de empresa para la API. ¡Importante! Debe ser un número nuevo o previamente dado de baja de WhatsApp. Meta envía un código de confirmación.
Copia las credenciales generadas en Meta Developers: Token de acceso, ID del número, ID de la app y de la cuenta.
En Odoo, accede a Configuración > WhatsApp e introduce las credenciales.
Prueba la conexión con el botón «Probar Conexión». Si hay errores, revisa tokens y permisos, y asegúrate de que el número está en estado «Conectado» en Meta Developers.
Crea y aprueba las plantillas de mensajes necesarias (puedes hacerlo desde Meta o en Odoo Enterprise, sincronizando luego ambas bases de datos).
Para Community, revisa el readme, dependencias y sigue instrucciones específicas de configuración en el repositorio Github o marketplace del conector elegido.
Webhooks, tokens y otros términos técnicos relevantes
Una parte clave de la integración es la correcta gestión de webhooks y tokens de acceso.
Webhooks: Son URLs públicas a las que Meta envía notificaciones automáticas cada vez que hay un nuevo mensaje o evento. Debes configurar la URL y token de verificación en el panel de Meta Developers, y vincularlo con Odoo.
Token temporal y permanente: Al principio, sólo tendrás acceso a un token temporal; lo recomendable para entornos de producción es generar inmediatamente un token permanente mediante la creación de un «usuario del sistema» en Meta Business Suite, otorgando los permisos necesarios (business_management, whatsapp_business_messaging, whatsapp_business_management, whatsapp_business_manage_events).
Si usas Community: Algunos módulos emplean un intermediario gateway y requieren pasos extra en la configuración y gestión de permisos. Consulta la documentación y foros especializados.
Flujos de comunicación: Quién puede iniciar contacto y qué ocurre después
Los flujos habituales son:
La empresa inicia la comunicación: Sólo posible mediante mensajes basados en plantillas autorizadas y a contactos que hayan dado consentimiento previamente. Una vez respondan, dispones de 24 horas para seguir chateando.
El cliente inicia la conversación: Cuando el cliente escribe por WhatsApp, Odoo abre/crea la conversación en el modulo de Conversaciones, asignando los operadores responsables del canal.
Gestión de grupo de operadores: Puedes añadir usuarios del ERP a un chat desde la interfaz, para coordinar con varios agentes en soporte o ventas.
Plantillas de mensajes: Cómo crearlas, gestionarlas y aprobarlas
Las plantillas de mensaje son el mecanismo central de WhatsApp API.
Cada plantilla debe enviarse a aprobación por Meta, especificando categoría (marketing, utilidad, autenticación), idioma y variables dinámicas (como nombre del cliente, número de pedido, etc.).
Se pueden crear desde Odoo o desde la consola Meta; tras aprobación hay que sincronizarlas para que sean utilizables en la plataforma ERP.
Las plantillas pueden llevar botones interactivos (respuesta rápida, enlace a web, llamada a número) y marcadores de posición para información personalizada.
Gestiona todas las plantillas y sus variables desde Odoo o Meta para evitar duplicados y errores comunes durante la sincronización.
Revisa frecuentemente que no hay plantillas duplicadas (tanto en Meta como en Odoo). Si surge el error de validación, simplemente cambia el nombre y vuelve a sincronizar.
Notificaciones y gestión de usuarios en los chats
Odoo permite gestionar qué usuarios recibirán notificaciones instantáneas cuando un cliente contacte por WhatsApp. Desde la configuración del canal puedes seleccionar responsables o añadir más usuarios para una atención eficiente. Los mensajes aparecen como pop-ups o en la bandeja Conversaciones.
También es posible expandir el chat y agregar nuevos participantes internos en la conversación sobre la marcha, facilitando la colaboración entre agentes de ventas, soporte y otros departamentos.
Casos de uso avanzados tras la integración
Confirmaciones e información de pedidos, presupuestos y facturas automáticas y directamente en WhatsApp, mejorando la velocidad de apertura y respuesta frente al email tradicional.
Recordatorios de pago automatizados desde el módulo de facturación, incluyendo PDF adjunto y textos dinámicos, incrementando el cobro puntual.
Atención al cliente unificada desde el módulo Conversaciones de Odoo, con acceso a todo el histórico de interacciones y documentos del cliente, optimizando los tiempos de respuesta y evitando perder información.
Automatización en el CRM para comerciales: envío y registro de comunicaciones a leads y clientes desde la ficha, sin la dispersión del WhatsApp personal de cada empleado.
Notificaciones logísticas automáticas de envíos, incidencias y entregas desde módulos de gestión de stock o compras.
Errores comunes y cómo solucionarlos
Error 190 (token expirado): Solución: genera un token permanente desde Meta, revisa que tengas el rol de «administrador de producto» y no sólo de desarrollador básico.
Error 100 (usuario incorrecto al generar token): Comprueba que estés usando un sistema user con permisos completos y no un empleado estándar.
Errores y excepciones en edición de plantillas: Sigue escrupulosamente el proceso paso a paso, asegurando que todos los marcadores y variables están mapeados según el modelo correspondiente.
No recibes mensajes en la cuenta Odoo: Revisa la configuración del webhook, la url pública, el identificador de cuenta y la sintaxis de solicitud en el panel de Meta Developers.
No se pueden enviar plantillas a varios contactos: Activa la opción «varias plantillas» y comprueba limitaciones meta.
Errores con el estado «pendiente» tras conectar número nuevo: Genera un token de acceso temporal, activa el acceso completo, y vuelve a asociar el número hasta que quede en estado «conectado».
Dificultad para lograr permisos business_management: Solo aplicaciones tipo «Empresa» las reciben por defecto, y la cuenta creadora necesita tener perfil de «Administrador» o «Gerente de producto» en Meta.
Preguntas frecuentes y problemas reales
¿Debo realizar la verificación comercial con documentos legales? Sí, desde 2023 Meta exige este paso para accesos avanzados, implicando el envío de CIF, escrituras, etc.
¿Hay errores o límites en la cantidad de mensajes/plantillas? Meta impone límites iniciales que pueden ampliarse progresivamente con uso y buena reputación del número.
¿Qué ocurre si dos plantillas tienen el mismo nombre en Odoo y Meta? Producirá error en la sincronización. Renombra una de ellas para subsanarlo.
¿La interfaz WhatsApp de Odoo sustituye completamente la app móvil? No, son contextos y usos distintos, pero permite centralizar lo esencial para la empresa, ahorrando mucho tiempo y evitando dispersión.
Recomendaciones y buenas prácticas tras la integración
Prepara todos los campos y flujos de negocio antes de solicitar la aprobación de plantillas, para evitar retrasos y rechazos por parte de Meta.
Configura mensajes automáticos de ausencia y bienvenida, así como asignación de responsables a cada canal, para gestionar expectativas de clientes y evitar tiempos muertos.
Revisa periódicamente los permisos dados a la app en Meta Business Suite y mantén los tokens activos y protegidos.
Haz pruebas exhaustivas con números de prueba antes de mover la integración a producción, involucrando a todos los departamentos afectados.
Establece procedimientos internos para la gestión de conversaciones, asignando responsables claros y tiempos de respuesta pactados.
Enlaces útiles y recursos para ampliar información
