Coexistence for WhatsApp — la guía completa

Requiere Odoo Enterprise 17, 18, 19 o 20. Extiende la app nativa de WhatsApp de Odoo, que solo existe en Enterprise, así que no se instala en Odoo Community. Odoo.sh y on-premise; no disponible en Odoo Online. La instancia tiene que ser accesible desde internet por HTTPS, porque Meta entrega los mensajes entrantes a un webhook en tu propio dominio.

Conserva el número en el celular. Súmale Odoo.

La vía normal a la Cloud API de WhatsApp te pide renunciar al número: una vez migrado, deja de funcionar en la app WhatsApp Business del celular. Para un negocio cuyo historial de ventas entero vive en esa app, eso es descartable.

Coexistence es la respuesta oficial de Meta, y este módulo la trae a Odoo. Escaneas un código QR y, desde ese momento, el mismo número funciona en los dos sitios a la vez: tu equipo sigue respondiendo desde el celular y Odoo lo ve todo.

Cómo funciona

• Los mensajes que tu equipo escribe en el celular aparecen en Odoo como mensajes salientes en el hilo del cliente, así que el historial queda completo.
• Los mensajes que envían los clientes llegan a Odoo por el webhook, exactamente igual que con un número dedicado de Cloud API.
• Odoo también puede enviar: respuestas dentro de la ventana de 24 horas y plantillas aprobadas.
• Tus contactos y hasta seis meses de historial se pueden importar una vez, al conectar, con la sincronización única de Meta.

Qué incluye

• El número se queda en el celular. Tu equipo sigue respondiendo desde la app WhatsApp Business. No se migra nada.
• Onboarding por QR. El Embedded Signup de Meta dentro de Odoo. Sin SMS, sin número nuevo, sin IDs que teclear a mano.
• Respuestas del celular reflejadas en Odoo. Los ecos salientes caen en el mismo hilo, deduplicados por id de mensaje, así que nada aparece dos veces.
• Todo en Conversaciones. Entrantes y salientes en canales normales de Discuss, sobre contactos normales.
• Importación única de historial. Contactos y hasta seis meses de conversaciones, importados al conectar.
• Cero configuración de webhook. La cuenta genera su propia Callback URL y su Verify Token y se suscribe sola.
• Varios números, una base de datos. Cada número es su propia cuenta, con sus usuarios y su restricción de compañía.
• Siete idiomas. Inglés, español, portugués, italiano, francés, alemán y árabe.

Un recorrido en tres pantallas

Requisitos

Dos formas de tener permiso para usar Coexistence

WhatsApp Coexistence se activa a través del Embedded Signup de Meta, que solo funciona con una app registrada ante Meta como Tech Provider y aprobada para la función WhatsApp Business App Onboarding. Una app de desarrollador normal no puede hacerlo. Hay dos formas de cumplir ese requisito:

Con una licencia de RC Studio. Compras una clave de licencia, la pegas en Odoo y conectas escaneando un código QR. Nada que registrar en Meta, sin revisión de app, sin listas de dominios. La licencia se factura aparte de este módulo y no está incluida en su compra.

Con tu propia app de Tech Provider, o la de un tercero. Este módulo funciona con cualquiera de ellas. Introduces el App ID, el App Secret y la Login Configuration que te da tu proveedor, y la conexión corre por su app de Meta en lugar de la de RC Studio. Esas credenciales las emite ese proveedor, no RC Studio. RC Studio no puede obtenerlas por ti y no se hace responsable si tu proveedor no te las entrega, las revoca, cobra aparte por ellas o no ha sido aprobado por Meta para la función WhatsApp Business App Onboarding. Confirma con tu proveedor que recibirás un App ID, un App Secret y una Login Configuration de coexistence antes de comprar este módulo.

Modo A · Coexistence con licencia de RC Studio (recomendado)

Toda la configuración es: pegar la clave, pulsar Conectar, escanear el QR. Nada que registrar en Meta, sin revisión de app y sin dominios que autorizar, porque el diálogo de Facebook corre en la propia página de RC Studio.

Los tres pasos que ves de verdad, en modo licencia

Meta permite una sola sincronización de contactos y una sola de historial por onboarding. Si fallan, la única forma de repetirlas es desvincular el número y volver a conectarlo.

Modo B · Coexistence con tu propia app de Tech Provider

Funciona con tu propia app o con la de cualquier otro proveedor. En ambos casos la app debe estar aprobada por Meta para la función WhatsApp Business App Onboarding, y el App ID, el App Secret y la Login Configuration te los entrega ese proveedor. RC Studio no puede obtenerlos y no se hace responsable si el proveedor no los entrega.

• Deja vacía la licencia de RC Studio.
• Rellena App ID y App Secret de tu app.
• Rellena Meta Login Configuration con el ID de tu configuración de «Facebook Login for Business».
• Añade tu dominio de Odoo a la app de Meta, en Dominios de la app y Dominios permitidos para el SDK de JavaScript. Este paso no tiene API y hay que hacerlo a mano por cada dominio.
• Pulsa Conectar por Coexistence y sigue con el QR.

En el modo B no hay ventana de RC Studio: el diálogo de Facebook se abre directamente desde tu propia página de Odoo, sobre tu propia app.

Webhook

No hay nada que pegar en Meta, en ninguno de los dos modos. La cuenta genera su propia Callback URL y su Webhook Verify Token y los registra en Meta como parte de la conexión del número, suscribiéndose al campo messages y a smb_message_echoes. Si tu URL de Odoo cambia alguna vez, el botón Resuscribir webhook del formulario de cuenta apunta Meta a la nueva, y Quitar override de webhook lo deshace.

Roles

Dónde viven las conversaciones

En Conversaciones (Discuss), exactamente donde las pone la app de WhatsApp propia de Odoo: un canal por cliente en el número que recibió el mensaje. Respondes desde Discuss con adjuntos, emoji, citas y reacciones. Este módulo cambia cómo se conecta el número, no dónde respondes.

Una lista de conversaciones con buscador, filtro de no leídos y selector por número no forma parte de este módulo. Viene de WhatsApp: Single Thread and Inbox, que se vende e instala aparte; WhatsApp: Account Icon on Threads añade el icono de color por número. Coexistence funciona sin ninguno de los dos.

Responder desde Discuss

Las mismas conversaciones aparecen en Discuss, bajo la categoría WhatsApp, útil para quien ya vive en Discuss y prefiere no cambiar de pantalla. Cuando un compañero responde desde el celular, Coexistence refleja ese mensaje en el mismo canal como mensaje saliente.

Enviar una plantilla desde un documento

Cada cotización, factura, orden de entrega y contacto tiene un botón WhatsApp en el chatter. Elige la plantilla, revisa la vista previa con los datos ya sustituidos y envía. El mensaje queda en el chatter del documento y en el hilo del cliente.

Envíos automáticos

Ajustes → Técnico → Acciones de servidor → Nuevo, tipo Enviar WhatsApp, elige la plantilla. Dispárala desde una regla de automatización —al confirmar un pedido, por ejemplo— o desde el menú de acciones de una vista de lista para enviar a muchos registros a la vez.

Estados y reintentos

WhatsApp → Mensajes conserva cada mensaje con su estado: en cola, enviado, entregado, leído, respondido, error o rebotado, con el código de error de Meta cuando lo hay. Los fallidos se pueden reenviar seleccionándolos y ejecutando WhatsApp: reenviar mensajes fallidos. Un cron reintenta la cola cada hora.

La ventana de 24 horas y la baja

Veinticuatro horas después del último mensaje del cliente, WhatsApp solo permite plantillas. El redactor se bloquea y ofrece un botón para reabrir la conversación con una plantilla. Si un cliente responde STOP, UNSUBSCRIBE o STOP PROMOTIONS, Odoo pone el número en la lista negra y deja de enviarle. Esas son las palabras que reconoce la app de WhatsApp de Odoo.

Preguntas frecuentes

¿Tengo que usar a RC Studio como mi Tech Provider? No. Tienes tres opciones y el módulo soporta las tres. Una: usar tu propia app; te registras en Meta, consigues la aprobación para la función WhatsApp Business App Onboarding y te conviertes tú en Tech Provider. Dos: usar cualquier Tech Provider de terceros; el módulo funciona con cualquiera. Tres: usar el servicio de Tech Provider de RC Studio, que se factura aparte de este módulo. Lo que importa en las opciones uno y dos es que el proveedor debe entregarte un App ID, un App Secret y una Login Configuration de coexistence. Sin esos tres valores el Embedded Signup no puede ejecutarse. RC Studio no puede obtenerlos por ti y no se hace responsable si un proveedor de terceros se niega, los revoca o cobra aparte por ellos.

¿Funciona en Odoo Online (SaaS)? No. Odoo Online no acepta módulos de terceros. Enterprise corre en Odoo.sh y on-premise. Tu instancia debe ser accesible por HTTPS público, porque Meta entrega los mensajes a un webhook en tu dominio.

¿Puedo seguir usando el número en el celular? Sí, esa es toda la gracia de Coexistence. El mismo número vive en la app WhatsApp Business y en la Cloud API al mismo tiempo. Tu equipo sigue respondiendo desde el celular y Odoo lo ve todo: los mensajes entrantes y las respuestas escritas en el celular, que llegan como ecos y aparecen en el hilo como mensajes salientes. Con el modo Cloud API dedicado, el número deja de funcionar en el celular.

¿Pierdo mi historial al conectar? Con Coexistence, Meta te deja importar tus contactos y hasta seis meses de historial una vez, durante el onboarding. Meta permite una sola sincronización de contactos y una sola de historial por onboarding; si fallan, la única forma de repetirlas es desvincular el número y volver a conectarlo.

¿Hay algún límite que deba conocer antes de comprar? Sí, y es de Meta, no del módulo. Los mensajes que tu equipo escribe en el celular salen tal cual y no se pueden interceptar ni reescribir; la API los recibe después, como ecos. Si necesitas controlar el 100 % del tráfico saliente, la opción correcta es la Cloud API dedicada, no Coexistence. La app de Meta también tiene una cuota de llamadas por hora: si se agota hay que esperar, y reintentar de inmediato solo alarga la ventana.

¿Qué cobra Meta por los mensajes? Meta factura por mensaje entregado. Los mensajes de plantilla se cobran a una tarifa que depende de la categoría (marketing, utilidad, autenticación) y del país del cliente. Desde el 1 de octubre de 2026 Meta cobra también las respuestas libres que envías dentro de la ventana de 24 horas (mensajes de servicio), a la misma tarifa que los mensajes de utilidad y autenticación; hasta entonces son gratis. Recibir mensajes sigue siendo gratis. Los detalles y las tarifas están en la página de precios de Meta. RC Studio no cobra por mensaje.

¿El módulo envía mis datos a un servidor de RC Studio? Solo en el alta, y solo lo mínimo. Los mensajes nunca pasan por nosotros, ni los que envías ni los que recibes. El token de negocio vive en tu propia base de datos, así que tu Odoo habla directamente con Meta, y al conectar el número nuestro servicio registra en Meta la dirección de tu Odoo como destino de las entregas: Meta entrega directamente a tu instancia, en una URL secreta que solo Meta y tu Odoo conocen. Nuestro servicio ni siquiera expone un endpoint para enviar ni recibir mensajes. Lo que sí pasa por nosotros es el alta: el app secret de Meta es nuestro y nunca se copia a tu base de datos, así que somos nosotros quienes canjeamos la autorización de Meta por tu token de acceso y te lo entregamos. Eso es todo. Si prefieres que RC Studio no intervenga ni siquiera en el alta, el módulo funciona exactamente igual con tu propia app de Meta.

¿Qué datos guarda RC Studio? Tres cosas, y solo mientras el número está conectado: el app secret de Meta (lo guardamos nosotros precisamente para que nunca haya que copiarlo en tu base de datos), la clave de licencia que te emitimos y una copia cifrada de tu token de WABA, necesaria para resuscribir el webhook cuando cambia tu URL de Odoo y para lanzar la sincronización inicial. Cuando nos pides dar de baja el número, la suscripción de nuestra app se elimina de tu WABA y se borra el registro entero, token cifrado incluido. También puedes quitar el override del webhook tú mismo en cualquier momento, con el botón Quitar override de webhook del formulario de cuenta. Tu token de negocio se queda además en tu propio Odoo, y eso es lo que hace que el envío de mensajes sea directo e independiente de nuestro servicio.

¿Nuestro número y nuestra WABA siguen bajo nuestro propio Business Portfolio? Sí, siempre. El número y la WABA son tuyos y se quedan en tu Business Portfolio. Un Tech Provider solo actúa de puente entre tu WABA y los servicios de Meta; nunca toma propiedad de nada. Meta Business Suite también sigue funcionando con normalidad: Coexistence añade la Cloud API junto a las herramientas de Meta, no las reemplaza.

¿Podemos probar primero en staging y luego pasar a producción? Sí, y es el orden recomendado. En el celular no hay interrupción ninguna. Del lado de Odoo, pasar a producción cambia la URL de tu instancia y con ella la dirección donde Meta entrega los eventos, así que hay que renovar la licencia y resuscribir el webhook a la nueva URL; el módulo tiene un botón para eso. Durante los pocos minutos que tarda, Odoo deja de enviar y recibir; el celular no. Ten en cuenta que la importación única de historial no se repite al mover el número.

¿Puedo usar plantillas que ya tenía aprobadas en Meta? Sí. Usa el botón Sincronizar plantillas del formulario de cuenta.

¿Y si Meta rechaza la sincronización con el error 133010? Significa que el número no quedó vinculado como coexistence. El botón Diagnosticar número del formulario de cuenta lo comprueba en una sola llamada y te dice si hay que rehacer la conexión.

¿Qué versiones de Odoo se soportan y en qué idiomas está la interfaz? Odoo 17.0, 18.0, 19.0 y 20.0; cada versión se compra por separado en la tienda de Odoo. La interfaz viene en inglés, español, portugués, italiano, francés, alemán y árabe.

Soporte

El soporte está incluido para cualquiera que compre el módulo. La instalación y la configuración del lado de Meta se pueden contratar por separado. Usa la página de soporte de este módulo en Odoo Apps para todo lo relacionado con tu compra: nos llega directamente y mantiene el hilo unido a tu licencia.

Tránsito de datos: los mensajes y los archivos viajan directamente entre tu instancia de Odoo y la Cloud API de Meta, con cualquier modalidad de conexión. Con licencia de RC Studio, el servicio de Tech Provider de RC Studio interviene únicamente al dar de alta el número: emite el token de acceso de Meta y registra la dirección de tu Odoo como destino de las entregas. RC Studio no recibe ni almacena contenido de mensajes. Política de privacidad.

WhatsApp es una marca de Meta Platforms, Inc. RC Studio no está afiliado a Meta ni respaldado ni patrocinado por Meta. Este módulo se publica bajo la Odoo Proprietary License v1.0 (OPL-1).