🔧 Importar cURL en la Herramienta de Llamada a API del Estudio de Agentes IA
Importar cURL te permite pegar un comando cURL y convertirlo automáticamente en una configuración de Llamada a API dentro de CRMHUB, para construir solicitudes de API más rápido.
📋 Contenido de este Tutorial
🔧 ¿Qué es Importar cURL?
✨ Beneficios Clave
📍 Dónde Funciona Importar cURL
📥 Qué Completa Automáticamente
🔍 Revisar la Configuración Importada
🔄 Sincronización Bidireccional con cURL
⚖️ Herramienta de Llamada a API vs. API Pública
🧭 Cómo Configurar Importar cURL
❓ Preguntas Frecuentes
🔧 ¿Qué es Importar cURL?
Te permite pegar un comando cURL y convertirlo automáticamente en campos de configuración de Llamada a API, como el método, la URL del endpoint, los encabezados, y el cuerpo de la solicitud, sin copiar manualmente cada valor a campos separados.
✨ Beneficios Clave
Configuración de API más rápida: pega un comando cURL para completar automáticamente los detalles de la solicitud.
Configuración amigable para desarrolladores: mueve solicitudes desde documentación de API, comandos de terminal, o herramientas de prueba de API hacia el Estudio de Agentes IA más fácilmente.
Menos entrada manual: evita copiar el método HTTP, URL, encabezados, y cuerpo de la solicitud uno por uno.
Mejor revisión de solicitudes: vuelve a abrir el modal para ver la configuración actual reconstruida como comando cURL.
Manejo flexible de solicitudes: soporta patrones comunes de cURL como redirecciones, autenticación básica, cuerpos de solicitud multilínea, y continuaciones de línea con barra invertida.
📍 Dónde Funciona Importar cURL
Está disponible dentro del panel de configuración de la herramienta de Llamada a API. Esta herramienta se usa cuando un agente necesita hacer una solicitud web externa como parte de un flujo del Estudio de Agentes IA. Importar cURL puede usarse al configurar una Llamada a API en:
Un nodo de Agente IA, donde la Llamada a API se agrega como herramienta que el agente puede usar.
Un Nodo Secuencial, donde la Llamada a API corre como un paso de procesamiento definido dentro de una secuencia estructurada.
📥 Qué Completa Automáticamente
Extrae detalles del comando cURL pegado y los usa para llenar los campos de la Llamada a API:
Método HTTP
URL del endpoint de la API
Encabezados
Cuerpo de la solicitud
También puede detectar tipos comunes de cuerpo de solicitud: JSON, HTML, XML, Texto, y Datos de Formulario. Y soporta patrones comunes de cURL: redirecciones --location, autenticación básica -u, cuerpos de solicitud multilínea, y continuaciones de línea con barra invertida \.
🔍 Revisar la Configuración Importada
Siempre revisa la configuración importada antes de guardar, probar, o publicar el agente. Revisa estos campos después de importar:
Instrucciones: describe qué hace la Llamada a API y cuándo el Agente IA debe usarla.
Nombre de Variable: confirma dónde se guardará el resultado de la llamada.
Endpoint de la API: verifica el método HTTP y la URL del endpoint.
Encabezados: confirma los encabezados requeridos, como tipo de contenido o autorización.
Cuerpo de la Solicitud: revisa el payload y formato importados.
Valores de autenticación: revisa si tokens, credenciales, o claves deben reemplazarse, eliminarse, o asegurarse.
Variables: agrega variables dinámicas del Estudio de Agentes IA si la solicitud debe usar datos de contacto, conversación, o tiempo de ejecución.
🔄 Sincronización Bidireccional con cURL
Permite que el modal de Importar cURL refleje la configuración actual de la Llamada a API como un comando cURL. Cuando vuelves a abrir el modal después de configurar una Llamada a API, CRMHUB reconstruye la configuración actual como comando cURL. Puedes usar esto para revisar la solicitud, hacer cambios, y volver a importar la versión actualizada.
Especialmente útil cuando: quieres verificar el formato de la solicitud, necesitas comparar la configuración con documentación externa de API, quieres editar rápido encabezados o contenido del cuerpo, o estás depurando una solicitud antes de publicar el agente.
⚖️ Herramienta de Llamada a API vs. API Pública
Cumplen propósitos distintos:
La Herramienta de Llamada a API permite que un agente de CRMHUB haga una solicitud web externa mientras se ejecuta — por ejemplo, llamar a un sistema externo para obtener datos, enviar información, o disparar un proceso externo.
La API Pública del Estudio de Agentes IA permite que aplicaciones externas listen, obtengan, y ejecuten agentes de CRMHUB listos para producción de forma programática, sin iniciar sesión en el panel.
Usa la Herramienta de Llamada a API cuando el agente necesite llamar a una API externa durante su flujo. Usa la API Pública cuando un sistema externo necesite interactuar con tus agentes.
🧭 Cómo Configurar Importar cURL
Paso 1: Ve a Agentes IA en CRMHUB.
Paso 2: Haz clic en la pestaña Estudio de Agentes IA.
Paso 3: Haz clic en Crear Agente o abre uno existente.
Paso 4: Agrega o selecciona un disparador de inicio (Mensaje de Chat, Envío de Formulario, Etiqueta de Lead, o Workflow).
Paso 5: Agrega un nodo de Agente IA o Secuencial al lienzo.
Paso 6: Agrega la herramienta o nodo de procesamiento de Llamada a API.
Paso 7: Abre el panel de configuración de la Llamada a API.
Paso 8: Haz clic en Importar cURL.
Paso 9: Pega el comando cURL en el campo Comando cURL.
Paso 10: Haz clic en Importar.
Paso 11: Revisa los campos completados: método HTTP, URL del endpoint, encabezados, cuerpo de la solicitud, tipo de cuerpo, nombre de variable, e instrucciones (cuando se usa dentro de un nodo de Agente IA).
Paso 12: Haz las ediciones necesarias.
Paso 13: Haz clic en Guardar.
Paso 14: Usa Probar para verificar la Llamada a API antes de publicar el agente.
Paso 15: Haz clic en Publicar cuando el agente esté listo.
❓ Preguntas Frecuentes
¿Qué hace Importar cURL? Convierte un comando cURL pegado en campos de configuración de Llamada a API, como el método, URL del endpoint, encabezados, y cuerpo de la solicitud.
¿Puedo editar la Llamada a API después de importar? Sí. Revisa y actualiza los campos completados antes de guardar o probar.
¿Soporta comandos multilínea? Sí, soporta cuerpos de solicitud multilínea y continuaciones de línea con barra invertida.
¿Qué tipos de cuerpo puede detectar? JSON, HTML, XML, Texto, y Datos de Formulario.
¿Puedo usar variables después de importar un comando cURL? Sí. Después de importar, puedes revisar los campos y agregar variables soportadas del Estudio de Agentes IA donde se necesiten valores dinámicos.
¿Debo probar la Llamada a API antes de publicar? Sí, siempre, especialmente cuando incluye autenticación, variables, encabezados, o un cuerpo de solicitud.
¿Importar cURL es lo mismo que la API Pública? No. Importar cURL ayuda a configurar una Llamada a API dentro de un agente. La API Pública es usada por aplicaciones externas para interactuar con tus agentes programáticamente.
¿Qué debo revisar si la solicitud importada no funciona? Revisa la URL del endpoint, método HTTP, encabezados, valores de autorización, cuerpo de la solicitud, tipo de cuerpo, y cualquier variable usada. Luego prueba el agente de nuevo.