Integrar WhatsApp con Dolibarr: un agente de IA que reconoce al cliente, vende con tu catálogo y factura en Dolibarr
Actualizado el 25 de octubre de 2026 · Revisado por Alejandro Díaz, CEO de Agent IA SAS
Si tu empresa trabaja con Dolibarr ERP CRM, ahí están tus terceros, tus productos, tu stock y tus facturas. Integrar WhatsApp con Dolibarr significa que el agente de IA atiende con esa información: sabe quién escribe, ofrece lo que tienes en bodega al precio de Dolibarr y, cuando el cliente paga, la venta queda registrada como si la hubiera hecho tu equipo.
Aquí verás qué hace sola la integración, cómo se conecta por la API de Dolibarr, cómo queda cada venta, cómo se usa en Chile y México y lo que necesitas. Para otros sistemas, mira la integración de ERP con WhatsApp.
Qué hace sola la integración de Dolibarr con WhatsApp
Con Dolibarr conectado y activo para facturar, el agente trabaja así:
- Reconoce al cliente por el teléfono o el celular de su tercero en Dolibarr, escrito de cualquier forma (por ejemplo +57 (300) 123-45-67), y también por el celular de un contacto de una empresa: en ese caso le vende y le factura a la empresa.
- Lo encuentra por su documento en Dolibarr, con o sin puntos y con o sin dígito de verificación, y no le vuelve a pedir datos.
- Completa tu CRM de WhatsApp con el nombre, el correo, el documento, la dirección y la ciudad del tercero, solo donde la ficha está vacía.
- Vende con tu catálogo de Dolibarr: precio con IVA, descripción, categoría y existencias libres, y consulta el stock por bodega cuando el cliente pregunta por un producto.
- Registra cada venta pagada por pasarela, y cada pedido que tu equipo marca «Pago verificado», como pedido validado con su factura validada, y le envía el PDF al cliente por WhatsApp.
- Si el cliente pregunta por su cuenta, le dice su saldo, lo vencido y sus facturas pendientes en Dolibarr. Más en estado de cuenta por WhatsApp.
Cómo conectar WhatsApp con la Dolibarr API REST
La conexión usa la API REST que trae Dolibarr: cada llamada va a /api/index.php con el token del usuario en el encabezado DOLAPIKEY, como lo describe la documentación del módulo API REST de Dolibarr. Los pasos son estos:
- En Dolibarr, entra a Inicio → Configuración → Módulos/Aplicaciones y activa «API REST», junto con Terceros, Productos, Stock, Pedidos y Facturas.
- Crea un usuario para la integración con permisos sobre esos módulos. En su ficha, toca Modificar, genera el «Token para API» y guarda.
- En el panel de SoyAgentia, ve a Negocio → Integraciones → ERP y elige Dolibarr.
- Pega la URL con la que entras a Dolibarr, por ejemplo https://erp.miempresa.com, y el token. La URL debe ser pública en internet.
- Toca «Conectar y probar»: el panel confirma la versión de Dolibarr y los módulos a los que tiene acceso el usuario.
- En «Datos para facturar», elige cómo se registra la venta, la bodega, un producto genérico y, si quieres, la cuenta bancaria donde queda el pago, y toca «Facturar con este ERP».
Cómo queda cada venta en Dolibarr
Con «Pedido + factura», el ajuste recomendado, la venta pagada crea en Dolibarr un pedido de cliente con la referencia de la plataforma, lo valida, crea la factura desde ese pedido, la valida con su número definitivo, genera el PDF con tu plantilla y marca el pedido como facturado. Cada línea lleva el producto de Dolibarr cuando el código existe y su IVA; el precio con IVA que pagó el cliente se convierte al precio sin IVA que usa Dolibarr, y el total de la factura coincide al centavo con lo cobrado.
Antes de crear nada, la plataforma busca esa referencia en tus pedidos y facturas: un reintento devuelve la misma factura y nunca duplica la venta. Con «Solo factura» se registra la factura validada sin pedido. En modo pruebas, el pedido queda en borrador para que lo revises. Si eliges una cuenta bancaria, la factura queda pagada en Dolibarr con la forma de pago que configures, porque el cliente ya pagó por la pasarela. Así se ve en enviar factura por WhatsApp.
Tu catálogo y tu stock de Dolibarr, sincronizados para que la IA venda
Con «Traer los productos de Dolibarr» en sí, la plataforma sincroniza los productos y servicios marcados en venta cada madrugada, cuando tus clientes escriben, al conectar y al tocar «Sincronizar productos ahora». Así arma tu catálogo en WhatsApp:
- Precio con IVA incluido, tanto si en Dolibarr lo registraste con IVA como sin IVA, y la tasa de IVA de cada producto.
- Existencias libres: el stock real menos lo comprometido en pedidos validados, para que el agente no ofrezca lo que ya vendiste.
- Servicios y productos sin control de stock se venden sin límite de unidades; lo agotado queda «Sin inventario».
- La categoría, la referencia y la descripción de venta de cada producto, sin duplicar los que ya tenías en la plataforma.
Dolibarr Chile, Dolibarr México y Colombia: documento e IVA por país
Dolibarr se usa en muchos países y la integración se adapta al tuyo: el documento del cliente se lee del Id. profesional 1, que Dolibarr rotula según el país, y el IVA de cada línea sale de las tasas de tu diccionario de Dolibarr. Los clientes nuevos se crean con el país de tu empresa o con el indicativo de su celular de WhatsApp.
| País | Documento en Dolibarr (Id. prof. 1) | Tasas de IVA del diccionario de Dolibarr |
|---|---|---|
| Chile | R.U.T. | 0 % y 19 % |
| México | R.F.C. | 0 %, 10 % y 16 % |
| Colombia | R.U.T. (NIT con dígito de verificación) | Agregas las tuyas, por ejemplo 19 % y 5 % |
Lo que necesitas en Dolibarr
Revisa estos puntos con quien administra tu Dolibarr:
- Dolibarr 18 o posterior, publicado en internet con una URL propia, en tu servidor o en la nube.
- El módulo «API REST» activo y un usuario para la integración con permisos de Terceros, Productos, Stock, Pedidos y Facturas, y de pagos si quieres registrar el cobro.
- Tus tasas de IVA en Configuración → Diccionarios → Tasas de IVA.
- Una bodega abierta y la regla de stock de tu preferencia en el módulo Stock, por ejemplo descontar al validar la factura.
- El cliente «Consumidor Final» (222222222222), o dejar que la plataforma lo cree, para ventas sin datos del comprador.
Ventajas de conectar Dolibarr con WhatsApp
Lo que gana tu equipo con Dolibarr conectado al agente de IA:
- Inventario confiable: el pedido validado compromete las unidades y la factura descuenta de la bodega que elijas.
- Cartera al día: las facturas pendientes alimentan el saldo del cliente y sus recordatorios de pago por WhatsApp.
- Código abierto, datos tuyos: todo queda en tu Dolibarr y la conexión usa su API oficial, sin módulos de terceros.
- ¿Usas otro ERP de código abierto? Mira la integración de Odoo con WhatsApp o escríbenos en cotizar.
- Dolibarr es una marca de la Asociación Dolibarr. SoyAgentia no está afiliada a la Asociación Dolibarr.
Integraciones disponibles
- Dolibarr ERP CRM 18 o posterior (probado con Dolibarr 24)
- Dolibarr en tu servidor, en una máquina virtual o como servicio en la nube
- Módulos Terceros, Productos y Servicios, Stock, Pedidos y Facturas
- API REST de Dolibarr con token de usuario
- WhatsApp Business API (Cloud API) y pasarelas de pago del panel
Sigue leyendo
Preguntas frecuentes
¿Tengo que instalar algún módulo en Dolibarr para conectarlo con el agente de WhatsApp?
No. La conexión usa la API REST que ya viene en Dolibarr: solo activas el módulo «API REST» en Módulos/Aplicaciones y generas el token del usuario de la integración. No se instalan extensiones ni se toca la base de datos.
¿La integración sirve para Dolibarr en Chile o en México?
Sí. El agente reconoce al cliente por el RUT en Chile o el RFC en México, guardados en el Id. profesional 1 de Dolibarr, y cada línea de la factura lleva la tasa de IVA de tu diccionario, por ejemplo 19 % en Chile o 16 % en México. Los clientes nuevos se crean con el país de tu empresa o el del indicativo de su celular.
¿Qué permisos le doy al usuario de Dolibarr que usa la integración?
Permisos de Terceros, Productos, Stock, Pedidos y Facturas, y de pagos si quieres que la factura quede pagada. Usa un usuario solo para la integración: así ves en Dolibarr qué creó el agente y cambias su token cuando quieras.
¿El stock de Dolibarr baja cuando el agente vende por WhatsApp?
Sí. El pedido validado compromete las unidades en el stock virtual y, con la regla de Dolibarr de descontar al validar la factura, la factura descuenta el stock de la bodega que elijas en el panel. El agente ofrece las existencias libres, sin lo comprometido.
Si me escribe el empleado de una empresa cliente, ¿a quién le factura el agente?
A la empresa. Si el celular está en un contacto de un tercero de Dolibarr, el agente reconoce la empresa a la que pertenece y la factura sale a nombre de esa empresa, con su NIT o documento.
¿La factura queda pagada en Dolibarr si el cliente ya pagó por la pasarela?
Sí, si eliges en el panel la cuenta bancaria y la forma de pago: la plataforma registra el pago por el total y la factura queda pagada. Si dejas la cuenta vacía, la factura queda pendiente para que la concilies en Dolibarr.