Je AI-medewerker bouwen
Gedragsregels en triggers
Triggers openen de chat automatisch op een moment dat jij kiest — bijvoorbeeld als een bezoeker
op het punt staat weg te gaan, even niets doet, ver naar beneden scrolt of via een campagne binnenkomt —
met een bericht dat jij zelf hebt opgesteld. In de code en de database zijn het
gedragsregels
(de behavior_rules
-tabel). Ze
worden alleen in de browser van de bezoeker uitgevoerd; er gebeurt niets mee tijdens een
chatbeurt.
Waar stel je ze in?
Bij de AI-medewerker, Gedrag › Wanneer de chat van
zelf opent (/app/agents/{id}/behavior), onder
Triggers, naast ‘automatisch openen’ en de geplande uitnodiging.
Om er een toe te voegen, vul je Naam in, kies je Wanneer,
voer je het unieke nummer in dat bij dat type hoort, schrijf je de tekst voor ‘Bar
opent met bericht’ en klik je op Trigger toevoegen.
De lijst onder het formulier legt in gewone taal uit wanneer elke trigger afgaat, met het bijbehorende bericht. Met het prullenbakpictogram kun je er een verwijderen na een bevestiging. De pagina heeft geen bewerkingsknop en geen aan/uit-schakelaar: om een trigger te wijzigen, verwijder je hem en voeg je hem opnieuw toe.
De zeven triggers
| Wanneer | Code | Wordt geactiveerd | Instelling |
|---|---|---|---|
| Op het punt om de pagina te verlaten | exit_intent | Wanneer de muis via de bovenrand de pagina verlaat. Hiervoor is een muis nodig, dus in de praktijk alleen op een desktop. | — |
| Een tijdje geen activiteit | idle | Na zoveel seconden zonder muisbeweging, toetsaanslag, scrollen of aanraking. | Seconden (standaard 30) |
| Naar beneden gescrolld | scroll | Nadat je dit deel van de pagina hebt gescrolld. Bij een pagina die te kort is om te scrollen, wordt dit nooit geactiveerd. | Percentage (standaard 50) |
| Een tijdje op de pagina | time | Na zoveel seconden op de pagina. | Seconden (standaard 30) |
| Een terugkerende bezoeker | returning | Vanaf het moment dat de pagina voor de tweede keer in dezelfde browser wordt geladen. De widget telt het aantal keer dat de pagina in de browser wordt geladen (pb_visitor_count), dus een tweede pagina tijdens hetzelfde bezoek telt al mee. | — |
| Afkomstig van een campagne | utm | Als het adres van de pagina utm_campaign bevat met deze waarde. | Campagne |
| Er zit nog iets in het winkelmandje | abandoned_cart | Als er al zoveel minuten items in het winkelmandje zitten. Het leest de status van het winkelmandje die de WordPress-plugin in de browser bijhoudt bij WooCommerce-winkels (pitchbar_cart_state), en controleert dit elke 30 seconden; zonder de plugin wordt het nooit geactiveerd. | Minuten (standaard 5) |
Een trigger die is aangemaakt voordat deze instellingen bestonden, gebruikt de standaardinstellingen; een campagnetrigger zonder campagne gaat af bij elke keer dat de pagina wordt geladen.
Wat gebeurt er als er een wordt geactiveerd
- De widget opent de chat op deze pagina en voegt het bericht van de trigger toe als een ballonnetje van de AI-medewerker. Een trigger die zonder bericht is opgeslagen, gebruikt Hoi! Kan ik je helpen iets te vinden? in de taal van de bezoeker (voorheen opende het in een leeg ballonnetje). Als je het op deze manier opent, wordt dit niet opgeslagen als de keuze van de bezoeker, dus de chat blijft niet op latere pagina’s openen.
- Er wordt een
trigger.fired-gebeurtenis geregistreerd met de id en het type van de trigger. - Elke trigger gaat maximaal één keer af per keer dat de pagina wordt geladen, en wacht daarna vijf minuten in die browser voordat hij weer kan afgaan (per trigger, opgeslagen onder
pb_last_trigger_at:<id>).
De widget ontvangt de triggers van /widget/init wanneer deze
wordt geladen: maximaal 20 ingeschakelde triggers, met de hoogste prioriteit eerst. Triggers die op
de pagina worden toegevoegd, worden ingeschakeld met prioriteit 0.
Hoe een trigger wordt opgeslagen
Elke trigger is een rij in behavior_rules:
- naam — wat er in de lijst wordt weergegeven.
- soort — een van de zeven codes hierboven. De server accepteert geen andere waarde (
BehaviorRuleController). - voorwaarden — de enige instelling:
seconds(inactiviteit, tijd),percent(scrollen),idle_minutes(verlaten winkelwagentje) ofutm_campaign(campagne). - actie —
{"kind": "open_with_message", "message": "…"}. - ingeschakeld, prioriteit — zie hierboven.
- cta_rule_id — wordt opgeslagen, maar de widget gebruikt het niet.
Gerelateerde instellingen
- Knoppen in de chat (Gedrag › Knoppen in de chat) zijn CTA-regels, een aparte tabel — zie CTA-knoppen.
- Vaste antwoorden (Kennis › Vaste antwoorden) — zie Vaste antwoorden & CTA’s.
- Wanneer het leadformulier verschijnt, stel je in op het tabblad Leadregistratie, onder Wanneer er wordt gevraagd.
- Doorverbinden naar een medewerker — zie Live doorverbinden naar een medewerker.
- Begeleide gesprekken — zie Begeleide gesprekken (workflows).