> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API-koppelingen

> Maak van elke HTTP-API een functie die je spraakagent tijdens een gesprek kan aanroepen — plak een cURL-opdracht en laat de wizard de rest doen.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

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.

<Tip>
  Geef parameters beschrijvingen in gewone taal ("E-mailadres van klant,
  bijv. [jane@example.com](mailto:jane@example.com)"). De agent kiest tijdens het gesprek in realtime
  argumenten op basis van deze beschrijvingen.
</Tip>

## 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](/nl/guides/build-an-agent)). De lijst toont welke agenten
elke verbinding gebruiken, zodat je in één oogopslag ziet wat een wijziging beïnvloedt.

## Volgende stappen

<CardGroup cols={2}>
  <Card title="Toolintegraties via API" icon="code" href="/nl/guides/build-tool-integration">
    Maak en beheer dezelfde verbindingen programmatisch.
  </Card>

  <Card title="Apps verbinden" icon="cable" href="/nl/guides/connect-apps">
    Vooraf gebouwde verbindingen voor Google, Slack, HubSpot, Salesforce en Cal.com.
  </Card>

  <Card title="Een MCP-server toevoegen" icon="server" href="/nl/guides/mcp-servers">
    Stel een volledige toolserver beschikbaar aan je agents.
  </Card>

  <Card title="API-referentie voor integraties" icon="book" href="/api-reference/integrations">
    Elk veld van de integratieresource.
  </Card>
</CardGroup>
