B Blengi docs

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

WanneerCodeWordt geactiveerdInstelling
Op het punt om de pagina te verlatenexit_intentWanneer de muis via de bovenrand de pagina verlaat. Hiervoor is een muis nodig, dus in de praktijk alleen op een desktop.—
Een tijdje geen activiteitidleNa zoveel seconden zonder muisbeweging, toetsaanslag, scrollen of aanraking.Seconden (standaard 30)
Naar beneden gescrolldscrollNadat 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 paginatimeNa zoveel seconden op de pagina.Seconden (standaard 30)
Een terugkerende bezoekerreturningVanaf 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 campagneutmAls het adres van de pagina utm_campaign bevat met deze waarde.Campagne
Er zit nog iets in het winkelmandjeabandoned_cartAls 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) of utm_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