Aanvragen
Beslissingen & goedkeuringen
Veel aanvragen bestaan voor precies één ding: een ja, een nee, of een 'zo niet'. De beslissingsvraag legt dat oordeel vast in een vorm waarop je automatisering direct kan vertakken, zonder te hoeven raden welk veld het antwoord bevatte.
Waarom een speciale vraag
Elke keuze heeft al een optiesleutel, dus een workflow kan op elke radiovraag vertakken.
Wat een workflow niet kan, is weten — over elk formulier met een goedkeuring heen — welke sleutel “ja” betekent: de radiovraag van de ene
auteur zegt sign_off, die van een ander approved.
De beslissingsvraag legt de namen vast. Het is een keuzevraag met de veldsleutel decision, waarvan de drie
opties de optiesleutels approve, decline en changes dragen. De labels blijf jij herschrijven en
vertalen; de sleutels eronder verschuiven nooit. Zodra de ontvanger er één kiest, eindigt de aanvraag met een uitkomst.
Elke radiovraag met de sleutel decision waarvan de opties die drie sleutels dragen, telt mee — het preset zet ze alleen voor
je klaar.
Voeg er één toe aan je formulier
- 1
Open het blokmenu
Druk op / in de editor en kies Beslissing — "Goedkeuren, afwijzen of wijzigingen vragen".
- 2
Herschrijf de labels
Je krijgt een vraag met de titel "Ga je akkoord?" en de keuzes Goedkeuren, Afwijzen en Wijzigingen aanvragen. Herschrijf ze naar jouw eigen bewoordingen — "Accorderen", "Afkeuren", "Terug voor aanpassing". Vertaal ze zoals elke andere inhoud.
- 3
Vraag naar een reden, als je die nodig hebt
Een oordeel alleen verklaart zichzelf zelden. Voeg er een lange-tekstvraag na toe, en toon die alleen bij afwijzen en wijzigen met voorwaardelijke logica.
- 4
Publiceren
Aanvragen die vanaf deze gepubliceerde versie worden aangemaakt, eindigen met een uitkomst. Zoals elke veldsleutel bestaat decision pas zodra het formulier is gepubliceerd.
Alleen het preset levert een uitkomst op
De uitkomst wordt gelezen uit de vraag met veldsleutel decision, en alleen wanneer de sleutel van de gekozen optie één van
de drie is. Een radiovraag die je zelf bouwt met de opties gelabeld Goedkeuren, Afwijzen en Wijzigingen leidt precies die sleutels af,
dus die werkt zonder het preset; een radiovraag met andere labels werkt zodra je de drie sleutels typt in de
Sleuteltabel.
Verwijder je één van de drie opties, of herschrijf je haar sleutel, dan waarschuwt publiceren: “De beslissingsvraag mist een optie voor goedkeuren, afwijzen of wijzigingen aanvragen, dus aanvragen kunnen zonder resultaat worden voltooid.” Alle drie moeten aanwezig zijn — een beslissing die alleen kan goedkeuren, kan niet afwijzen.
Een beslissingsvraag binnen een herhaalgroep is een gewone vraag en telt niet mee voor de uitkomst.
De drie waarden
| Waarde | Standaardlabel | Betekent |
|---|---|---|
| approve | Goedkeuren | De ontvanger ging akkoord. Je run gaat verder op het gewenste pad. |
| decline | Afwijzen | Ze zeiden nee. De aanvraag wordt nog steeds voltooid — afwijzen is een oordeel, geen mislukking. |
| changes | Wijzigingen aanvragen | Ze willen iets aangepast zien voordat ze akkoord gaan. Meestal het sein om een nieuwe aanvraag te sturen. |
Deze drie waarden zijn een publiek contract, net als een veldsleutel: een automatisering, een agent en een spreadsheetformule lezen ze allemaal. Voeg je een vierde optie toe, dan is die kiezen een gewoon antwoord, geen oordeel — die aanvraag wordt voltooid zonder uitkomst, in plaats van met een waarde die je ontvanger nog nooit heeft gezien.
Waar de uitkomst verschijnt
| Plek | Wat je krijgt |
|---|---|
| Callback | outcome in het aanvraagblok van de request.completed-payload — afwezig als er geen oordeel is. |
| requests.get | outcome naast status, plus de antwoorden gesorteerd op veldsleutel. |
| requests.list | Een outcome-filter; het meegeven ervan impliceert alleen voltooide aanvragen. |
| Pagina Aanvragen | Een Uitkomst-filter, en Goedgekeurd / Afgewezen / Wijzigingen gevraagd op de aanvraag zelf. |
| Inzendingen | Het oordeel is ook een gewoon antwoord, onder de veldsleutel decision. |
{
"id": "evt_...",
"type": "request.completed",
"test": false,
"data": {
"request": {
"id": "kd7...",
"externalId": "run-42",
"status": "completed",
"outcome": "changes",
"context": { "case_id": "CASE-9" }
},
"answers": {
"decision": "changes",
"reason": "Please split the line items per site."
}
}
}Vertak op data.request.outcome. status zegt of de aanvraag is afgerond; outcome zegt wat de
ontvanger besliste. Een verlopen of geannuleerde aanvraag heeft een status en geen uitkomst, en dat geldt ook voor een voltooide aanvraag
op een formulier zonder beslissingsvraag.
Vanuit een agent
De MCP-tool is editor_insertDecisionQuestion, die een titel en de drie labels in de taal van het formulier aanneemt. Een
agent die geen callback-endpoint kan hosten, poll’t in plaats daarvan request_get en leest outcome zodra de
status pending verlaat. Aanvragen op de MCP-server →