Creando y configurando acciones de IA

Creando una Acción de IA

Navega a Configuración → Integraciones → Acciones de IA y haz clic en Agregar Acción para comenzar.

Paso 1: Información Básica

• Nombre: Un nombre corto y descriptivo (por ejemplo, "Consultar Estado del Pedido"). La IA utiliza esto para decidir cuándo activar la acción.
• Descripción: Explica lo que hace la acción en lenguaje sencillo. Sé específico. La IA lee esto para entender cuándo es relevante la acción.

Paso 2: Configuración de la API

• Método HTTP: Elige GET, POST, PUT, PATCH o DELETE dependiendo de tu API.
• URL: La URL completa del endpoint de la API (debe usar HTTPS). Usa la sintaxis {parameter_name} para parámetros de ruta (por ejemplo, https://api.example.com/orders/{order_id}).

Paso 3: Autenticación

Elige un método de autenticación:

• Ninguna: No se requiere autenticación (APIs públicas).
• Token Bearer: Un token fijo enviado en el encabezado Authorization: Bearer <token>.
• Token Bearer del Cliente: Utiliza el propio token del cliente (almacenado en su perfil) para acceso a la API por usuario, con un respaldo al token predeterminado.

Consulta Métodos de Autenticación de Acciones de IA para obtener orientación detallada sobre cada opción.

Paso 4: Parámetros

Agrega parámetros que el chatbot debe recopilar de la conversación:

• Nombre: Identificador del parámetro (por ejemplo, order_id, email).
• Tipo: Cadena, Número o Booleano.
• Descripción: Indica a la IA qué representa este parámetro.
• Ubicación: Dónde va el parámetro en la solicitud: Ruta, Consulta, Cuerpo o Encabezado.
• Requerido: Si la IA debe recopilar este valor antes de llamar a la API.

Paso 5: Tiempo de Espera

Establece un tiempo de espera entre 1 y 30 segundos (predeterminado: 10). Si la API externa no responde a tiempo, el chatbot informa al cliente y sugiere contactar a un agente humano.

Probando Tu Acción

Haz clic en Probar Acción para ejecutar la acción con valores de parámetros de muestra. Verás la respuesta HTTP completa, incluyendo el código de estado y el cuerpo. Corrige cualquier error antes de habilitar la acción.

Habilitando la Acción

Las nuevas acciones están deshabilitadas por defecto. Activa Habilitar cuando estés listo para que el chatbot comience a usarla. Puedes deshabilitar una acción en cualquier momento sin eliminarla.