Bot de Telegram para el Staff

El bot de Telegram de FlowWap es la principal herramienta de trabajo para la operación diaria dentro de tu tienda o local comercial. Permite a tu equipo de despacho, almacén, caja y repartidores gestionar pedidos y modificar la disponibilidad de productos 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 comercio. 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 negocio.

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 el detalle de la orden al canal de staff (o grupo de Telegram de operaciones/despacho). Puedes procesarlo con los siguientes comandos o botones directos:

• /listo [ID_PEDIDO]: Utilizado por el equipo de empaque/despacho. Cambia el estado del pedido a ready (listo para entregar o retirar) en el sistema. Notifica automáticamente al cliente por WhatsApp que su pedido está listo.
• Botones Inline de Acción: Para mayor agilidad, cada mensaje de pedido 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.

Pedidos de Delivery

Si tu negocio ofrece envío a domicilio y tienes un grupo de Telegram vinculado para el equipo de reparto, el flujo continúa automáticamente:

1. Cuando el equipo de despacho marca un pedido como Listo, el grupo de reparto recibe el ticket del pedido con dos botones: ”🚗 En Camino” y ”✅ Entregado”.
2. El repartidor presiona “En Camino” al salir hacia el cliente y “Entregado” al completar la entrega. El estado del pedido se actualiza al instante en el panel web.

Los botones de reparto solo aparecen en pedidos con envío a domicilio. En pedidos de retiro en tienda, el ciclo termina cuando el pedido está listo.

3. Gestión de Catálogo e Inventario

• /agotado [SKU_DE_PRODUCTO]: Utilizado para suspender un producto del catálogo de forma inmediata cuando se agota el inventario. La IA de WhatsApp dejará de ofrecer el artículo y este desaparecerá temporalmente del catálogo digital web. (Nota: La reactivación de stock se realiza desde el panel administrativo web en la sección Catálogo).
• /qr: Permite al cajero o administrador solicitar la imagen del código QR de conexión de WhatsApp directamente en Telegram para reconectar la línea telefónica en segundos.

4. Limitaciones del MVP en Telegram

• Comandos /disponible: El comando /disponible no está activo en este MVP. La reactivación de stock se realiza desde el panel administrativo web.
• 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.