Herramientas de API personalizada

Las herramientas de API personalizada son la propuesta de AnyBot para conectar cualquier cosa. Cuando un sistema no tiene una integración nativa en esta página, apunta un agente a su API REST: dale una URL base, elige los endpoints, y cada uno se convierte en una herramienta que el agente puede llamar a mitad de conversación para obtener datos o activar una acción, sin código personalizado.

Cuándo recurrir a ellas

• Ninguna integración nativa cubre el sistema, un servicio interno, un SaaS de nicho o tu propio backend.
• Ya expones una API REST (o una especificación OpenAPI/Swagger) y quieres que el agente la use.
• Quieres que el agente lea datos en vivo o active una acción que reside detrás de tu propio endpoint.

Si ya existe una integración de primera clase, CRM, Commerce, Notion, Búsqueda web, recurre primero a esa. La mantenemos por ti y ya tiene en cuenta la privacidad, así que te saltas la configuración del esquema y de la autenticación.

Cómo se conecta (la versión corta)

1. Abre Integraciones, elige Custom API y dale una URL base.
2. Importa una especificación OpenAPI/Swagger (por URL o pegándola) para descubrir automáticamente los endpoints, o configura las herramientas a mano.
3. Configura la autenticación, Bearer, Basic, API Key o ninguna.
4. Elige qué endpoints exponer, prueba cada uno en el panel integrado y luego Conecta.

El verdadero punto delicado: el agente solo puede alcanzar lo que expones. Importar una especificación enumera cada endpoint que encuentra, pero solo los que seleccionas se convierten en herramientas, y reanalizar la especificación más tarde recoge los cambios de la API sin reconstruir desde cero.

Público vs privado, por herramienta

Las integraciones nativas vienen con una división fija public-safe/owner-only. Las herramientas personalizadas le dan la vuelta: tú eliges la visibilidad por herramienta, Public (public-safe, un visitante del sitio web puede activarla), Private (owner-only, solo canales internos) o Both. Haz Public las búsquedas seguras de solo lectura; mantén Private cualquier cosa que escriba o toque datos sensibles.

Como las herramientas se definen por instancia, no hay una lista ni un recuento fijos, la superficie es exactamente lo que construyes.

Ejemplo práctico

Tus pedidos residen en un servicio interno sin integración nativa. Apuntas una herramienta de Custom API a https://api.internal.example.com, importas su especificación OpenAPI y expones un único endpoint de solo lectura, get_order_status, como herramienta Public. Un visitante pregunta «¿dónde está el pedido 4821?» y el agente la llama y responde con el estado en vivo. Mantienes el endpoint de reembolso como Private, así que solo los canales orientados al personal pueden alcanzarlo.

Límites

• Solo salientes. El agente llama a tu API; tu API no llama al agente.
• El agente usa las credenciales que configuras; nunca puede exceder lo que esa clave de API está autorizada a hacer.
• Eliminar la integración simplemente desvincula las herramientas, no se realiza ningún cambio en tu API externa.

Resolución de problemas

• La especificación no se analiza. Confirma que sea un OpenAPI/Swagger válido y accesible; pega el contenido en bruto si la URL está protegida.
• Falló la autenticación. Vuelve a revisar el token, su prefijo y si la clave va en un encabezado o en un parámetro de consulta.
• El agente no llama a la herramienta. Asegúrate de que el endpoint esté seleccionado/expuesto y de que su visibilidad coincida con el canal, una herramienta Private no se activa en un agente público.

Preguntas frecuentes

¿Necesito escribir código? No. Conecta una API REST por especificación o a mano, no se requiere código.

¿Puede llamar a cualquier API? Cualquier endpoint HTTP REST accesible al que puedas autenticarte.

¿Cuántas herramientas puedo definir? No hay un recuento fijo, construye tantas como necesites.

Siguientes pasos

• Visión general de las integraciones