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.

Jun 26, 2026

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

  1. Ve a Configuración → Agentes IA y entra al agente que quieres editar.
  2. Selecciona la pestaña Acciones personalizadas.
  3. En la sección Acciones personalizadas (debajo de Herramientas nativas) pulsa Nueva acción.
  4. 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).
  5. 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.
  6. 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 !nombre en 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_case empezando por una letra; la Descripción necesita al menos 10 caracteres; la URL debe empezar por https://.
  • 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

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp