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 canal 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.

​

Mensajes interactivos

​

Configuración general: Botones y lista

​

Mensajes personalizados: Webview y Call to Action

​

Campos de Webview

​

Campos de Call to Action

​

Canales compatibles

​

Botones y lista

• 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) (Legacy)

“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.

​

Gestión de memoria

​

Memoria interna

• Incluye un campo opcional Espacio de memoria para aislar o agrupar los guardados, evitando que distintos contextos se mezclen.
• Cada operación admite configurar sus parámetros en modo IA, variable o estático, y un comportamiento post-ejecución (Continuar, Terminar o Pausar).

​

CRM de bandeja de entrada

• Los permisos se administran por grupo (datos del contacto / etiquetas) con lectura y escritura separadas. Puedes restringir a qué etiquetas puede acceder el agente.
• Requiere al menos un canal conectado para que existan contactos sobre los cuales operar.

​

$context

• En la lista de tools aparece como $context para distinguirla de la pestaña Contexto.
• Las variables escritas quedan disponibles para nodos posteriores del flujo, por ejemplo {{$context.mi_variable}}.

​

Información de plataforma

• Las tres fuentes son de solo lectura; el agente no puede modificarlas.
• Se inyectan como bloques de contexto, por lo que no cuentan como una invocación de herramienta.

​

Bases de datos

• El agente solo puede operar sobre las colecciones de la misma compañía que habilites explícitamente en el popover Configurar.
• Las operaciones de escritura persisten de inmediato.
• El comportamiento post-ejecución (Continuar, Terminar o Pausar) se configura por operación.

​

AI Routing

“Atiendes únicamente consultas de facturación: estados de cuenta, fechas de pago y detalle de cargos.”

{
  "mode": "evaluate",
  "message": "quiero reportar un problema con mi pedido"
}

{
  "mode": "direct",
  "target": "Soporte"
}

{
  "mode": "search"
}

• Una derivación exitosa termina el turno del agente: la respuesta al usuario llega desde el workflow de destino. El agente no debe responder también.
• Si no hay coincidencia o la derivación falla, el agente sigue a cargo de la conversación y debe continuar atendiendo al usuario.
• Requiere que el proyecto tenga AI Routing habilitado y workflows con nombre y descripción configurados. El comportamiento posterior a la ejecución es fijo: la derivación siempre termina el turno del agente.
• El agente solo puede derivar a workflows del mismo proyecto.

​

Documentos de conocimiento: búsqueda por archivo

• Detecta cuándo la pregunta se refiere a un documento y busca solo en ese documento.
• Busca en todos los documentos del agente, no solo en los del primer proyecto.
• Responde anclada a los documentos: si no encuentra nada relevante, lo dice.

​

Cómo detecta el documento

• Se ignoran mayúsculas, tildes, guiones y la extensión, y se toleran errores de escritura pequeños: “tarifario 2026”, “TARIFARIO” y “Tarifario_2026.pdf” encuentran el mismo archivo.
• Un documento se detecta cuando la pregunta incluye su nombre completo (“¿cuánto cuesta el plan básico del tarifario 2026?”) o lo menciona después de una palabra como “en”, “según”, “busca”, “revisa”, “consulta”, “dice”, “documento” o “archivo” (“según las políticas de envío…”).
• Palabras genéricas como “manual”, “guía”, “política” o “documento” no bastan por sí solas para elegir un archivo.

​

Respuestas ancladas a los documentos