# Custom API

**Integrations - Catalogue - Custom API - Connect** verbindet jede REST-API mit einer Basis-URL und einem Auth-Header, damit der Agent während des Gesprächs aufrufen kann.

  <ShotPlaceholder
    src="/assets/integrations/custom-api.png"
    name="custom-api-connect"
    alt="Connect Custom API Basis-URL und Auth-Header"
    capture="Connect Custom API Dialog."
  />

## Was Sie eingeben

- **API base URL** (required) — Stamm-URL, z.B. https://api.example.com. Kein abschließender Schrägstrich.
- **Auth header name** (required) — z.B. Authorization oder X-Api-Key.
- **Auth header value** (required) — Das Geheimnis, das bei jeder Anfrage gesendet wird.
- **Label** — Freundlicher Name, z.B. My API.

## Erste Einrichtung

1. **Catalogue - Custom API suchen - Connect**.
2. Füllen Sie Basis-URL + Auth-Header-Name/Wert + Label aus - **Connect** (abbrechen, wenn Sie nur erkunden).
3. Aktivieren Sie das Custom API-Tool auf dem Agent und mappen Sie die Operationen, die Ihr Vertrag bereitstellt.
4. Speichern und mit einem Testanruf nachweisen.

## Fehlerbehebung

**Aufrufe schlagen unmittelbar nach Connect fehl**

Entfernen Sie einen abschließenden Schrägstrich von der Basis-URL. Bestätigen Sie, dass der Auth-Header-Name mit dem übereinstimmt, was Ihre API erwartet.

## Nächste Schritte

[Get an integration working](https://docs.voicelogica.ai/de/integrations/) - Unternehmensverbindung dann Agent-Tool.  
[AI Assistants](https://docs.voicelogica.ai/de/integrations/mcp-settings/) - wenn das andere System Voice Logica stattdessen aufrufen soll.