Skip to main content
API-verbindingen zijn aangepaste HTTP-functies die je agenten tijdens een gesprek kunnen aanroepen — een bestelling opzoeken, een ticket maken, de accountstatus ophalen uit je eigen backend. Je definieert het eindpunt één keer onder Verbindingen → API’s (/dashboard/api-connections); agenten waaraan de verbinding is gekoppeld, kunnen deze vervolgens aanroepen wanneer het gesprek daar om vraagt. Er zijn twee manieren om er een te bouwen: iets plakken dat de wizard kan analyseren, of de verbinding handmatig instellen.

​
De snelle route: plakken en analyseren

1

Klik op Nieuwe API-verbinding

Het dialoogvenster wordt geopend 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 dat is afgeleid van de queryparameters en aanvraagbody die het heeft gevonden. Headers die je hebt geplakt (inclusief authenticatieheaders) worden opgenomen in de eindpuntconfiguratie.
3

Bevestig de gemarkeerde velden

De afgeleide configuratie wordt geopend met de geschatte velden gemarkeerd voor 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 tegen je eindpunt. 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)-eindpunt toe en probeer het opnieuw.

​
Handmatige instelling

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, aanvraag- 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 rechtstreeks een toolspecificatie te plakken of te verfijnen.
Met een paneel Testverzoek (optioneel) kun je het geconfigureerde verzoek voor het opslaan uitvoeren en worden de status, latentie en een voorbeeld van het antwoord getoond. Valideren en opslaan voert deze test altijd uit en slaat alleen op bij succes.
Geef parameters beschrijvingen in gewone taal (“E-mailadres van klant, bijv. jane@example.com”). De agent kiest tijdens het gesprek in realtime argumenten op basis van deze beschrijvingen.

​
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 waartoe je behoort. 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 wat een wijziging beïnvloedt.

​
Volgende stappen

Toolintegraties via API

Maak en beheer dezelfde verbindingen programmatisch.

Apps verbinden

Vooraf gebouwde verbindingen voor Google, Slack, HubSpot, Salesforce en Cal.com.

Een MCP-server toevoegen

Stel een volledige toolserver beschikbaar aan je agents.

API-referentie voor integraties

Elk veld van de integratieresource.