# Custom API

**Integrations - Catalogue - Custom API - Connect** vincula cualquier API REST con una URL base y un header de autenticación para que el agent lo llame durante la conversación.

  <ShotPlaceholder
    src="/assets/integrations/custom-api.png"
    name="custom-api-connect"
    alt="Connect Custom API con URL base y header de autenticación"
    capture="Diálogo Connect Custom API."
  />

## Qué ingresar

- **API base URL** (required) — URL raíz, p. ej. https://api.example.com. Sin barra diagonal al final.
- **Auth header name** (required) — p. ej. Authorization o X-Api-Key.
- **Auth header value** (required) — El secreto enviado en cada solicitud.
- **Label** — Nombre descriptivo, p. ej. My API.

## Primera configuración

1. **Catalogue - busque Custom API - Connect**.
2. Complete URL base + nombre/valor del header de autenticación + label - **Connect** (cancele si solo está explorando).
3. Habilite la herramienta Custom API en el agent y mapee las operaciones que expone su contrato.
4. Guarde y pruebe en una llamada de prueba.

## Solución de problemas

**Las llamadas fallan inmediatamente después de conectar**

Elimine una barra diagonal al final de la URL base. Confirme que el nombre del header de autenticación coincide con lo que espera su API.

## Próximos pasos

[Configurar una integración](https://docs.voicelogica.ai/es/integrations/) - conexión de empresa luego herramienta del agent.  
[AI Assistants](https://docs.voicelogica.ai/es/integrations/mcp-settings/) - cuando el otro sistema debería llamar a Voice Logica en su lugar.