Requisitos y Arquitectura – Bot WhatsApp con SAP Business One y SQL
Server
1. Escenario Tecnológico
Este documento describe los requisitos necesarios para implementar un bot de WhatsApp
integrado con SAP Business One utilizando SQL Server.
Stack recomendado:
- SAP Business One sobre SQL Server
- Bot de WhatsApp usando WhatsApp Cloud API (Meta)
- Backend en [Link] con Express
- Base de datos intermedia en SQL Server
- Servidor con acceso público (VPS o local)
2. WhatsApp Cloud API (Meta)
Requisitos:
- Cuenta Meta Business verificada
- Aplicación creada en [Link]
- Número de WhatsApp empresarial
- Token permanente de acceso
- Webhook configurado para recibir mensajes
Esto permite que el bot reciba y envíe mensajes automáticamente.
3. Backend (API)
El backend es el núcleo del sistema. Sus funciones principales son:
- Recibir mensajes de WhatsApp
- Identificar al usuario por número telefónico
- Mostrar menús interactivos
- Registrar asistencia, ventas y tickets
- Consultar información desde SAP
- Responder al usuario por WhatsApp
Tecnologías recomendadas:
- [Link]
- Express
- Axios
- Librería mssql para SQL Server
4. Base de Datos Intermedia
No se recomienda escribir directamente en SAP.
Se debe usar una base de datos propia con las siguientes tablas:
- empleados
- usuarios_whatsapp
- asistencia
- ventas
- tickets
- roles
- logs
Esta base de datos centraliza la información generada por el bot.
5. Integración con SAP Business One (SQL Server)
La integración debe ser solo de lectura y mediante objetos controlados.
Opciones:
- Vistas SQL
- Stored Procedures
- Usuarios SQL con permisos de solo lectura
Ejemplo de vista:
SELECT CardCode, CardName, Balance
FROM OCRD
WHERE CardType = 'C';
El backend consulta estas vistas y devuelve la información al bot.
6. Flujo de Operación
Empleado escribe por WhatsApp
→ WhatsApp Cloud API
→ Backend [Link]
→ Base de Datos Intermedia
→ Consulta SAP
→ Respuesta por WhatsApp
7. Funcionalidades del Bot
Asistencia:
- Registro de entrada y salida
- Hora automática
- Ubicación opcional
Ventas:
- Registro de ventas internas
- Consulta de facturas SAP
- Consulta de estatus de documentos
Atención a Cliente:
- Creación de tickets
- Consulta de estatus
- Escalamiento a personal humano
8. Seguridad
Medidas obligatorias:
- Validación por número de WhatsApp
- Manejo de roles de usuario
- Usuario SQL sin privilegios administrativos
- Manejo de tokens en variables de entorno
- Registro de logs de auditoría
9. Infraestructura
Servidor mínimo requerido:
- [Link] instalado
- Acceso a SQL Server
- Certificado HTTPS (puerto 443)
- IP pública o dominio
10. Plan de Implementación
Fase 1:
- Conexión WhatsApp
- Backend funcional
- Registro de asistencia
Fase 2:
- Registro de ventas
- Atención a cliente
- Control de roles
Fase 3:
- Consultas SAP
- Reportes automáticos
- Dashboards gerenciales