El 80% de las consultas comerciales en PYMES peruanas entran por WhatsApp, pero el 80% del histórico de ventas vive en Odoo. Si esos dos mundos no están conectados, tu equipo se quema copiando datos a mano — y los clientes se enfrían esperando respuesta. Esta es la guía técnica y operativa para integrar WhatsApp Business API con Odoo en una empresa peruana, sin Excel intermedio.
En Lima, Arequipa, Trujillo y la mayoría del interior del país, el patrón es el mismo: la primera conversación con un cliente nuevo nace en WhatsApp. La cotización se manda por WhatsApp. La confirmación de cita o pedido se cierra por WhatsApp. Y cuando la persona compra, alguien — humano, normalmente sobrepasado — copia los datos del chat al CRM de Odoo. Cuando hay 30 conversaciones al día, eso funciona. Cuando son 300, no.
Integrar WhatsApp Business API con Odoo ERP no es solo una mejora técnica: es la diferencia entre escalar tu operación con el equipo que tienes, o tener que contratar tres personas más solo para no perder mensajes. En esta guía vas a encontrar la arquitectura real, qué proveedor elegir, qué flujos automatizar primero y los errores específicos que vemos repetirse en empresas peruanas.
WhatsApp Business vs WhatsApp Business API: lo que tienes que saber primero
El error más común al empezar este proyecto es confundir WhatsApp Business (la app gratuita) con WhatsApp Business API (la versión empresarial). Para conectar con Odoo necesitas obligatoriamente la API. Esta es la diferencia real:
| Característica | WhatsApp Business (app) | WhatsApp Business API |
|---|---|---|
| Costo | Gratis | Por conversación iniciada |
| Múltiples agentes | No | Sí, ilimitados |
| Bots e IA conversacional | No oficial | Sí, soporte nativo |
| Integración con Odoo / CRM | Solo manual | Vía webhooks y API |
| Mensajes masivos / campañas | No, te banea | Sí, con plantillas HSM |
| Sincroniza con base de clientes | No | Sí, bidireccional |
| Verificación de empresa (tilde verde) | Limitada | Sí, oficial |
Si todavía estás usando WhatsApp Business app con varios celulares pasando entre vendedores, esa es la primera señal de que tu empresa ya necesita migrar a WhatsApp Business API. No solo por eficiencia: si Meta detecta automatización no autorizada en una cuenta personal o de Business app, te suspenden el número definitivamente.
Arquitectura real de la integración WhatsApp + Odoo
Esta es la arquitectura que estamos implementando para PYMES peruanas. Cada bloque tiene una responsabilidad clara y se puede sustituir sin romper el resto:
┌────────────────────────────────────────────────────────────────────┐ │ │ │ 📱 Cliente │ │ ─────── │ │ │ envía mensaje │ │ ▼ │ │ ☁️ WhatsApp Cloud API (Meta / BSP) │ │ │ webhook HTTPS │ │ ▼ │ │ 🔁 Capa de orquestación (n8n / FastAPI / Make) │ │ │ │ │ │ ┌──── lee/escribe stock, leads, cotizaciones ─┐ │ │ │ │ │ │ │ ▼ ▼ │ │ │ 🤖 Agente IA 🏢 Odoo ERP 💳 Culqi / Izipay │ │ (Claude / GPT-4o) (Community, en tu (links de pago) │ │ propio servidor) │ │ │ └────────────────────────────────────────────────────────────────────┘
Cada pieza cumple un rol específico:
- Capa de WhatsApp (BSP): recibe los mensajes del cliente y dispara un webhook a tu servidor. Puede ser Cloud API de Meta (directo) o un BSP intermedio como 360dialog, Twilio o Wati.
- Orquestador: recibe el webhook, decide qué hacer con el mensaje, consulta Odoo, llama al modelo de IA si es necesario y responde. Acá vive la lógica de tu negocio. n8n es la opción más popular en empresas peruanas por ser self-hosted y dueño total de los datos.
- Agente de IA: Claude o GPT-4o procesa el mensaje en lenguaje natural, extrae la intención (cotización, agendamiento, queja, consulta de estado) y devuelve una respuesta o una acción a ejecutar.
- Odoo ERP: la "fuente de verdad" de tu empresa. Acá viven los clientes (res.partner), las oportunidades (crm.lead), los productos (product.product) y los pagos. El orquestador lee y escribe directamente vía Odoo API JSON-RPC o XML-RPC.
- Pasarela de pago: Culqi, Izipay, Niubiz o Mercado Pago. El orquestador genera un link de pago cuando el cliente confirma la compra y lo envía al chat. Cuando se confirma el pago, escribe la factura en Odoo.
Por qué Odoo Community y no Online en este caso
Para integraciones avanzadas con WhatsApp y agentes de IA conviene fuertemente Odoo Community auto-hospedado. Tienes acceso directo al modelo de datos, instalas módulos OCA gratuitos, evitas la licencia por usuario y, sobre todo, los datos de tus clientes nunca salen del servidor que tú controlas. Esto es importante por la Ley 29733 de Protección de Datos Personales en Perú.
Elegir proveedor de WhatsApp Business API en Perú: las 4 opciones reales
El mercado de proveedores (BSP, Business Solution Providers) cambió mucho desde que Meta lanzó Cloud API directo en 2022. Estas son las 4 opciones que tiene una empresa peruana en 2026:
1. Meta Cloud API (directo)
Es la opción más barata por conversación, pagas a Meta directamente. La cuenta se administra desde Business Manager de Facebook. Requiere más trabajo técnico inicial pero te da el control total. Recomendado para empresas con equipo técnico interno o que ya trabajan con un implementador especializado.
2. 360dialog
BSP alemán, uno de los oficiales de Meta. Bueno por estabilidad y precios competitivos. Soporte en inglés y alemán principalmente. Cobran un fee mensual fijo más el costo por conversación. Ideal para empresas que valoran estabilidad y no quieren depender de un BSP local.
3. Twilio
El más conocido a nivel global. Documentación impecable, SDK en todos los lenguajes. Precio por conversación más alto que Meta directo pero la confiabilidad es de las mejores. Recomendado si ya usas Twilio para SMS o voz.
4. Wati / Whaticket / proveedores locales
BSPs intermedios con UI propia (panel para que tu equipo administre conversaciones sin código). Más caros, pero más rápidos de poner en marcha. Buena opción si no quieres armar tu propio panel y necesitas que el equipo comercial use una bandeja unificada.
| Si tu empresa... | Te conviene |
|---|---|
| Tiene volumen alto (10K+ conversaciones/mes) y equipo técnico | Meta Cloud API directo |
| Empieza, no quiere lidiar con setup técnico | 360dialog o Wati |
| Ya usa Twilio para SMS o voz | Twilio |
| Quiere panel listo para usar y bandeja compartida del equipo | Wati o similar local |
Los 5 flujos que toda PYME peruana debe automatizar primero
Estos son los flujos que más impacto tienen en los primeros 90 días de la integración WhatsApp + Odoo. Los ordenamos por velocidad de retorno:
Flujo 1: Captura automática de leads desde WhatsApp a Odoo CRM
Cuando un cliente nuevo escribe a tu WhatsApp, el agente de IA hace 3-4 preguntas básicas (nombre, empresa o necesidad, presupuesto aproximado, urgencia) y crea automáticamente una oportunidad (crm.lead) en Odoo con toda esa información estructurada. Tu equipo comercial deja de escarbar conversaciones para entender qué quería el lead.
Flujo 2: Cotizaciones automáticas con consulta de stock real
El cliente pide un producto. El agente IA identifica el producto en tu catálogo Odoo (product.product), verifica stock en tiempo real, calcula precio + IGV, genera la cotización PDF y la envía al chat. Si confirma, crea la sale.order automáticamente.
Flujo 3: Recordatorios de citas, pagos y vencimientos
Con plantillas HSM aprobadas, envías recordatorios outbound: "Hola María, te recuerdo tu cita mañana 10am en Mirela Ferro Studio. ¿Confirmas?". Si el cliente dice "no", el agente libera el bloque en Google Calendar y notifica a Odoo. Reduce no-shows entre 40% y 60%.
Flujo 4: Cobranza automática post-venta
Cuando Odoo detecta una factura vencida, dispara un workflow que envía mensaje al cliente con el detalle y el link de pago Culqi o Izipay. Si paga, Odoo registra la cobranza y cierra el ciclo. Esto suele liberar entre 8 y 14 horas semanales del equipo administrativo en estudios contables, escuelas privadas y empresas de servicios recurrentes.
Flujo 5: Notificaciones de estado de pedido / envío
Conectado con tu proveedor logístico, el agente notifica al cliente cuando su pedido sale del almacén, está en camino y fue entregado. Las consultas tipo "¿llegó mi pedido?" caen al casi cero, liberando al equipo de soporte para casos reales.
Errores comunes al integrar WhatsApp con Odoo (y cómo evitarlos)
Después de ver decenas de implementaciones en empresas peruanas, estos son los errores que más se repiten:
Error #1: Lanzar el agente sin supervisión humana las primeras 2 semanas
Un agente IA recién desplegado va a equivocarse. Si no tienes un canal donde un humano revise sus respuestas antes de mandarlas, las primeras 100 conversaciones pueden dañar tu marca. La buena práctica es "human-in-the-loop" decreciente: 100% supervisión la primera semana, 50% la segunda, 20% la tercera y autonomía total recién al mes.
Error #2: No definir el tono de marca del bot
El agente IA tiene que sonar como tu empresa, no como ChatGPT. Si tu marca es informal-cercana, no puede mandar respuestas con "Estimado cliente, hemos recibido su solicitud...". Define el tono explícitamente en el prompt del agente y dale ejemplos reales de conversaciones de tu equipo.
Error #3: Mezclar la base de clientes de WhatsApp con la de Odoo sin reglas claras
Cuando un cliente nuevo escribe, ¿se crea un nuevo registro res.partner o se busca por teléfono y se actualiza el existente? ¿Qué pasa si el teléfono coincide pero el nombre es distinto? Define estas reglas antes de lanzar, o terminarás con duplicados que ensucian tu CRM.
Error #4: No aprovechar las plantillas HSM
Muchas integraciones se limitan a responder, pero el verdadero ROI está en los mensajes outbound (campañas, recordatorios, cobranza). Sí, las plantillas HSM tienen que pasar revisión de Meta, pero una vez aprobadas son tu canal más efectivo para reactivar clientes dormidos.
Error #5: No medir nada
Tu integración tiene que reportar: cuántos mensajes entrantes, cuántos resueltos por el bot, cuántos derivados a humano, tiempo promedio de respuesta, conversión a cotización, conversión a venta. Sin métricas no sabes si la integración está pagando lo que cuesta.
Advertencia: la Ley 29733 sí aplica
Si tu agente IA guarda historial de conversaciones para "memoria" o entrenamiento, estás procesando datos personales según la Ley 29733. Eso significa: aviso de privacidad visible, posibilidad de borrado a solicitud y servidor preferentemente en Perú o con cláusulas de transferencia internacional. Esto no es opcional. Las multas para PYMES llegan hasta 50 UIT.
Cómo medir el ROI de la integración WhatsApp + Odoo
Las 6 métricas que tu integración debe poder reportar desde el primer día:
- Tiempo promedio de primera respuesta: antes era 2-4 horas, con integración debe bajar a menos de 30 segundos.
- Tasa de resolución sin humano: qué porcentaje de conversaciones cierra el bot solo. Un buen target es 70-90% en el segundo mes.
- Leads creados en Odoo CRM por día: deberías ver un aumento de 30-50% solo por capturar los que antes se perdían.
- Tasa de conversión lead → cotización: con bot que pre-califica, sube entre 25% y 40%.
- No-shows en citas: con recordatorios automáticos baja entre 40% y 60%.
- Horas semanales del equipo recuperadas: el dato más importante para el dueño. Suele estar entre 15 y 35 horas/semana para PYMES de 5-20 empleados.
Preguntas frecuentes sobre WhatsApp + Odoo en Perú
¿Necesito tener Odoo ya implementado antes de integrar WhatsApp?
¿La integración funciona con Odoo Community o solo con Enterprise?
¿Puedo mantener mi número de WhatsApp actual?
¿El bot puede pasar la conversación a un humano cuando es necesario?
¿Qué pasa si Meta cambia las reglas o suspende mi cuenta?
¿Puedo enviar mensajes masivos con esta integración?
¿Quieres una integración WhatsApp + Odoo a medida?
Diagnóstico gratuito de 60 minutos. Vemos tus flujos actuales y armamos la propuesta técnica con plazos y arquitectura — sin compromiso.
