Acciones personalizadas HTTP: crear y configurar una integración
Conecta tu agente de IA con cualquier API externa para que consulte planes, registre pedidos o llame a tus sistemas durante la conversación.
Mira este paso en el video · Acciones personalizadas: crear una
Qué son las acciones personalizadas
Las acciones personalizadas son endpoints HTTP que tu agente de IA puede invocar por su cuenta durante una conversación. Sirven para que el agente consulte información en vivo (planes, stock, estado de un pedido) o registre datos en tus sistemas (crear un ticket, dar de alta un lead) sin que un humano intervenga. Mientras las Herramientas nativas cubren acciones internas de Omnifox (cerrar conversación, asignar, disparar workflow), las acciones personalizadas conectan tu agente con cualquier API externa.
Requisitos
- Tu organización debe tener el plan Impulsa o superior (el plan Lite no las incluye). Si tu plan no las incluye, verás un candado y el botón Ver planes.
- El agente debe ser de texto (las acciones se configuran en agentes de texto, no de voz).
- La API destino debe responder por HTTPS y, normalmente, aceptar un header de autenticación (token, API key).
Pasos para crear una acción
- Ve a Configuración → Agentes IA y entra al agente que quieres editar.
- Selecciona la pestaña Acciones personalizadas.
- En la sección Acciones personalizadas (debajo de Herramientas nativas) pulsa Nueva acción.
- Completa la identidad de la acción:
- Nombre técnico: en
snake_case, p. ej.consultar_planes. El modelo la invoca en el prompt como!consultar_planes. - Etiqueta: el nombre legible que ves en la lista, p. ej. Consultar planes.
- Descripción (para el LLM): explica cuándo debe usarla. Es el texto que lee el modelo para decidir si la llama, así que sé concreto (entre 10 y 500 caracteres).
- Nombre técnico: en
- Configura la Solicitud HTTP:
- Método: GET, POST, PUT, PATCH o DELETE.
- URL: el endpoint completo, p. ej.
https://api.tudominio.com/planes. - Headers: agrega los que necesites, típicamente
Authorization: Bearer .... - Timeout (s): entre 1 y 60 segundos.
- Pulsa Guardar acción.
Al guardar, la acción aparece en la lista con su método, URL y un interruptor para activarla o desactivarla.
Verificación
- La nueva acción figura en la lista con la etiqueta
!nombreen color ámbar. - El interruptor está Activa.
- Tras guardar se habilita el botón Probar, que ejecuta una llamada real y te muestra la respuesta. Revisa cómo hacerlo en Probar y editar acciones personalizadas.
Si no funciona
- No veo la pestaña o aparece un candado: tu plan no incluye acciones personalizadas. Pulsa Ver planes y sube a Impulsa o superior.
- No me deja guardar: el Nombre técnico debe ser
snake_caseempezando por una letra; la Descripción necesita al menos 10 caracteres; la URL debe empezar porhttps://. - El agente no la usa: revisa que el interruptor esté en Activa y mejora la Descripción para que quede claro cuándo invocarla.
Tip: usa un nombre técnico que describa la intención (
consultar_stock,crear_pedido). El modelo se apoya en el nombre y la descripción para decidir.
Tip: empieza por una acción GET sencilla de solo lectura. Es más fácil de probar y no modifica datos si algo sale mal.
Artículos relacionados
Artículos relacionados
-
Crear tu primer agente de IA
Aprende qué hace un agente de IA en Omnifox, cómo darle instrucciones, conectarlo a un canal y probarlo en el sandbox antes de que hable con clientes reales.
-
Cómo escribir buenas instrucciones para tu agente de IA
Aprende a redactar instrucciones claras para que tu agente de IA responda con el tono, los límites y las acciones correctas.
-
Guía completa de los Agentes de IA
Los Agentes de IA a fondo, en 65 capítulos: crear, instrucciones, herramientas, conocimiento, comportamiento, probador, bandeja, flujos, analítica y consumo, con cada opción explicada.
-
Conectar tu agente de IA a WhatsApp, Instagram, Messenger y el chat web
Un agente sin canales no atiende a nadie. Conéctalo a tu WhatsApp, Instagram, Messenger o al chat de tu sitio web desde la sección Conexiones, y enciéndelo para que empiece a responder.
-
Empieza aquí: los Agentes de IA en 8 minutos
Lo esencial de los Agentes de IA en un video corto: crear un agente, sus instrucciones, herramientas, conocimiento, canales, el probador, el horario y el paso a una persona.