For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/it/integrations/custom-api.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
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.

Cosa inserire
Sezione intitolata “Cosa inserire”API base URLREQUIRED
URL radice, es. https://api.example.com. Nessuna barra finale.
Auth header nameREQUIRED
es. Authorization o X-Api-Key.
Auth header valueREQUIRED
Il segreto inviato su ogni richiesta.
Label
Nome amichevole, es. My API.
Prima configurazione
Sezione intitolata “Prima configurazione”- Catalogue - cerchi Custom API - Connect.
- Compili base URL + auth header name/value + label - Connect (annulli se sta solo esplorando).
- Abiliti lo strumento Custom API sull’agent e mappi le operazioni che il suo contratto espone.
- Salvi e provi su una chiamata di test.
Risoluzione dei problemi
Sezione intitolata “Risoluzione dei problemi”Perché le chiamate alla mia API personalizzata falliscono subito dopo la connessione?
Rimuova la barra finale (/) dalla base URL. Verifichi anche che il nome dell’header di autenticazione corrisponda a ciò che la sua API si aspetta.
Prossimi passi
Sezione intitolata “Prossimi passi”Questa pagina è stata utile?
