# Custom API

**Integrations - Catalogue - Custom API - Connect** collega qualsiasi API REST con una base URL e un header auth per l'agent da chiamare durante la conversazione.

  <ShotPlaceholder
    src="/assets/integrations/custom-api.png"
    name="custom-api-connect"
    alt="Connect Custom API base URL e header auth"
    capture="Dialogo Connect Custom API."
  />

## Cosa inserire

- **API base URL** (required) — URL radice, es. https://api.example.com. Nessuna barra finale.
- **Auth header name** (required) — es. Authorization o X-Api-Key.
- **Auth header value** (required) — Il segreto inviato su ogni richiesta.
- **Label** — Nome amichevole, es. My API.

## Prima configurazione

1. **Catalogue - cerchi Custom API - Connect**.
2. Compili base URL + auth header name/value + label - **Connect** (annulli se sta solo esplorando).
3. Abiliti lo strumento Custom API sull'agent e mappi le operazioni che il suo contratto espone.
4. Salvi e provi su una chiamata di test.

## Risoluzione dei problemi

**Le chiamate falliscono immediatamente dopo la connessione**

Rimuova una barra finale dalla base URL. Confermi che il nome dell'header auth corrisponda a ciò che la sua API si aspetta.

## Prossimi passi

[Get an integration working](https://docs.voicelogica.ai/it/integrations/) - connessione aziendale poi strumento agent.  
[AI Assistants](https://docs.voicelogica.ai/it/integrations/mcp-settings/) - quando l'altro sistema dovrebbe chiamare Voice Logica invece.