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.
Hazlo en este orden
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.

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.

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.
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
| Tipo | Qué 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
- Acciones personalizadas: la referencia completa.
- Cómo enviar leads y tickets del chat a HubSpot y cómo dejar que un agente de IA agende reuniones: integraciones incluidas que no necesitan una acción personalizada.
- Agente de IA: por qué un agente que actúa es distinto de un chatbot que responde.

