Tools nativas

1. Selecciona el nodo AI Agent en tu flujo
2. Abre la sección TOOLS en la configuración del nodo
3. Haz clic en el botón ”+ Agregar tools”
4. En el campo “Selecciona un Tool”, verás la lista de todas las tools disponibles, incluyendo las nativas (marcadas con el texto “(Nativa)”)

​

Búsqueda de productos

“Si el usuario pregunta por la disponibilidad de algún artículo o modelo específico, DEBES usar la herramienta search_products para consultar el catálogo antes de responder.”

{
  "product": "iPhone 15 Pro",
  "top_k": 5,
  "score_threshold": 0.85
}

• Requiere que el bot tenga un catálogo de productos configurado y accesible.

​

Transferir a asesor

“Cuando el usuario exprese frustración o solicite hablar explícitamente con una persona real, ejecuta la función transfer_to_agent inmediatamente.”

{
  "assignment_type": "direct",
  "assignment_by": "shuffle"
}

{
  "assignment_type": "direct",
  "assignment_by": "team",
  "teamId": 4501
}

{
  "assignment_type": "queue",
  "assignment_by": "general",
  "priority": 5
}

• Puede finalizar el flujo de IA inmediatamente.
• Cuando se usa assignment_type: "queue" con assignment_by: "general", se crea un ticket en la cola general de atención.
• Importante: No se deben inventar IDs de equipos u operadores; se deben usar los configurados explícitamente.

​

Enviar mensajes interactivos

• title (string, obligatorio): Texto de la opción/botón. Máximo 20 caracteres. No se permiten títulos duplicados.
• description (string, opcional): Descripción adicional de la opción. Máximo 72 caracteres.

“Si el usuario pregunta qué servicios ofrecemos DEBES usar send_interactive_message para mostrar un menú con las opciones disponibles.”

{
  "text": "¿Cómo deseas continuar con tu consulta?",
  "title": "Opciones de Servicio",
  "caption": "Selecciona una opción",
  "options": [
    {
      "title": "Hablar con Agente",
      "description": "Transferir a soporte humano"
    },
    {
      "title": "Ver Catálogo",
      "description": "Explorar productos disponibles"
    }
  ]
}

{
  "text": "Tenemos varios departamentos disponibles para atenderte.",
  "title": "Departamentos",
  "caption": "Ver opciones",
  "options": [
    { "title": "Ventas", "description": "Consultas de productos y precios" },
    { "title": "Soporte Técnico", "description": "Ayuda con problemas técnicos" },
    { "title": "Facturación", "description": "Consultas sobre pagos" },
    { "title": "Devoluciones", "description": "Gestionar devoluciones" }
  ]
}

• Envía un mensaje real al usuario.
• El tipo de mensaje se adapta automáticamente según el canal y la cantidad de opciones.

​

Enviar Call to Action (CTA)

“Cuando el usuario confirme que desea realizar el pago, usa send_call_to_action con is_webview=true para enviar el enlace de pago y esperar la confirmación.”

{
  "text": "Visita nuestra tienda online para ver todos los productos disponibles.",
  "url": "https://tienda.ejemplo.com/catalogo",
  "display_text": "Ver Catálogo",
  "title": "Tienda Online"
}

{
  "text": "Haz clic en el botón para completar tu pago de forma segura.",
  "url": "https://pagos.ejemplo.com/checkout",
  "display_text": "Pagar Ahora",
  "title": "Completar Pago",
  "is_webview": true,
  "expiration_time": 600,
  "pending_message": "Por favor, completa el pago en la ventana abierta antes de continuar.",
  "response_variable": "payment_result",
  "input": {
    "order_id": "12345",
    "amount": 99.99
  }
}

• CTA normal: "Call-to-action message sent successfully."
• WebView: "WebView message sent. Waiting for user action."

• Disponible solo para los proveedores de WhatsApp que soportan este tipo de mensajes.
• Cuando is_webview=true, el flujo se pausa hasta que el WebView devuelve un callback o expira el tiempo.
• El valor de input se convierte a parámetros de URL query string.
• La respuesta del callback se guarda en la variable especificada en response_variable.

​

Fecha y hora actual

“Antes de procesar cualquier solicitud que dependa de la hora (como ‘buenos días’ o citas para ‘hoy’), llama a get_current_date_time para saber la hora exacta.”

{
  "timezone": "America/Mexico_City"
}

• No tiene efectos secundarios visibles para el usuario.
• Es puramente informativa para el modelo.

​

Día de la semana

“Si el usuario quiere agendar para una fecha específica, verifica primero qué día de la semana es usando get_weekday_of_a_date para asegurar que sea un día hábil.”

{
  "date": "2025-12-10"
}

• Útil para validar citas o agendas.