Agent Studio: Triggers instellen voor Flow Agents

Gebruik Voluit Suite Triggers om een AI-agent automatisch te starten wanneer er iets gebeurt met een contact of wanneer er een systeemevent plaatsvindt in Voluit Suite. Met real-time starts reageer je sneller, verminder je handmatig werk en start je de juiste automatisering op het moment dat de trigger afgaat. In dit artikel lees je hoe je real-time Start triggers instelt voor bestaande Flow Agents in Voluit Suite.

Belangrijk: Agent Studio bevat nu Super Agents en Flow Agents. Nieuwe agents maak je via Super Agents. Bestaande Flow Agents blijven normaal werken en kun je nog steeds openen, aanpassen en beheren via de Flow Agents-pagina.

Wat zijn Triggers voor Flow Agents?

Flow Agent Triggers zijn event listeners die je aan de Start-node van een agent koppelt. Ze starten je agent automatisch zodra een ondersteund event in Voluit Suite plaatsvindt. Daardoor kan je agent direct reageren op acties zoals een formulierinzending of een chatbericht—zonder externe API-calls of handmatige stappen.

Op dit moment zijn er drie instap-events:

Formulier ingediend
Lead tag (toegevoegd of verwijderd)
Chatbericht

Wanneer één van deze events afgaat, start de agent vanaf de Start trigger en loopt daarna verder door de flow die jij hebt gebouwd.

Belangrijkste voordelen van Flow Agent Triggers

Real-time interactie: Reageer op leads op het moment dat ze iets doen—een formulier invullen, een bericht sturen of een tag krijgen.
Schaalbaar zonder handwerk: Je hoeft geen polling scripts of custom webhooks te gebruiken; je stelt de trigger in en publiceert.
Vaste instap: Je standaardiseert hoe agents starten, waardoor testen en troubleshooting makkelijker worden.
Werkt naast je bestaande setup: Triggers zijn optioneel en aanvullend; bestaande API-gestuurde agents blijven werken.
Basis voor uitbreiding: Een event-gedreven opzet maakt het makkelijker om later meer event types toe te voegen.

Zo stel je Triggers in voor Flow Agents

Volg deze stappen om je triggers netjes in te stellen, te testen en live te zetten.

Vereisten & toegang:

- Zorg dat je toegang hebt en in de juiste omgeving werkt.
- Ga in Voluit Suite naar AI Agents → Agent Studio in het juiste account.
- Voor uitleg over navigatie op het canvas, testen en het publicatieproces: zie link onderaan.

Klik in de linkerzijbalk op AI Agents en kies bovenaan het tabblad Agent Studio.
Klik op Flow Agents.
Klik op de naam van een bestaande agent om die te bewerken.
Je ziet nu het builder canvas met nodes en een plus-icoon. Gebruik Add New Node (Nieuwe node toevoegen) om te starten met bouwen, of zoek het startpunt op van je bestaande flow.
Kies in de node picker Start trigger onder Flow Control. Hiermee plaats je een trigger-tile die luistert naar events om je agent te starten.

Kies in het paneel Select trigger één van de volgende opties: Form submitted, Lead tag, Chat message of Workflows. Op basis van je keuze verschijnen de bijbehorende instellingen.
1. Trigger: Form submitted (Formulier ingediend)
  
  Gebruik deze trigger als je wil dat je agent meteen start nadat iemand een Voluit Suite-formulier heeft ingediend. Handig voor snelle opvolging, kwalificatie of routing.
  - De agent start wanneer één van de geselecteerde formulieren wordt ingediend.
  - Ingediende velden zijn beschikbaar als variabelen die je later in je flow kunt gebruiken.
    
    Trigger: Lead tag (tag toegevoegd / verwijderd)
    
    Gebruik dit als je gerichte automatiseringen wil starten zodra een tag op een contact wordt gezet of eraf wordt gehaald (bijvoorbeeld onboarding, re-engagement of churn-preventie).
  - De agent start wanneer de gekozen tag wordt toegevoegd of verwijderd.
  - Je flow krijgt context van het contact mee (zoals bestaande tags en custom fields).
    
    Trigger: Chat message (Chatbericht)
    
    Gebruik dit als je agent direct moet starten bij een nieuw inkomend bericht via ondersteunde chatkanalen.
  - Er is geen extra configuratie nodig.
  - Je flow krijgt de berichttekst, afzendergegevens en conversatiecontext mee.
2. Trigger: Workflows
  
  Voor meer uitleg: zie link onderaan.
  
  Stel je trigger in
  
  Formulier ingediend

Kies via de dropdown één of meerdere formulieren.
Bestaat je formulier nog niet? Klik dan op Add new om er één aan te maken.
De agent start zodra één van de geselecteerde formulieren wordt ingediend.

Lead tag
Kies bij Tag action of je wil starten bij Tag added of Tag removed.
Kies daarna de specifieke tag uit de lijst, of maak er één aan via Add new.
De agent luistert alleen naar wijzigingen op de tag(s) die jij hier selecteert.

Als je tags in bulk toevoegt om te testen, gebruik dan eerst een kleine testgroep. Zo voorkom je dat je onbedoeld veel agent-runs tegelijk start.

Chatbericht
Extra configuratie is niet nodig.
De agent start automatisch bij elk nieuw inkomend chatbericht via gekoppelde chatkanalen.

Controleren & live zetten

Test: Simuleer de trigger om te zien welke variabelen en payload je agent ontvangt. Er worden geen echte contacten beïnvloed. Gebruik dit om je prompts/nodes te verbeteren en je flow te controleren voordat je publiceert.
Save (Opslaan): Sla je wijzigingen op als een Staging-versie. Hiermee gaat er nog niets live, maar je werk blijft bewaard. Handig na elke stap (bijvoorbeeld na het kiezen van formulieren of tags).
Publish (Publiceren): Zet je agent en Start trigger live voor je account. Publiceer pas nadat je tests goed zijn. Controleer ook dat de Start trigger gekoppeld is aan de volgende node. Als je agent gekoppeld is aan andere features (bijvoorbeeld Ask AI), moet de agent meestal in Production staan om selecteerbaar te zijn.

Veelgestelde vragen

V: Kan ik een nieuwe Flow Agent maken voor real-time Start triggers?

Antwoord: Nee. Nieuwe agents maak je via Super Agents. Bestaande Flow Agents kun je nog steeds openen, bewerken en beheren via de Flow Agents-pagina.

V: Blijven mijn bestaande Flow Agent triggers werken?

Antwoord: Ja. Bestaande Flow Agents en hun ingestelde triggers blijven normaal werken.

V: Veranderen triggers hoe mijn bestaande API-gestuurde agents draaien?

Antwoord: Nee. Triggers zijn aanvullend. Je bestaande API-flows blijven werken; triggers draaien alleen voor agents waar je een Start trigger aan hebt toegevoegd.

V: Kan ik testen voordat ik live ga?

Antwoord: Ja. Gebruik op het canvas de optie Test om het event te simuleren en te controleren welke variabelen en responses je agent krijgt.

V: Welke chatbronnen worden ondersteund?

Antwoord: Triggers werken met de bestaande chatwidgets/providers in Voluit Suite die gekoppeld zijn aan je account. Extra configuratie is niet nodig.

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

Antwoord: Bij formulierinzendingen worden de (gemapte) formuliervelden meegestuurd. Bij lead tag events krijgt je flow contactcontext mee. Bij chatberichten krijg je onder andere de berichttekst en conversatiemetadata.

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