Paso: VectorPOS
Carga productos, toma pedidos con IA, revisa pedidos con agente, crea invoices o consulta pedidos en VectorPOS.
VectorPOS agrupa varias acciones para negocios que toman pedidos por WhatsApp. Puede cargar productos, preparar un pedido con IA, pedir confirmación al cliente, permitir revisión por agente y crear o consultar pedidos en VectorPOS.
Modos disponibles
| Modo | Qué hace | Cuándo usarlo |
|---|---|---|
| Productos | Carga productos desde VectorPOS y los guarda como variables. | Antes de mostrar un menú, usar IA o enviar productos a un Flow. |
| Pedido manual 1 por 1 | Crea un pedido con productos configurados manualmente en el paso. | Pedidos simples con pocos productos conocidos. |
| Checkout confirmado | Crea un invoice desde un JSON de pedido ya confirmado. | Después de IA o WhatsApp Flow. |
| Pedido IA para agente | Pausa el flujo de trabajo para que un agente revise y edite el pedido antes de crear el invoice. | Pedidos que requieren control humano. |
| Consultar pedido | Consulta un pedido existente por ID. | Dar estado de pedido o confirmar información. |
| AI: solo detectar | La IA interpreta mensajes del cliente y guarda un borrador de pedido. | Cuando quieres revisar o transformar el pedido después. |
| AI: tomar y confirmar | La IA arma el pedido, envía confirmación y espera botones del cliente. | Toma de pedido automática con confirmación. |
Productos
El modo Productos trae el catálogo de VectorPOS y lo guarda con un prefijo de variables. Es el punto de partida recomendado para flujos de pedido porque alimenta a la IA, al WhatsApp Flow o al checkout.
| Variable | Qué contiene | Uso |
|---|---|---|
| `${vectorpos.products.grouped_json}` | Productos agrupados para que la IA los lea. | Detectar productos en mensajes del cliente. |
| `${vectorpos.products.flow_json}` | Estructura preparada para Flow. | Enviar menú dinámico a WhatsApp Flow. |
| `${vectorpos.products.first_image_base64}` | Primera imagen de producto disponible. | Usar como dato inicial de imagen. |
- Puedes cambiar el prefijo `vectorpos` si necesitas separar varios pasos.
- Puedes activar sincronización al catálogo cuando el flujo también debe actualizar el catálogo interno.
- Puedes activar rama por fallo de VectorPOS para manejar errores de API.
Pedidos
| Configuración | Qué requiere | Ejemplo |
|---|---|---|
| Cliente | Nombre, teléfono y dirección. | `${contact.name}`, `${contact.phone}`, `${flow.direccion}`. |
| Productos manuales | Código, precio, cantidad y detalle opcional. | Código `PIZZA001`, cantidad `2`. |
| Checkout desde JSON | Variable con pedido confirmado. | `@vectorpos.confirmed_order_json`. |
| Pago | Método, vuelta/cambio, valores que cuentan como efectivo. | `efectivo,cash` como valores de efectivo. |
| Entrega | Domicilio, notas y detalles extra. | `Entrega en recepción`. |
| Ramas de recuperación | Validación y fallo de API. | Conectar revisión manual si faltan datos o falla VectorPOS. |
AI para pedidos
| Campo | Qué hace | Recomendación |
|---|---|---|
| Modo AI | `Solo detectar` guarda borrador; `Tomar y confirmar` también pide confirmación al cliente. | Empieza con `Tomar y confirmar` si quieres automatizar de punta a punta. |
| Esperar mensajes | La IA espera un silencio antes de procesar. | 5s para pedidos cortos, 8s como base, 12s si los clientes escriben en partes. |
| Confianza | Mínimo de seguridad para aceptar el pedido. | `Normal` como punto inicial; `Estricta` si prefieres revisar más casos. |
| Variable de productos | Catálogo que la IA puede leer. | Usa `${vectorpos.products.grouped_json}` después de cargar productos. |
| Variable de borrador | Dónde se guarda el JSON detectado. | `vectorpos.order_draft_json`. |
| Variable de mensaje | Dónde se guarda el texto de confirmación. | `vectorpos.confirmation_message`. |
| Botones | Confirmar, corregir o cancelar. | Mantén textos cortos y claros. |
| Ramas | Baja confianza, timeout, fallo de envío y cancelación. | Conecta revisión humana para baja confianza y cancelación. |
Ejemplos
Pedido automático con confirmación
Tomar un pedido desde mensajes libres del cliente.
- Paso 1: `VectorPOS` en modo Productos con prefijo `vectorpos`.
- Paso 2: `VectorPOS` en modo `AI: tomar y confirmar`.
- Variable de productos: `${vectorpos.products.grouped_json}`.
- Rama éxito: `WhatsApp Flow` para dirección y pago, si hace falta.
- Paso final: `VectorPOS` en modo `Checkout confirmado`.
El cliente puede escribir su pedido de forma natural y el flujo de trabajo lo convierte en un proceso estructurado.
Pedido con revisión de agente
Permitir que una persona revise el pedido antes de crear invoice.
- Carga productos con VectorPOS.
- Usa IA para detectar el borrador.
- Usa `Pedido IA para agente` con catálogo y datos del cliente.
- El agente revisa y envía el pedido.
- Conecta ramas de validación y fallo de API.
El flujo de trabajo mantiene automatización, pero deja control humano donde el negocio lo necesita.
Ramas y salidas
| Modo | Salidas posibles | Qué significa |
|---|---|---|
| Productos | `success`, `failure_api` si está activa. | Productos cargados o fallo al consultar VectorPOS. |
| AI: solo detectar | `success`, `low_confidence`. | Pedido detectado o confianza insuficiente. |
| AI: tomar y confirmar | `success`, `low_confidence`, `failure_timeout`, `failure_send`, `cancelled`. | Confirmación, baja confianza, no respuesta, fallo de envío o cancelación. |
| Checkout confirmado | `success`, `failure_validation`, `failure_api` si están activas. | Pedido creado, datos inválidos o fallo de VectorPOS. |
| Pedido IA para agente | `success`, `failure_validation`, `failure_api` si están activas. | Pedido revisado y enviado, datos inválidos o fallo externo. |
Límites y validaciones
- El prefijo de variables no debe tener espacios.
- Crear pedido requiere nombre, teléfono y dirección del cliente.
- Pedido manual requiere al menos un producto con código, precio y cantidad.
- Checkout confirmado requiere una variable JSON de pedido confirmado.
- Pedido IA para agente requiere JSON confirmado y catálogo de productos.
- AI requiere variable de productos y confianza mínima entre 0 y 1.
- Timeout de confirmación AI debe estar entre 1 minuto y 24 horas.
- Si exiges vuelta para efectivo, configura también la variable de método de pago.
- Si activas ramas de validación o fallo de API, conecta las salidas correspondientes.
Buenas prácticas
- Carga productos antes de usar IA o menú dinámico.
- Mantén el prefijo `vectorpos` salvo que tengas varios flujos de pedido en el mismo flujo de trabajo.
- Usa revisión de agente cuando el costo de un pedido mal armado sea alto.
- Conecta baja confianza a una ruta humana o a una pregunta aclaratoria.
- Prueba con pedidos reales: productos, cantidades, notas y cambios.
- Agrega ramas de fallo de API para no perder pedidos si VectorPOS no responde.