Connect tools & data

API-verbindingen

Maak van elke HTTP-API een functie die je spraakagent midden in een gesprek kan aanroepen: plak een cURL-opdracht en de wizard maakt de tooldefinitie, parameters en authenticatie.

API-verbindingen zijn aangepaste HTTP-functies die je agenten tijdens een gesprek kunnen aanroepen — een bestelling opzoeken, een ticket aanmaken, accountstatus ophalen uit je eigen backend. Je definieert het endpoint één keer onder Verbindingen → API's (/dashboard/api-connections); agenten waaraan de verbinding is gekoppeld, kunnen deze vervolgens aanroepen wanneer het gesprek daarom vraagt.

Er zijn twee manieren om er een te maken: plak iets dat de wizard kan analyseren, of stel de verbinding handmatig in.

De snelle route: plakken en analyseren#

1. Klik op Nieuwe API-verbinding

   Het dialoogvenster opent in de wizard. Plak een voorbeeld van een cURL-opdracht, OpenAPI/Swagger-specificatie, Postman-export, TypeScript- interface of Zod-schema in het vak.

2. Klik op Analyseren

   ThunderPhone leidt de volledige verbinding af uit wat je plakt — URL, methode, headers en een parameterschema op basis van de queryparameters en requestbody die het heeft gevonden. Headers die je hebt geplakt (inclusief authenticatieheaders) worden meegenomen in de endpointconfiguratie.

3. Bevestig de gemarkeerde velden

   De afgeleide configuratie opent met de geschatte velden gemarkeerd ter controle. Pas namen, beschrijvingen en parametertypen aan zodat de agent begrijpt wanneer en hoe de functie moet worden aangeroepen — de beschrijving is wat het model leest.

4. Valideren en opslaan

   Opslaan voert eerst een live testverzoek uit op je endpoint. Als het verzoek mislukt, wordt de verbinding niet opgeslagen — corrigeer de URL, authenticatieheaders of body en probeer het opnieuw. Bij succes wordt de verbinding opgeslagen met een badge Gevalideerd.

Als de wizard geen aanvraag-URL in je geplakte inhoud kan vinden, meldt deze dat — voeg een volledig http(s)-endpoint toe en probeer het opnieuw.

Handmatig instellen#

Klik op Handmatig instellen → in de wizard (of op Wil je dat AI dit afleidt? Probeer de wizard → om terug te gaan). De handmatige builder heeft twee editors:

• Visueel — formuliervelden voor de weergavenaam, functienaam, verzoek- URL, methode (POST, GET, PUT, PATCH, DELETE), aangepaste headers en het parameterschema (Eigenschap toevoegen voor elk argument dat de agent kan opgeven).
• JSON — dezelfde definitie als onbewerkte JSON, om een toolspecificatie rechtstreeks te plakken of nauwkeurig af te stemmen.

Met een paneel Testverzoek (optioneel) kun je het geconfigureerde verzoek vóór het opslaan uitvoeren; het toont de status, latentie en een voorbeeld van het antwoord. Valideren en opslaan voert deze test altijd uit en slaat alleen op bij succes.

Je verbindingen beheren#

Elke verbindingsrij toont de validatiestatus — Gevalideerd, Niet getest of Fout — de functienaam en welke agenten deze gebruiken. Via het actiemenu van de rij kun je:

• Bewerken — de configuratie opnieuw openen.
• Klonen — dupliceren als uitgangspunt (de kopie begint als Niet getest).
• Revisiegeschiedenis — eerdere versies bekijken en er één herstellen in de editor.
• Overdragen — de verbinding kopiëren of verplaatsen naar een andere organisatie waar je lid van bent. Verplaatsen verwijdert deze hier; agenten die deze gebruikten moeten mogelijk opnieuw worden geconfigureerd.
• Verwijderen — permanent; agenten die de verbinding gebruiken, moeten opnieuw worden geconfigureerd.

Koppel deze aan een agent#

Voeg de verbinding toe aan een agent in de sectie API-verbindingen van de builder (Een agent bouwen). De lijst toont welke agenten elke verbinding gebruiken, zodat je in één oogopslag ziet waarop een wijziging invloed heeft.

Volgende stappen#