Aangepaste API
Roep externe API's aan vanuit je agent om gegevens op te halen of integraties te activeren.
Met acties van het type Aangepaste API kan je agent communiceren met externe diensten. Haal realtime gegevens op, verstuur formulieren of activeer workflows in andere tools.
Een aangepaste-API-actie aanmaken
- Ga naar het tabblad Acties van je agent
- Klik op Actie toevoegen → Aangepaste API
- Configureer de API-aanroep:
- Endpoint-URL - Het API-endpoint dat wordt aangeroepen
- HTTP-methode - GET, POST, PUT, PATCH of DELETE
- Headers - Authenticatie en content-type
- Request Body - De gegevens die worden verzonden (voor POST/PUT/PATCH)
- Sla op en test
Configuratieopties
Endpoint-URL
De volledige URL van het API-endpoint:
https://api.yourservice.com/v1/data
Gebruik alleen HTTPS-endpoints. HTTP-endpoints worden om veiligheidsredenen geblokkeerd.
HTTP-methode
| Methode | Toepassing |
|---|---|
| GET | Gegevens ophalen bij een externe dienst |
| POST | Gegevens verzenden, records aanmaken |
| PUT | Bestaande records vervangen |
| PATCH | Bestaande records gedeeltelijk bijwerken |
| DELETE | Records verwijderen |
Headers
Voeg authenticatie- en content-headers toe:
Authorization: Bearer {{SECRET:service_api_key}}
Content-Type: application/json
Maak het benoemde geheim afzonderlijk aan. Agentkit verwerkt {{SECRET:name}} alleen op de server. Actiegegevens en logboeken bevatten nooit de opgeslagen waarde.
Bron van invoergegevens
Kies voor een tekstveld met één e-mailadres de geverifieerde e-mailbron met een vraag als deze ontbreekt. Agentkit gebruikt het geverifieerde webcontact of de afzender van de inkomende e-mail. Anonieme bezoekers krijgen een vraag om hun adres. Het model kan een geverifieerd adres niet vervangen.
Request Body
Definieer voor POST/PUT-verzoeken de JSON-body met de gegevens die je wilt verzenden.
Wanneer de API wordt aangeroepen
De AI bepaalt wanneer de API wordt aangeroepen, op basis van de gesprekscontext en de beschrijving van de actie. Je kunt dit gedrag sturen door duidelijk te beschrijven wanneer de actie moet worden geactiveerd.
Reacties afhandelen
Succesvolle reactie
Wanneer de API succesvol reageert (2xx-status):
- Toon een succesbericht aan de bezoeker
- Neem de responsgegevens op in de chat
- Activeer vervolgacties
Foutafhandeling
Wanneer de API mislukt:
- Toon een vriendelijk foutbericht
- Leg de fout vast in de logs voor debugging
- Probeer het verzoek eventueel opnieuw
Voorbeeldscenario's
Bestelstatus controleren
Configureer een GET-endpoint om bestelgegevens op te halen wanneer bezoekers vragen naar hun bestelstatus.
Versturen naar je CRM
Configureer een POST-endpoint om leadgegevens naar je CRM-systeem te sturen.
Realtime gegevens ophalen
Configureer een GET-endpoint om realtime gegevens (zoals beschikbaarheid of voorraad) uit je systemen op te halen.
Beveiligingsoverwegingen
API-sleutels
- Bewaar API-sleutels als benoemde geheimen en verwijs ernaar met
{{SECRET:name}}. - Gebruik omgevingsspecifieke sleutels om te testen
- Vervang sleutels regelmatig
Rate limiting
- Externe API's kunnen requestlimieten hebben
- Stel de rate limiting van je agent hierop af
- Monitor het API-gebruik in de logs
Gegevensprivacy
- Verstuur alleen noodzakelijke gegevens
- Zorg dat externe diensten voldoen aan de AVG als dat nodig is
- Leg geen gevoelige responsgegevens vast in de logs
Time-out en retries
| Instelling | Standaard | Opmerkingen |
|---|---|---|
| Time-out | 20 seconden | Verzoek mislukt als er geen reactie komt |
| Retries | 0 | Stel webhook-retries in voor betrouwbaarheid |
Je API-actie testen
- Stel de actie in met een testendpoint
- Ga naar de Playground
- Activeer de actie met geschikte input
- Controleer de reactie in de chat
- Bekijk de logs om te debuggen
Volgende stappen
- Stel webhooks in voor betrouwbare aflevering
- Koppel Zapier voor integraties zonder code
- Bekijk de API-documentatie voor inkomende API-aanroepen