La herramienta está disponible para todos los canales: Chat, Teléfono y Email.
No confundir con la solicitud HTTP en Automatizaciones. En las Automatizaciones, la solicitud HTTP es un paso del flujo que se ejecuta en un momento fijo. Esta herramienta pertenece al propio Agente de IA: es él quien decide durante la conversación si realiza la solicitud y cuándo, y sigue trabajando con la respuesta.
Requisitos: un Agente de IA en Superchat y una API que quieras llamar (URL, método, credenciales si son necesarias).
Añadir la herramienta
Abre tu Agente de IA y ve a la sección Herramientas y Acciones a la izquierda.
Haz clic en Añadir herramienta, arriba a la derecha.
Selecciona la tarjeta Solicitudes HTTP y haz clic en Añadir.
Se abre el editor de la herramienta con seis pestañas: General, Parámetros, Solicitud, Cuerpo, Credenciales y Test.
General: nombre y regla de uso
Nombre de la herramienta: Un nombre breve que describe lo que hace la herramienta, p. ej. "Consultar estado del pedido" o "Crear cita". El nombre aparece en la lista bajo Herramientas y Acciones.
¿Cuándo debe usar el agente la herramienta? Esta descripción es la parte más importante de la herramienta. El Agente de IA decide si hacer la solicitud basándose en este texto. Describe con detalle en qué situación debe usar la herramienta, qué encontrará en la respuesta y cómo debe utilizarla. Menciona también cuándo no debe usarla.
Ejemplo: "Usa esta herramienta cuando el cliente pregunte por el estado de su pedido. En la respuesta encontrarás el estado actual y la fecha de entrega prevista, que debes indicar al cliente. No uses la herramienta si el cliente no ha indicado un número de pedido."
Parámetros: qué valores proporciona el agente
Los parámetros son los valores que cambian de una solicitud a otra, por ejemplo un número de pedido o el número de teléfono del contacto. Los defines aquí y luego los insertas mediante el botón { } en la URL, los parámetros de consulta, las cabeceras o el cuerpo.
Haz clic en Añadir y rellena para cada parámetro:
Nombre: El nombre con el que insertarás el valor más adelante.
Origen: De dónde procede el valor.
Agente de IA: El agente obtiene el valor de la conversación, p. ej. un número de pedido que menciona el cliente.
Atributo de contacto: El valor procede de los datos existentes del contacto en Superchat, p. ej. el número de cliente.
Tipo: Tipo de dato del valor, p. ej. texto.
Descripción: Qué es el valor y de dónde procede. Con el origen "Agente de IA", la descripción ayuda al agente a extraer el valor correcto de la conversación.
Obligatorio: Si la solicitud necesita el valor de forma obligatoria.
La columna Uso muestra si el parámetro ya se ha insertado en algún punto de la solicitud. Si indica "No vinculado", el valor todavía no se envía en ningún sitio.
Consejo sobre "Obligatorio": Desactiva "Obligatorio" para todo lo que proceda de la conversación. Si el valor no está disponible, el agente simplemente omitirá el campo, en lugar de bloquear la solicitud o preguntar innecesariamente al cliente.
Solicitud: método, URL, parámetros de consulta y cabeceras
Método y URL: Elige a la izquierda el método HTTP (p. ej. POST) e introduce a la derecha la URL de tu API o webhook.
Parámetros de consulta: Pares nombre-valor que se añaden a la URL. Usa Añadir para crear más.
Cabeceras: Pares nombre-valor para las cabeceras HTTP, p. ej.
Content-Type. Las credenciales no van aquí, sino en la pestaña Credenciales.Tiempo límite: Segundos tras los cuales se cancela la solicitud (predeterminado: 30). Por teléfono, la persona que llama espera mientras tanto; mantén el valor lo más bajo que tu API permita.
En todos los campos puedes insertar un parámetro mediante el botón { }.
Cuerpo: contenido de la solicitud
Elige qué envía la solicitud:
Sin cuerpo: La solicitud no envía ningún contenido. Adecuado para consultas sencillas.
JSON: Datos estructurados, el estándar para la mayoría de las API y webhooks.
Datos de formulario: Campos de formulario clásicos.
Texto plano: Contenido de texto libre.
Aquí también insertas parámetros mediante { }, p. ej. {"numero_pedido": {{numero_pedido}}}.
Credenciales: autenticar tu API de forma segura
Si tu API necesita una clave de API o un token, lo guardas aquí. Selecciona credenciales existentes en el desplegable o haz clic en Crear nuevas credenciales. Una vez creadas, las credenciales vuelven a estar disponibles para otras herramientas.
Las credenciales se almacenan de forma segura. El Agente de IA nunca ve ni establece estos valores, por lo que tampoco puede revelarlos accidentalmente durante la conversación.
Test: ejecutar la solicitud real una vez
Antes de guardar, comprueba la solicitud en la pestaña Test. Introduce un valor de ejemplo para cada parámetro y haz clic en "Enviar solicitud de prueba". La solicitud se envía realmente a tu API, así que usa datos de prueba.
El aviso "No se utiliza ningún parámetro en ningún sitio: esta herramienta siempre llama a la misma solicitud" significa que has creado parámetros pero no los has insertado en ningún sitio mediante { }, o que la herramienta funciona sin ningún parámetro. Para una consulta fija esto está bien; en cuanto el agente deba enviar valores de la conversación, insértalos en la URL, la cabecera o el cuerpo.
Después haz clic en Guardar. La herramienta aparece en la lista bajo Herramientas y Acciones como Solicitudes HTTP: <Nombre>.
Probar en la conversación
Abre a la derecha el Entorno de prueba, elige el canal (Chat, Teléfono o Email) y hazle a tu Agente de IA la pregunta que debería activar la herramienta. Así verás si la utiliza en el momento adecuado y si usa la respuesta de forma sensata.
Si el agente no usa la herramienta, primero afina el texto en ¿Cuándo debe usar el agente la herramienta? y menciona además la herramienta en Tarea y Reglas, bajo "¿Qué debe hacer tu agente?", p. ej.: "Si un cliente pregunta por su pedido, consulta el estado del pedido mediante la herramienta e indícale el estado y la fecha de entrega."
Importante: En el Entorno de prueba no se comparten los atributos de contacto. En el Entorno de prueba solo es posible trabajar con parámetros que el agente extrae de la conversación actual. Usa una conversación real, iniciada por ti mismo, para probar con atributos de contacto.
Buenas prácticas
Formula la regla de uso en positivo y en negativo. Cuándo sí, cuándo no.
Mantén las respuestas ligeras. El agente lee la respuesta de tu API. Cuanto más clara y breve sea, más precisa será su comunicación con el cliente.
Mantén el tiempo límite lo más bajo posible. El contacto percibe cada segundo de espera. Por teléfono recomendamos como máximo 10 segundos, y en chat 30 segundos.
Prueba con datos de prueba. La solicitud de prueba y las pruebas en el Entorno de prueba llaman realmente a tu API.