Gevorderd

Eigen Procedures met JavaScript en API-calls

Versie 1.0 · Laatst bijgewerkt 2026-08-17

Procedures die verder gaan dan de standaardsoorten. Voer willekeurige JavaScript-code uit of roep je backend-API aan, om dingen te doen die alleen jouw bedrijf kan.

De standaardsoorten Procedures (vervolgvraag, doorverwijzing, component, van Topic wisselen, live chat) dekken de meeste gevallen. Waar dat niet zo is, laten eigen JavaScript en API-calls de agent elke actie uitvoeren die je stack toestaat, zonder het gesprek te verlaten.

Kernbegrippen

Procedures met eigen JavaScript

Voer willekeurige JavaScript-code uit zodra de klant op de Procedure klikt. Pas de DOM aan, roep je eigen JS-API op de pagina aan, doe alles wat de browser toestaat. Handig om nauw aan te sluiten op het product eromheen.

Procedures met een API-call

Roep een endpoint in je backend aan. Stuur ingestelde headers en invoervelden mee. Je krijgt een JSON-antwoord terug dat de agent direct kan gebruiken, of dat je met een klein stukje JavaScript bewerkt.

Koppelingen met een MCP server

Voor bredere integraties dan één endpoint koppel je je eigen MCP server (Model Context Protocol). De agent leest en handelt via MCP net zoals via elke andere connector. Zie Living Context voor de manier waarop je dat opzet.

Variabelen

Beide soorten halen eerst variabelen bij de klant op als de agent die nog niet heeft. Variabelen kunnen afhangen van eerdere antwoorden.

Omgaan met het antwoord

Bij API-calls komt het JSON-antwoord terug in het gesprek. Gebruikelijke patronen: berichten voor succes en fouten, tekst richting de klant, en opvolgende Procedures.

Authenticatie

Procedures met een API-call ondersteunen eigen headers, bearer-tokens en geheimen per tenant. Geheimen beheer je in je account.

Wat je hier kunt doen

Een Procedure bouwen die bij een klik eigen JavaScript uitvoert
Een Procedure bouwen die je backend aanroept en het antwoord gebruikt
Variabelen bij de klant ophalen voordat de Procedure draait
API-antwoorden bewerken met JavaScript
Eigen berichten instellen voor succes en fouten
Toegangsgegevens beheren

Wanneer je het gebruikt

De standaardsoorten Procedures dekken je behoefte niet
Je moet je eigen backend aanroepen (account opzoeken, status controleren, facturatie bevragen)
Je hebt een diepe integratie nodig met je product op de pagina
Je moet binnen de sessie van de klant iets doen waarvoor eigen logica nodig is

Wanneer je het niet gebruikt

De standaardsoorten Procedures zouden gewoon werken. Begin daar.
Je hebt geplande achtergrondtaken nodig. Procedures draaien op interactie met de klant, niet volgens een schema.
De logica hoort in je backend, niet in de agent. Laat de agent je backend dan aanroepen via een Procedure met een API-call; de logica blijft waar die hoort.

Hoe het werkt

Eigen JavaScript draait in de browser van de klant zodra die op de Procedure klikt. API-calls draaien aan de serverkant tegen jouw endpoint, met de ingestelde headers. Beide worden vastgelegd in de audittrail bij Verantwoording.

Veelgestelde vragen

Hoe bouw ik een Procedure met een API-call?

Ga naar "Train > Procedures > Create procedure", kies "API call" en stel het endpoint, de headers en de invoervelden in. Voeg een bericht toe voor succes en voor een fout. Sla op.

Hoe authenticeer ik de API-call?

Voeg een header toe. Bewaar bearer-tokens als geheim in je accountinstellingen en verwijs er vanuit de header naar. Plak geheimen niet rechtstreeks in de Procedure.

Hoe gebruik ik het antwoord van de API in het gesprek?

Koppel de velden uit het antwoord aan placeholders in het succesbericht. De agent toont het bericht met de actuele waarden.

Hoe bewerk ik een API-antwoord voordat ik het toon?

Voeg een JavaScript-transformatie toe aan de Procedure. Die krijgt de ruwe JSON binnen en geeft de waarde of waarden terug die in het succesbericht komen.

Kan eigen JavaScript alles?

Alles wat de browser van de klant toestaat. De gebruikelijke beveiligingsregels van de browser gelden (CORS, same-origin policy). Voor acties aan de serverkant gebruik je een Procedure met een API-call.

Hoe zie ik wat een API-call heeft gedaan?

Ga naar "Analyze > Conversations", zoek het gesprek op en bekijk de uitgevoerde Procedure. Je ziet het verzoek, het antwoord en de reactie van de klant.