---
title: Integraciones personalizadas
summary: Define tu propia integración para una API interna o cualquier proveedor que no esté en el catálogo integrado, con las mismas garantías de seguridad que las 90 que vienen por defecto.
date: 2026-09-09
---

# Integraciones personalizadas

Define tu propia integración para una API interna o cualquier proveedor que no esté en el catálogo integrado, con las mismas garantías de seguridad que las 90 que vienen por defecto.

## Cuándo usar esto

El catálogo integrado cubre 90 servicios (ver la [Guía de integraciones](/es/docs/guides/integrations-guide)). Para cualquier otra cosa, una API interna, un proveedor de nicho, un proveedor que nadie ha construido todavía, define una integración personalizada en lugar de esperar a que se lance una. Activa la función para tu organización desde **Configuración → Integraciones personalizadas**; está desactivada por defecto.

## Importar desde un comando curl

El camino más rápido: pega un comando curl funcional directamente desde la propia documentación del proveedor. El asistente detecta la forma de autenticación, las cabeceras y la URL base por ti, así que lo revisas en lugar de volver a escribirlo.

## Construirla a mano

- **Básicos**: un ID, un nombre visible, una categoría, una descripción, y las capacidades que declara, para que un agente pueda razonar sobre cuándo recurrir a ella.
- **Autenticación**: una clave de API (como token Bearer, cabecera personalizada, parámetro de consulta, o HTTP Basic) u OAuth 2.0, incluido PKCE para proveedores que lo exigen (estilo Twitter/X) y parámetros de autorización adicionales para proveedores que condicionan los tokens de actualización (el `access_type=offline` de Google, el `duration=permanent` de Reddit).
- **Campos**: las credenciales que aporta el miembro que se conecta. Cada campo se cifra en reposo por defecto; marcar uno como no secreto (un ID de cuenta o una región en texto plano, por ejemplo) solo se permite para campos que claramente no son una credencial. Un campo con un nombre como token, secret, key, password o credential queda bloqueado para esa clasificación salvo anulación explícita.
- **Hosts de API**: los nombres de host a los que esta integración puede llegar, con comodines admitidos, el mismo modelo de salida que cada integración integrada.
- **Verificación**: un endpoint que se consulta en el momento de conectar, para confirmar que las credenciales de un miembro realmente funcionan antes de que la integración se considere conectada.

## Borradores y publicación

Una nueva integración se guarda como borrador, invisible para cualquier agente, hasta que la publicas. Publicar es lo que hace que aparezca bajo **Configuración → Integraciones** para que los miembros conecten sus propias credenciales, y lo que da acceso a los agentes vinculados. Despublicarla la oculta de nuevo sin eliminar nada: las credenciales cifradas ya conectadas se conservan, así que volver a publicarla restaura el acceso en lugar de empezar de cero.

## Las mismas garantías de seguridad

Una integración personalizada hereda todo lo que obtiene una integrada: credenciales cifradas por fila, el intermediario de credenciales, la lista de permitidos de salida, la vinculación por agente, y el mismo registro de auditoría. Definir tu propia integración no significa salir del modelo de seguridad de la plataforma, significa extenderlo a un servicio más.

## Relacionado

- [Guía de integraciones](/es/docs/guides/integrations-guide): las 90 integraciones integradas que esto extiende
- [Seguridad](/es/docs/guides/security): los límites dentro de los cuales opera cada integración, integrada o personalizada