Atención por WhatsApp automatizada: conecta

En tu día a día, la atención por WhatsApp se vuelve indispensable, pero cada mensaje nuevo implica cargar datos en varios sistemas que ya usas: ERP, contabilidad, plataformas de pago. En este artículo verás cómo conectar la automatización de WhatsApp con esos recursos sin desmontar la infraestructura actual.

Con qué se tiene que hablar

Antes de lanzar cualquier bot, haz un inventario de los sistemas que ya sustentan tu operación. En la mayoría de las pymes peruanas encontramos:

• ERP o sistema de gestión (por ejemplo, SAP Business One, Odoo, o soluciones locales). Maneja inventario, órdenes y clientes.
• CRM (HubSpot, Zoho, o módulos propios). Guarda historial de interacciones y oportunidades.
• Plataforma de facturación electrónica (e‑fact, Nubefact, etc.). Genera y envía los comprobantes que la SUNAT exige.
• Herramientas de cobranza (Yape, Plin, Niubiz, Izipay). Cada una tiene su propio flujo de confirmación de pago.
• Sistemas de reporte interno (Power BI, Tableau). Consumen datos para dashboards de desempeño.

La regla de oro es no sustituir ninguno de esos componentes; la automatización debe actuar como un “puente” que lleva la información del chat al resto de la arquitectura. Identifica los puntos de integración (API, webhook, base de datos) y define quién será el responsable de mantener cada enlace.

SUNAT y facturación electrónica

Requisitos legales

La SUNAT obliga a que todo comprobante de venta se emita electrónicamente y se envíe al cliente en tiempo real. Cuando la atención por WhatsApp genera una orden, el flujo debe cumplir con:

1. Generación del CPE (Comprobante de Pago Electrónico) dentro de los 5 minutos posteriores a la confirmación del pedido.
2. Envío del XML y del PDF al cliente por el medio que él haya elegido (correo, WhatsApp, o link de descarga).
3. Registro del documento en el sistema de facturación para que quede disponible en los libros electrónicos de la SUNAT.

Errores típicos y cómo evitarlos

• Duplicados por falta de idempotencia: si el bot reintenta el envío tras un timeout, puede crear dos facturas. Solución: usar un identificador único (UUID) que el ERP reconozca y rechace repeticiones.
• Formato de datos incompleto: la SUNAT valida campos como número de documento del cliente y dirección. Asegúrate de que el bot solicite esos datos antes de crear el CPE.
• Desfase de zona horaria: la SUNAT registra la hora de emisión en hora local (PET). Configura tu servidor de integración para que siempre envíe timestamps con zona “America/Lima”.

Integración práctica

1. Webhook de WhatsApp → Middleware: el mensaje llega a un servicio intermedio (Node.js, Python, o plataforma low‑code) que valida los datos y llama a la API del ERP.
2. API del ERP → Servicio de facturación: el ERP envía la orden y recibe el número de serie del CPE.
3. Servicio de facturación → SUNAT: envía el XML y guarda el código de respuesta.
4. Respuesta al cliente: el middleware envía el PDF y el enlace de descarga al chat de WhatsApp.

Con este esquema, la facturación electrónica se vuelve una extensión natural del proceso de atención, sin que el agente tenga que salir del chat.

Cobros y bancos

Yape y Plin

Ambas apps funcionan sobre cuentas bancarias y permiten transferencias instantáneas. La integración típica se hace mediante API de conciliación que el banco expone (por ejemplo, Interbank, BCP). El flujo recomendado:

1. Generar referencia de pago en el ERP (código alfanumérico único).
2. Enviar la referencia al cliente en el mensaje de WhatsApp.
3. Cliente paga vía Yape/Plin usando la referencia como concepto.
4. Webhook del banco notifica al middleware que el pago llegó.
5. Middleware actualiza el ERP marcando la orden como pagada.

Niubiz e Izipay

Estas pasarelas permiten pagos con tarjetas y QR. Sus APIs devuelven un status (approved, pending, rejected) en tiempo real. Para evitar bloqueos por fraude, implementa:

• Validación de monto contra la orden del ERP.
• Confirmación de 3‑DS cuando la tarjeta lo requiera.
• Retención de 24 h antes de marcar la venta como finalizada, para dar tiempo a la conciliación bancaria.

Cómo se conectan de verdad

• Usa API REST con token JWT que renueve cada 30 min. La mayoría de los proveedores peruanos ofrecen sandbox para pruebas; dedica al menos 2 semanas a validar los flujos en entorno de pruebas.
• Mapea los campos: código de referencia, monto, número de documento del cliente y estado del pago. Mantén una tabla de correspondencia en tu base de datos para rastrear cualquier discrepancia.
• Manejo de errores: si la pasarela devuelve timeout o código de error 500, reintenta automáticamente hasta 3 veces con intervalos de 10 s. Registra cada intento para auditoría.

Qué pedirle al proveedor

APIs y documentación

• Especificación OpenAPI/Swagger actualizada. Así tu equipo puede generar clientes automáticamente y validar contra el contrato.
• Límite de llamadas (rate limit): conoce cuántas peticiones por segundo puedes hacer. Si tu volumen de chats supera 200 msg/min, negocia un plan empresarial.
• Política de versionado: asegúrate de que el proveedor mantenga versiones estables y anuncie cambios con al menos 30 días de antelación.

Cambios en la otra parte

Los proveedores pueden modificar campos o eliminar endpoints. Para mitigar riesgos:

1. Implementa un adaptador que traduzca la respuesta del proveedor a un modelo interno. Cambios internos no afectan al resto del sistema.
2. Monitoriza versiones: suscríbete a sus canales de comunicación (mail, Slack) y programa revisiones trimestrales de la documentación.
3. Pruebas de regresión automáticas: cada despliegue de tu middleware debe ejecutar pruebas contra los endpoints críticos (creación de orden, consulta de estado de pago).

Conclusión

Integrar la atención por WhatsApp automatizada con los sistemas que ya usas implica mapear cada punto de contacto (ERP, SUNAT, bancos) y diseñar un middleware que actúe como traductor. Cumplir con los requisitos de la SUNAT evita sanciones, mientras que la conexión a Yape, Plin, Niubiz o Izipay garantiza que el flujo de cobro sea inmediato y trazable. Finalmente, exige a tus proveedores APIs claras, versionadas y con documentación accesible; de esa forma cualquier cambio futuro se incorpora sin interrumpir la operación. Con estos pasos, tu empresa podrá ofrecer una atención por WhatsApp fluida, alineada con la normativa peruana y sin sacrificar la infraestructura que ya funciona.