Eigen Procedures met JavaScript en API-calls

Versie 1.0 · Laatst bijgewerkt 2026-08-10

De standaardsoorten Procedures (opvolgvraag, 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. Van beide wordt een record vastgelegd in de audittrail bij Verantwoording.

Frequently asked questions