Agent Studio: Triggers instellen voor realtime starts

Agent Studio Triggers zorgen voor realtime, event-driven automatisering voor je Voluit Suite AI-agents. Wanneer iemand een formulier instuurt, een tag krijgt, of een chatbericht stuurt, registreert Voluit Suite die actie en start je agent op de achtergrond. Zo blijven pagina’s en API’s snel, terwijl je agent direct kan reageren. De opzet is gemaakt voor hoge volumes en veilig testen, zodat je triggers stap voor stap kunt uitrollen zonder live verkeer te verstoren.

In deze handleiding lees je wat triggers zijn, waarom ze handig zijn, en hoe je ze instelt met praktische best-practice tips.

Wat zijn Agent Studio Triggers?

Agent Studio Triggers zijn event listeners die je koppelt aan de Start-node van een agent. Zodra een ondersteund event in Voluit Suite gebeurt, start de agent automatisch. Zo kan je agent direct reageren op acties van echte gebruikers, zoals het insturen van een formulier of het sturen van een chatbericht, zonder extra API-calls of handmatige stappen.

Op dit moment zijn er drie start-events beschikbaar: Formulier ingestuurd, Lead tag (toegevoegd of verwijderd) en Chatbericht. Als een van deze events afgaat, start de agent vanaf de Start trigger en loopt daarna door de flow die je hebt opgebouwd.

Belangrijkste voordelen van Agent Studio Triggers

Als je de voordelen helder hebt, kan je beter bepalen waar triggers passen in je automatiseringen en welke handmatige of vertraagde processen je ermee kunt vervangen.

Realtime opvolging: Reageer op leads op het moment dat ze iets doen, zoals een formulier insturen, je een bericht sturen, of getagd worden.
Schaalbaar zonder extra scripts: Geen polling-scripts of custom webhooks nodig. Je stelt een trigger in de app in en publiceert.
Vast startpunt: Je standaardiseert hoe agents starten. Dat maakt testen en troubleshooting overzichtelijker.
Geen breuk met bestaande flows: Triggers zijn optioneel en voegen iets toe. Bestaande agents die via de API worden gestart blijven werken.
Basis voor uitbreiding: Een event-driven opzet maakt het makkelijker om later extra event types toe te voegen.

Agent Studio Triggers instellen

Volg deze stappen om een trigger goed en testbaar in te stellen, en daarna live te zetten.

Vereisten & Toegang:

Controleer je toegang en werkomgeving zodat je trigger-instelling soepel loopt en past bij jouw manier van uitrollen.

Ga naar AI Agents → Agent Studio (NL: AI Agents → Agent Studio).

Bekijk Hoe gebruik je AI Agent Studio in Voluit Suite voor uitleg over de canvas-navigatie, testen en het publicatieproces.

Agent Studio openen

Klik in de linkerzijbalk op AI Agents (NL: AI Agents) en kies daarna bovenin het tabblad Agent Studio (NL: Agent Studio). Dit is de plek waar je AI-agents voor jouw account maakt en beheert.

Agent maken of openen

Klik op Create Agent (NL: Agent maken) om een nieuwe agent te bouwen, of selecteer een bestaande agent om te bewerken. In de lijst zie je Status (NL: Status), Last Updated (NL: Laatst bijgewerkt) en Created On (NL: Aangemaakt op), zodat je snel de juiste agent kiest.

Canvas openen

In de agent zie je de builder-canvas met nodes en een plus-knop. Gebruik Add New Node (NL: Nieuwe node toevoegen) om te starten met bouwen, of zoek het startgedeelte van je bestaande flow.

Start trigger toevoegen

Kies in de node picker Start trigger (NL: Start trigger) onder Flow Control (NL: Flow Control). Hiermee plaats je een trigger-tile die naar events luistert om je agent te starten.

Trigger types

In het paneel Select trigger (NL: Trigger selecteren) kies je Form submitted (NL: Formulier ingestuurd), Lead tag (NL: Lead tag) of Chat message (NL: Chatbericht). Je keuze bepaalt welke configuratie-opties je daarna ziet.

Formulier ingestuurd trigger

Gebruik dit als je wilt dat een agent direct opvolgt nadat een contact een formulier invult dat door Voluit Suite wordt bijgehouden. Dit is handig voor snelle nurture, kwalificatie of routing.

Start de agent wanneer een van de geselecteerde formulieren wordt ingestuurd.
Maakt ingestuurde formuliervelden beschikbaar als variabelen die je later in je flow kunt gebruiken.

Lead tag trigger (toegevoegd / verwijderd)

Start gerichte automatiseringen wanneer een tag aan een contact wordt toegevoegd of van een contact wordt verwijderd. Veelgebruikte scenario’s zijn VIP-onboarding, re-activatie of churn-preventie.

Start de agent wanneer een geselecteerde tag wordt toegevoegd of wordt verwijderd bij een contact.
Geeft contactcontext mee (inclusief bestaande tags en custom fields) aan je flow.

Chatbericht trigger

Start je agent zodra er een nieuw inkomend bericht binnenkomt via ondersteunde chat-widgets of providers. Dit is geschikt voor snelle replies, routing of FAQ-afhandeling.

Vereist geen extra configuratie. Voeg de trigger toe en publiceer.
Geeft berichttekst, afzendergegevens en gesprekscontext mee voor je flow-logica.

Formulieren selecteren

Voor de trigger Form submitted (NL: Formulier ingestuurd) gebruik je de dropdown om een of meerdere formulieren te kiezen, of klik je op Add new (NL: Nieuw toevoegen) als het formulier nog niet bestaat. De agent start zodra een van de geselecteerde formulieren wordt ingestuurd.

Tagactie kiezen

Voor Lead tag stel je Tag action (NL: Tagactie) in op Tag added (NL: Tag toegevoegd) of Tag removed (NL: Tag verwijderd). Dit bepaalt of de agent start wanneer een tag wordt toegevoegd of verwijderd.

Lead tag kiezen

Selecteer de tag uit de lijst, of maak er een aan via Add new (NL: Nieuw toevoegen). De agent luistert alleen naar wijzigingen op de tags die je hier selecteert.

Als je tags in bulk toevoegt om te testen, werk dan eerst met een kleine testgroep. Zo voorkom je dat er in één keer heel veel agent-runs starten.

Chat trigger inschakelen

Voor Chat message (NL: Chatbericht) is geen extra configuratie nodig. De agent start automatisch zodra er een nieuw inkomend bericht binnenkomt via gekoppelde chatkanalen.

Valideren en live zetten

Test (NL: Test): Draai een veilige simulatie van de gekozen trigger. Je ziet precies welke variabelen en payload de agent ontvangt. Er worden geen live contacten beïnvloed. Gebruik dit om snel te itereren op prompts en nodes, en om te controleren of de flow klopt.
Save (NL: Opslaan): Sla je wijzigingen op als een Staging-versie zodat je niets kwijtraakt en later kunt verdergaan. Dit zet nog niets live. Opslaan is handig na elke configuratiestap, zoals het kiezen van formulieren of tags.
Publish (NL: Publiceren): Zet de agent en de Start trigger live voor dit account, zodat echte events direct de agent starten. Publiceer nadat je tests goed zijn en controleer dat de Start trigger gekoppeld is aan de eerste node. Als de agent ook gekoppeld is aan andere features (zoals Ask AI), moet de agent meestal in Production staan om selecteerbaar te zijn.

Veelgestelde vragen

V: Veranderen triggers hoe mijn bestaande agents die via de API starten werken?

Antwoord: Nee. Triggers voegen iets toe. Je bestaande API-flows blijven werken. Triggers starten alleen agents waarvoor je een Start trigger hebt toegevoegd.

V: Waar zet ik triggers aan?

Antwoord: In de canvas van elke agent via AI Agents → Agent Studio (NL: AI Agents → Agent Studio). Voeg een Start trigger (NL: Start trigger) toe, configureer deze, gebruik Test (NL: Test) en klik daarna op Publish (NL: Publiceren).

V: Kan ik testen voordat ik live ga?

Antwoord: Ja. Gebruik in de canvas de optie Test (NL: Test) om het event te simuleren en te controleren welke variabelen en responses je agent ontvangt, voordat je publiceert.

V: Welke chatbronnen worden ondersteund?

Antwoord: Triggers werken met de bestaande chat-widgets en providers van Voluit Suite die aan je account gekoppeld zijn. Er is geen extra configuratie nodig om te starten.

V: Welke data krijgt mijn agent wanneer een trigger afgaat?

Antwoord: Formulierinzendingen bevatten de gemapte formuliervelden. Lead tag events bevatten contactcontext. Chat message events bevatten berichttekst en conversatie-metadata.

Antwoord: Controleer of je in het juiste account zit en of de asset daar bestaat. Ververs de builder nadat je nieuwe formulieren of tags hebt aangemaakt.