Zelf een automatisatie starten

Sommige automatisaties starten als iemand erom vraagt: Deze offerte versturen, De verzendprijs uitrekenen, De maand afsluiten. Hun kolom Start op Automatisaties zegt Als ze gestart wordt. Elk heeft een naam waarmee ze gestart wordt, zegt wat ze moet krijgen, en kan een antwoord teruggeven.

Zo’n automatisatie werkt namens de persoon of het systeem dat haar start, met diens toegang: ze kan alleen wat die zelf mag.

Waar ze gestart kan worden

Als de assistent haar maakt, zeg je waarvandaan ze gestart mag worden, en door wie:

• het dashboard, als knop;
• je apps;
• de assistent;
• andere systemen, met een API-sleutel.

Alleen mensen met een van de datarollen die je kiest, mogen haar starten. Niemand kan dat tot je er minstens één kiest.

Met een knop in het dashboard

Een automatisatie die bij een entiteit hoort, staat als knop onder Automatisaties op de lijst met records van die entiteit en op elk van haar records. Kies ze, vul in wat ze vraagt (een knop op een record vult dat record voor je in), en kies Uitvoeren. Het venster zegt eerst dat ze namens jou werkt, in de stage waarnaar je kijkt.

Geeft ze een antwoord, dan toont het venster dat: … antwoordde. Een automatisatie die langer duurt, gaat vanzelf verder; haar uitvoering staat onder Uitvoeringen.

Vanaf de pagina van de automatisatie

De eigen pagina van de automatisatie onder Automatisaties heeft een deel Met de hand starten, in Preview en in Live. Mag je haar starten, kies dan Uitvoeren: hetzelfde venster vraagt wat ze nodig heeft en toont haar antwoord. Mag je dat niet, dan zegt het waarom, op de plaats van de knop: het dashboard staat niet bij de plaatsen waar ze gestart mag worden, er is nog geen datarol gekozen, ze staat uit op Live, of je hebt geen van de datarollen die haar mogen starten. Hoort ze bij een entiteit, dan zegt het ook dat ze op de lijst van die entiteit en op elk van haar records staat.

Terwijl je haar met de hand maakt of wijzigt, waarschuwt het paneel van haar trigger Niemand kan dit starten tot je kiest wie het mag. zolang er geen datarol gekozen is bij Wie ze mag starten. Bewaren kan nog altijd.

Vanuit een app

Als je een app bouwt met de assistent, vraag hem dan de automatisatie te gebruiken, bijvoorbeeld Voeg een knop toe die De verzendprijs uitrekenen uitvoert en het antwoord toont. De app start ze met kvyk.run, met haar naam en wat ze nodig heeft:

const { runId, status, output } = await kvyk.run("delivery_price", { postcode: "1012AB" });

Ze werkt namens de persoon die in de app is aangemeld, in de stage waarin de app draait: de versie van Preview in de preview van de app, die van Live in de gepubliceerde app.

Vanuit een ander systeem

Een ander systeem, zoals je webshop, start een automatisatie in Live of Preview met een API-sleutel van die stage, door haar adres aan te roepen met wat ze nodig heeft als JSON. Het adres valt onder het adres bovenaan de API-referentie van je organisatie:

POST /v1/functions/delivery_price
Authorization: Bearer <je API-sleutel>
Content-Type: application/json

{ "postcode": "1012AB" }

Het antwoord bevat het nummer van de uitvoering, haar status en het antwoord van de automatisatie. De API-referentie van je organisatie somt onder Automations elke automatisatie op die zo gestart kan worden, met wat ze nodig heeft en wat ze antwoordt.

Wat ze antwoordt

Een automatisatie die antwoordt, doet dat binnen 10 seconden. Heeft ze dan nog niet geantwoord, dan zegt het antwoord haar status, zoals Loopt, en gaat haar uitvoering verder.

Elke persoon of elk systeem kan automatisaties 60 keer per minuut starten, en de organisatie als geheel 600 keer per minuut. Daarboven wordt een start geweigerd: wacht even en probeer het opnieuw.