Walter: el asistente de WhatsApp que opera NITRO

  Cliente / empleado escribe o manda nota de voz por WhatsApp
          |
          v
  Walter entiende el pedido ("quiero 2 cafés", "ordeñamos 246 litros")
          |
          +--> ¿Quién es este número?  --> Actores y roles (cliente, vendedor, contador, planta...)
          |
          +--> ¿Puede hacer esto?      --> matriz de permisos por rol
          |
          +--> Responde por WhatsApp y, si es una escritura, pide confirmación: "¿Lo confirmo? (responda sí)"
          |
          v
  Al confirmar, ejecuta en NITRO: cotización, pedido, factura, cobro, compra, movimiento de inventario
          |
          v
  Todo queda en la Bitácora (mensajes y acciones, con el documento generado)

Dónde está: Ventas → Walter (IA) → Walter — Centro de herramientas. El Centro reúne todo: Configuración de Walter (tokens, banco, bandeja de últimos mensajes y acciones), Actores y roles, Carga de producción, Bitácora, el Panel de WhatsApp (la bandeja de conversaciones en vivo), Salud de la API y la Wiki de Inventario y Producción que Walter usa como base de conocimiento.

• Actor. Un número de WhatsApp conocido por NITRO, con nombre, rol, NIT/CI opcional y, si es cliente, el cliente de NITRO al que corresponde. Un número desconocido se registra solo con el rol por defecto (prospecto o cliente), que solo puede consultar precios.
• Rol. Define qué puede pedirle cada número a Walter:

• Confirmación en dos pasos. Toda acción que escribe en la contabilidad o el inventario se propone primero (“Voy a armar este pedido: … ¿Lo confirmo?”) y solo se ejecuta cuando la persona responde sí. Se puede apagar con Exigir confirmación antes de contabilizar, pero no es recomendable.
• Idempotencia. Cada mensaje de WhatsApp tiene un identificador único; si llega dos veces, Walter no registra dos veces.
• Tokens. Dos claves compartidas entre NITRO y el canal de WhatsApp: una para recibir mensajes y otra para ejecutar acciones. Deben coincidir en ambos lados.
• Canal de WhatsApp. El número de la empresa conectado a Walter. Lo conecta el equipo de NITRO; el Centro muestra si está Módulo listo y si el canal está conectado o “pendiente de configuración”.

• Walter activo: interruptor general.
• Auto-provisionar actores nuevos (como cliente): si un número desconocido escribe, se crea como actor con el Rol por defecto (contacto desconocido).
• Exigir confirmación antes de contabilizar: déjelo marcado.
• Token API (webhook liviano) y Token del agente: reemplace los valores CHANGE_ME… por claves propias y comuníquelas a quien conecte el canal.
• Moneda, Ubicación por defecto (el almacén desde el que se venden y consultan existencias), Grupo de impuestos (el que aplica IVA 13 %), Tipo de venta (lista de precios) y Banco para cobros.
• Monto mínimo para contabilizar (Bs) y Ventana de conciliación de pagos (min): los mismos criterios que Cobros Yape / QR, que es quien confirma los pagos.
• Guardar configuración (“Configuración guardada.”). La nota al pie recuerda: “El registro de cobros reutiliza Payment Hub; configure allí el banco y el ítem genérico.”

La pestaña Bandeja de esta misma pantalla muestra las Últimas acciones (fecha, celular, rol, acción, estado, documento generado, error) y los Últimos mensajes.

1. Abra Actores y roles desde el Centro.
2. Complete Celular (formato internacional sin el signo +, por ejemplo 59170000000), Nombre, Rol, NIT/CI, el Cliente de NITRO al que corresponde (opcional, para que sus pedidos y facturas salgan a su nombre), Activo y Notas.
3. Presione Crear actor (“Actor creado”; si el número ya existía: “Actor actualizado (ya existia)”).
4. En la lista, use editar o desactivar / activar (“Estado cambiado”). Un actor desactivado no puede operar aunque escriba.

El rol de un número es la única autorización que cuenta: aunque el canal de WhatsApp entre a NITRO con un usuario de amplios permisos, Walter solo ejecuta lo que el rol del celular permite.

El rol del usuario de NITRO necesita las áreas Walter - configuración y bandeja, Walter - actores/roles de WhatsApp, Walter - bitácora de conversaciones y acciones y, para la carga de producción, Walter - carga de producción por etapa. Sin ellas verá “No tiene permiso para este módulo. Asígnelo en Configuración → Roles de Seguridad → Walter (IA).” (Usuarios y roles). Después de cambiar un rol hay que volver a iniciar sesión.

Cada acción ejecutada queda en la Bitácora con el tipo y número del documento de NITRO; desde ahí puede abrirlo en la consulta correspondiente (Ventas, Compras, Inventario).

• Abra Bitácora desde el Centro. Escriba un celular en el filtro y presione Filtrar para ver solo esa conversación.
• Mensajes: fecha, celular, dirección (entrada o salida), tipo (texto, audio, imagen, sistema), contenido y enlace al archivo si lo hubo (las notas de voz se transcriben; las fotos se leen).
• Acciones: fecha, celular, rol, acción, estado, documento de NITRO, parámetros y error. Es solo lectura: sirve para auditar qué hizo Walter y por qué.

Pensada para negocios de producción con etapas (el modelo de ejemplo es una quesería): el encargado de cada etapa puede cargar el parte desde NITRO además de hacerlo por WhatsApp. Cada carga mueve el inventario real.

1. 1) Ordeñe (planta / animal): elija la Planta (ordeño 1 o 2), el Animal, los Litros ordeñados y la Fecha; presione Registrar ordeñe. La leche entra al almacén de esa planta al costo por litro configurado.
2. 2) Entrada a la planta: Desde planta de ordeño, Litros que entran, Fecha; Registrar entrada. Es una transferencia al almacén de producción.
3. 3) Producto terminado (lote): Producto, Cantidad, Lote (opcional, se genera solo), Vence (opcional) y Fecha; Registrar producto terminado. Ingresa el producto y descuenta la leche y los insumos según la receta.
4. Abajo, la pantalla muestra las Órdenes de producción (planificación diaria) con lo que falta producir y la leche cruda a pedir, el Stock por ubicación (ordeño 1, ordeño 2, planta, venta), el Hato lechero, la Matriz de ordeñe (últimos 30 partes) y los Lotes de producto terminado (por vencimiento).

Cada carga responde con el mismo texto que Walter daría por WhatsApp (“Cargado.” o el detalle del movimiento) y queda en la Bitácora con origen web.

• Walter no responde en WhatsApp. El Centro dice “Canal de WhatsApp: pendiente de configuración” o el Token no coincide con el del canal. También puede estar apagado el interruptor Walter activo. Revise Salud de la API en el Centro: debe responder “encendido”.
• Responde “no tiene permiso para esta acción”. El rol del número no autoriza esa acción (por ejemplo, un cliente pidiendo registrar una compra). Cambie el rol en Actores y roles.
• Un cliente nuevo no puede hacer pedidos. El Rol por defecto es prospecto (solo precios). Cámbielo a cliente o asigne el rol a mano.
• “ya pagué” y Walter no encuentra el pago. El pago no llegó a Cobros Yape / QR, es menor al Monto mínimo, o pasó la Ventana de conciliación. Registre un pago manual y pida al cliente que repita “ya pagué”.
• Walter facturó al cliente genérico. El actor no tiene asignado su Cliente de NITRO. Asígnelo en Actores y roles; las próximas facturas saldrán a su nombre.
• “Celular requerido” al crear un actor: falta el número.
• “Etapa no reconocida.” / “No se pudo cargar.” en la carga de producción: el producto o la planta elegidos no existen en el inventario, o el almacén de esa etapa no está creado.
• Mensajes de voz mal interpretados. La transcripción falla con ruido o términos muy locales. Walter siempre repite lo que entendió antes de pedir confirmación: si está mal, responda no y escríbalo.
• “No tiene permiso para este módulo…“ en NITRO: falta el área Walter en el rol del usuario; vuelva a iniciar sesión tras asignarla.

¿Walter emite facturas electrónicas al SIAT? Emite facturas de venta en NITRO con los datos del actor (NIT/CI). Si la empresa tiene activa la facturación electrónica, se aplican las mismas reglas que a cualquier factura.

¿Puedo tener varios números de WhatsApp? Un canal por empresa. Varias personas pueden atender la bandeja del Panel de WhatsApp mientras Walter responde lo automático.

¿Qué pasa si dos personas confirman lo mismo? La idempotencia por mensaje evita el doble registro: la segunda confirmación recibe la respuesta de que ya está hecho.

¿Walter puede responder preguntas sobre cómo usar NITRO? Sí: usa la wiki de Inventario y Producción como base de conocimiento para interpretar los partes de planta y responder dudas básicas del proceso.

¿Dónde se configura la receta del queso y el costo por litro? En el catálogo de producción de NITRO: lista de materiales (receta) y centros de trabajo (Producción, Kits, producción y etapas).

• Cobros Yape / QR (central de cobros) · Venta digital
• Ventas paso a paso · Compras y gastos
• Inventario y producción · Producción · Kits, producción y etapas
• Usuarios y roles