Bot de WhatsApp
El cliente escribe al WhatsApp de la tienda y recibe el estado real de la reparación — incluido aprobar presupuestos con «SÍ».
Lo que responde el bot
El bot identifica al cliente por el número de teléfono y la reparación por el contexto. Cada mensaje es independiente — el cliente no necesita «iniciar sesión» ni seguir menús:
| El cliente escribe | El bot responde |
|---|---|
| «¿está listo?» o cualquier texto | Estado de la reparación + fecha prevista |
| «presupuesto» / «precio» / «cuánto» | Importe del presupuesto pendiente + instrucciones |
| SÍ / acepto / ok | Aprueba el presupuesto pendiente — mismo flujo del mostrador |
| NO / rechazo | Rechaza el presupuesto |
| Código de la reparación (REP-…) | Estado de esa reparación concreta |
| «ayuda» / «humano», audio o imagen | Deriva al personal — con notificación en la app |
| Número sin ficha | Mensaje amable con los contactos de la tienda |
Cómo decide la respuesta
El bot busca la ficha del cliente por los últimos 9 dígitos del número — robusto a prefijos +34/+351, espacios y formatos. Con una reparación activa el contexto es obvio y responde directamente; con varias, lista los códigos para que el cliente elija.
«Reparación activa» incluye todas las que aún no se han entregado, devuelto o cancelado — incluidas las listas para recoger, que son justo las que generan la pregunta «¿ya está?».
Lo que el bot no resuelve pasa a personas: «ayuda», «humano», audios, imágenes y preguntas fuera de patrón crean una notificación en la app con el texto del cliente — el equipo responde manualmente.
Qué hace falta (Meta)
El módulo usa la WhatsApp Business Platform oficial de Meta — sin trucos ni riesgo de ban del número. Requisitos:
- Una app Meta (developers.facebook.com) con el producto WhatsApp — nuestra app OficinaOS ya existe y está publicada
- El número de la tienda en WhatsApp Business — la coexistencia permite mantener la app en el móvil y conectar la API a la vez
- Un token permanente de system user con permisos whatsapp_business_messaging + whatsapp_business_management
- El webhook apuntado a OficinaOS Cloud — ya configurado de nuestro lado
Configuración en la app (por tienda)
Tras el alta en Meta (acompañada por nosotros en la primera tienda), la configuración en la app son 4 campos:
- Menú → Notificaciones → Setup → sección WhatsApp
- Business ID + Phone Number ID — facilitados en el alta
- API Token — el token permanente del system user (la app lo sube una vez a la Cloud, donde queda cifrado — los envíos salen por el relay y el token no se vuelve a pedir)
- Enabled activado — la app registra el phone_number_id y las credenciales en Cloud sola y el bot queda activo
Límites honestos
- Las respuestas pueden tardar hasta ~2 minutos (ciclo de sincronización) — no es instantáneo
- Responder a quien escribe es gratis; iniciar conversaciones («tu reparación está lista») requiere plantillas aprobadas en Meta con coste por mensaje
- Control de flood: máximo 20 mensajes/hora por número — protección contra spam
- Audios e imágenes no se interpretan — van a un humano
- En modo prueba solo responde a números verificados en Meta — en producción no hay ese límite
Si el bot se queda callado
| Síntoma | Qué comprobar |
|---|---|
| El cliente no recibe respuesta | ¿Sigue válido el token Meta? (los temporales caducan en 24h — usar el de system user) |
| El mensaje ni llega a la app | ¿Módulo whatsapp-bot activo en Cloud? ¿phone_number_id correcto en ajustes? |
| El bot responde pero Meta bloquea | En modo prueba, ¿el destinatario está verificado? En producción, es la ventana de 24h |
| «SÍ» no hace nada | ¿Hay presupuesto enviado y pendiente en esa ficha? (el bot solo actúa sobre presupuestos por responder) |
| Presupuesto bien, respuesta mal | ¿El teléfono de la ficha del cliente tiene los mismos últimos 9 dígitos? |