Cómo conectar un agente de IA a tu propia API

Crea una acción personalizada para que un agente de Sell Whisper AI llame a tu endpoint HTTP durante una conversación, con datos de entrada, autenticación y una prueba. Desde Starter.

Pasos

Hazlo en este orden

  1. Crea una acción personalizada

    Abre el agente, ve a Acciones (Actions), luego a Acciones personalizadas (Custom actions), y crea una acción de tipo Llamada a API (API Call). Las acciones personalizadas están disponibles desde Starter.

    Lista de acciones personalizadas de un agente
  2. Describe cuándo usarla

    Dale a la acción un nombre y una descripción, y completa Cuándo usar (When to Use) con palabras sencillas: ese texto le indica a la IA cuándo llamar a tu endpoint. En Datos del usuario (User Inputs), agrega cada valor que el agente debe recopilar, con su tipo y si es obligatorio.

    Formulario de acción personalizada para una llamada a la API, con cuándo usarla y el endpoint
  3. Apúntala a tu endpoint

    Define el método, la URL del endpoint, los encabezados, los parámetros de consulta y un cuerpo de solicitud en JSON. Elige el tipo de autenticación: clave de API, bearer token, autenticación básica o un encabezado personalizado.

  4. Pruébala y actívala

    Guarda y luego haz clic en Probar con datos reales (Test with Live Data) para ejecutar la llamada. Exige la confirmación del usuario para todo lo que modifique datos, activa la acción y pruébala en el Área de pruebas (Playground).

Cuatro tipos de acción personalizada

TipoQué hace
Llamada a API (API Call)Llama a tu endpoint HTTP desde los servidores de Sell Whisper AI y entrega la respuesta al agente
Botón con enlace (Button Link)Muestra un botón que abre una URL
Formulario (Form)Muestra un formulario y envía a un webhook lo que tu cliente ingresa
Cliente (Client)Ejecuta un handler que registras en tu propia página, en el navegador del visitante

Esta guía usa Llamada a API (API Call). Sirve para consultas como el estado de un pedido, el saldo de una cuenta o una reserva, y para cambios como cancelar una suscripción.

Escribe la descripción para la IA

El agente decide cuándo llamar a una acción a partir de su descripción y de su texto Cuándo usar (When to Use), así que escríbelos como le explicarías la tarea a un colega nuevo: qué devuelve la acción y qué situaciones la requieren. Nombra cada dato de entrada con claridad e indica cómo es un valor válido. Las descripciones vagas son el motivo habitual de que una acción nunca se llame, o se llame en el momento equivocado.

Mantenla segura

  • Autenticación. Guarda la clave de API, el bearer token o las credenciales básicas en la acción; nunca se muestran a tu cliente.
  • Confirmación. Activa la confirmación del usuario para todo lo que modifique datos, de modo que tu cliente apruebe la llamada primero.
  • Límites y reintentos. Define un tiempo de espera y un número de reintentos para un endpoint lento, y los límites de frecuencia en Avanzado (Advanced).
  • Quién pregunta. Para las llamadas específicas de una cuenta, verifica a los usuarios con sesión iniciada para que la solicitud lleve una identidad firmada por tu servidor.

Muestra el resultado

Activa la vista de resultados para mostrar la respuesta como tarjeta, formulario o tabla en el widget. Las apps de mensajería reciben el mismo contenido como texto.

Relacionado

Preguntas frecuentes

Preguntas comunes

¿La respuesta se puede mostrar como tarjeta o como tabla?
Sí. Activa la vista de resultados y asigna la respuesta a una tarjeta, un formulario o una tabla. Los canales que no pueden mostrarlos, como WhatsApp, reciben el mismo contenido como texto.
¿Una acción puede ejecutarse en mi página en lugar de en un servidor?
Sí. El tipo Cliente (Client) pasa la llamada a un handler que registras en tu página mediante el SDK del widget. Solo se ofrece en el widget del sitio web.
¿Dónde puedo ver qué se llamó?
Cada acción personalizada guarda registros de ejecución con el estado, las entradas, las salidas y la duración de cada llamada.

Documentación relacionada

Empieza

Pon los pasos en práctica

Empieza gratis, sin tarjeta de crédito.