Skip to main content

Capabilities Marketplace Pricing Blog Help Center Contact

The platform to build agents with memory, custom tools, and a REST API.

Product

Capabilities
Marketplace
Pricing
Changelog

Resources

Blog
Documentation
About

Support

FAQs
Support
Contact

Legal

Privacy
Terms
License
Security
Data deletion
Disclaimer
Do not sell my data

© 2026 Arko Studio. All rights reserved.

Centro de ayuda
Powers e integraciones

Powers e integraciones

Conecta tus agentes a APIs externas con Powers: webhooks, parámetros y autenticación.

¿Qué es un Power?Un Power es una herramienta personalizada que conectas a tus agentes. Permite que un agente llame a una API externa durante la conversación para traer datos en tiempo real, hacer una acción o consultar un servicio de terceros. Ejemplos: Buscar un producto en tu catálogo. Consultar el estado de un pedido. Crear un ticket en tu sistema de soporte. Enviar una notificación a Slack, Discord o Telegram. Técnicamente, un power es un webhook: defines una URL, el método HTTP y los parámetros, y el agente decide cuándo llamarlo según tu descripción. En el plan Free puedes crear hasta 50 powers.¿Cómo creo un Power (webhook)?Desde Powers, pulsa Nuevo Power y configura: Nombre — identificador del power (letras, números, y .). Descripción — clave: ayuda a la IA a entender cuándo usar esta herramienta. Sé específico (p. ej. "Busca productos en el catálogo por nombre o categoría"). Webhook URL — el endpoint al que Arko hará la petición. Método — GET, POST, PUT, PATCH o DELETE. Autenticación — opcional; un header como Authorization: Bearer … (ver autenticación). Parámetros — los argumentos que el agente enviará (ver parámetros). Guarda con Crear power y luego asígnalo a tus agentes. Tip: si no quieres empezar de cero, el marketplace trae integraciones ya configuradas para servicios populares.¿Qué es el marketplace de powers?El marketplace es un catálogo de integraciones verificadas por el equipo de Arko: powers preconfigurados para servicios populares (Slack, Discord, Telegram, Resend, PagerDuty y más). Al instalar una integración, Arko crea el power en tu cuenta con su URL, método y parámetros ya definidos según la API oficial del servicio. Solo te falta lo tuyo: Reemplaza los datos de tu cuenta en la URL o los headers (por ejemplo, la ruta de tu webhook de Slack o tu token de bot de Telegram). Pruébalo con Ejecutar prueba. Asígnalo a los agentes que lo van a usar. Es la vía más rápida para conectar servicios estándar sin leer la documentación de cada API.¿Cómo defino los parámetros de un Power?Los parámetros son los datos que el agente le envía a tu API al llamar el power. Para cada uno defines: Nombre del parámetro (p. ej. query, orderid). Descripción — explica qué es, para que el agente sepa con qué llenarlo. Valor por defecto — opcional. Requerido — si el agente debe enviarlo siempre. Un power puede tener hasta 10 parámetros. Si no defines ninguno, el agente llamará al webhook sin argumentos. Tip: describe cada parámetro con precisión. El agente decide qué valor mandar leyendo esa descripción: "Número de pedido, formato ORD-12345" rinde mucho más que "el pedido".¿Cómo autentico el webhook de un Power?Si tu API requiere autenticación, la configuras con un header en el power: Nombre del header — normalmente Authorization. Valor — por ejemplo Bearer sk... o tu clave de API. También puedes elegir Sin autorización si tu endpoint es público. Arko envía ese header en cada llamada al webhook, así que tu API puede validar que la petición viene de un power autorizado. Recomendación: usa un token con los permisos mínimos necesarios. Si el endpoint solo lee datos, no le des una clave con permisos de escritura. Y si un token se filtra, rótalo en tu servicio y actualiza el header del power: el cambio aplica en la siguiente llamada.¿Qué debe devolver mi webhook para que el agente lo entienda?El agente lee el cuerpo de la respuesta de tu webhook y lo interpreta para continuar la conversación. Funciona mejor cuando la respuesta es: JSON claro con campos descriptivos: {"status": "enviado", "tracking": "MX-482"} le da al agente datos concretos que citar. Compacta. Devuelve lo relevante para la conversación, no el objeto completo de tu base de datos: menos ruido = respuestas más precisas. Con errores legibles. Si algo falla, responde con un mensaje entendible ({"error": "pedido no encontrado"}): el agente podrá explicárselo al usuario en lugar de inventar. También puede devolver texto plano; JSON simplemente le da más estructura. Verifica el resultado real con Probar Power antes de asignarlo a un agente.¿Puedo probar un Power antes de usarlo?Sí. Cada power tiene la opción Probar Power: pulsas Ejecutar prueba y Arko hace la llamada real al webhook y te muestra la respuesta. Es la forma de confirmar, antes de asignarlo a un agente, que: La URL y el método son correctos. La autenticación funciona. Los parámetros llegan como esperas. La respuesta del servicio es la que el agente necesita leer. Si la respuesta no es la que buscabas, ajusta la configuración y vuelve a probar. Probar primero aísla los problemas: si la prueba pasa pero el agente falla, el problema está en la descripción o en la asignación, no en el webhook.¿Por qué mi agente no llama al Power?Revisa estas causas en orden; cubren casi todos los casos: El power no está asignado al agente. Crearlo no basta: entra a la configuración del agente y confirma que aparece en su lista de powers. El power está Inactivo. Un power desactivado no se ejecuta aunque esté asignado. La descripción no dice cuándo usarlo. El agente elige herramienta leyendo las descripciones. "API interna" no le dice nada; "Consulta el estado de un pedido a partir de su número" sí. Lo mismo aplica a los parámetros. El mensaje no lo amerita. El agente solo llama herramientas cuando la conversación lo pide. Pruébalo con un mensaje inequívoco: "¿En qué estado está el pedido ORD-1024?". El webhook falla. Si Probar Power devuelve error, el agente puede haber desistido tras intentarlo. Tip: en el chat se ve cuándo el agente ejecuta una herramienta. Si la acción aparece pero el resultado es pobre, el problema es la respuesta del webhook, no la decisión del agente.¿Cómo activo o desactivo un Power?Cada power tiene un estado: Activo o Inactivo. Un power inactivo no se ejecuta aunque esté asignado a un agente, lo que te permite pausar una integración sin borrarla ni tocar los agentes que la usan. Cambia el estado editando el power. Úsalo cuando estés migrando un endpoint, mientras depuras un webhook o si el servicio externo está caído: al reactivarlo, todos los agentes que lo tenían asignado vuelven a usarlo de inmediato.

¿No está tu pregunta? Busca en el centro de ayuda.