Bot de Telegram para el Staff

El bot de Telegram de FlowWap es la principal herramienta de trabajo para la operación diaria dentro del local físico del restaurante. Permite a los cocineros y repartidores gestionar pedidos y modificar el menú en tiempo real sin necesidad de utilizar una computadora o acceder al panel web administrativo.

1. Comandos de Configuración y Vinculación

Antes de empezar a recibir pedidos, el personal debe asociar su cuenta de Telegram:

• /start (Inicio): Abre la conversación inicial con el bot. Presenta un saludo y las instrucciones básicas de configuración.
• /vincular [código_de_6_dígitos]: Vincula tu cuenta personal de Telegram con tu usuario de staff registrado en el panel administrativo del restaurante. El sistema te asignará los permisos de tu rol correspondiente.
• /help: Muestra la lista de comandos a los que tienes acceso según tu rol dentro del restaurante.

2. Gestión Operativa de Pedidos

Cuando un cliente envía su pedido y el pago es aprobado por el cajero, el bot envía un mensaje con formato de comanda al canal de staff (o grupo de Telegram de cocina). Puedes procesarlo con los siguientes comandos o botones directos:

• /listo [ID_PEDIDO]: Utilizado por el equipo de cocina. Cambia el estado del pedido a ready (listo para entregar) en el sistema. Esto alerta automáticamente al repartidor y le notifica al cliente por WhatsApp que su comida está lista.
• /entregado [ID_PEDIDO]: Utilizado por los repartidores (delivery) al completar la entrega a domicilio del pedido. Cambia el estado en base de datos a delivered (entregado).
• Botones Inline de Acción: Para mayor agilidad, cada mensaje de comanda enviado por el bot cuenta con botones interactivos debajo del texto. Los usuarios autorizados pueden presionar directamente “Aprobar Pago”, “Rechazar” o “Marcar como Listo” sin tener que escribir comandos de texto en el chat.

3. Gestión de Catálogo e Inventario

• /agotado [SKU_DE_PRODUCTO]: Utilizado para suspender un producto del menú de forma inmediata cuando se acaban los ingredientes en cocina. La IA de WhatsApp dejará de ofrecer el plato y este desaparecerá del menú digital web.
• /disponible [SKU_DE_PRODUCTO]: Vuelve a activar el plato en el catálogo una vez se reciba stock del ingrediente.
• /qr: Permite al cajero u administrador solicitar la imagen base64 del código QR de conexión de WhatsApp directamente en Telegram para reconectar la línea telefónica en segundos si se cae.

4. Limitaciones del MVP en Telegram

• Comando /estado (Pedidos Activos): El comando /estado para listar los pedidos pendientes y en preparación que se encuentra referenciado en el menú de /help del bot no cuenta con código lógico en esta versión. Utiliza la lista de pedidos en el panel web para visualizar los pendientes.
• Alertas de Colas (DLQ): En caso de fallas masivas en la red o caídas de las colas de mensajes del sistema de mensajería, el bot enviará una alerta automática únicamente a los usuarios registrados con el rol de Administrador.