--- title: "API-verbindingen" description: "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 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. 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. 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. 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. Headerwaarden zijn alleen schrijfbaar. Zodra ze zijn opgeslagen, worden ze versleuteld en nooit meer weergegeven, niet in het dashboard en ook niet via de API. Wanneer je een verbinding bewerkt, toont een opgeslagen header de naam met puntjes in plaats van de waarde en een melding **Opgeslagen**: laat deze ongewijzigd om de opgeslagen waarde te behouden, of voer een nieuwe waarde in om deze te vervangen. Testverzoeken en live oproepen gebruiken de opgeslagen waarde. **Klonen** kopieert opgeslagen waarden naar de nieuwe verbinding. 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 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](/nl/guides/build-an-agent)). De lijst toont welke agenten elke verbinding gebruiken, zodat je in één oogopslag ziet waarop een wijziging invloed heeft. ## Volgende stappen Maak en beheer dezelfde verbindingen programmatisch. Kant-en-klare verbindingen met Google, Slack, HubSpot, Salesforce en Cal.com. Stel een volledige toolserver beschikbaar aan je agents. Elk veld van de integratieresource.