B Blengi docs

Je workspace beheren

Live overdracht tussen mensen

Bezoekers die er met de AI-agent niet uitkomen, kunnen om een mens vragen en krijgen er dan ook echt een — in realtime, via hetzelfde ‘Conversations’-menu dat je team al gebruikt om transcripties te lezen.

Bezoekersstroom

  1. Boven aan de widget staat een knop Praat met een medewerker . Bezoekers hoeven niet te wachten tot de LLM een optie naar voren brengt. De knop verschijnt zodra er een overdracht wordt aangeboden voor de agent (zie Menselijke overdracht per agent in- of uitschakelen hieronder) en verdwijnt terwijl er een verzoek in de wachtrij staat of iemand het heeft overgenomen.
  2. De medewerker herkent ook de intentie voor menselijke overname in de berichttekst — HumanIntentDetector draagt het gesprek over wanneer de bezoeker om een medewerker vraagt, in het Engels of Nederlands: een expliciete zin („talk to a human”, „ik wil een medewerker spreken"), een werkwoord dat verwijst naar contact met een persoon of de klantenservice ("Kan ik de klantenservice bellen?", "Praat met een medewerker"), of alleen de klantenservice zelf ("klantenservice"). Een bericht waarin alleen klantenservice als onderwerp wordt genoemd, wordt door de AI beantwoord: "Klantenservice en productadvies. Welk abonnement past daarbij?", "Is jullie klantenservice op zondag open?", een vraag over wat het product kan ("Kan Blengi gesprekken doorverbinden?") en een zin over andere mensen ("…dat mijn klanten met een medewerker kunnen chatten"). Een match omzeilt de LLM en gaat direct naar de doorverwijzingsstroom; de snelle router gebruikt dezelfde expliciete zinnen, dus een vermelding van een onderwerp volgt ook niet langer het langzamere toolpad.
  3. Bij een klik of intent-match gebeuren er direct drie dingen:
    • Het gesprek wordt op de server gemarkeerd met een human_requested_at -tijdstempel.
    • Er wordt een HumanRequestedEvent geactiveerd. Een luisteraar in de wachtrij verstuurt de Slack-/Teams-ping (zie hieronder). Het gebeurtenis wordt ook uitgezonden als er een uitzenddriver is geconfigureerd, maar er is geen dashboardscherm dat hiernaar luistert: open tabbladen komen via hun eigen polling te weten wat er is aangevraagd (zie Meldingen).
    • NotifyOperatorsHumanRequestedJob verstuurt database- en e-mailmeldingen (plus Web Push en WhatsApp voor leden die die hebben ingeschakeld) naar elk workspace-lid via live_chat_available=true .
  4. De widget toont een banner met "We verbinden je met iemand…" De bezoeker blijft maximaal 2 minuten op deze banner. Zolang het gesprek in het wachtrijvenster staat, zegt de bot niets — elk volgend bericht van de bezoeker wordt in de wachtrij geplaatst voor de operator in plaats van dat er een LLM-antwoord komt.
  5. De bezoeker kan van gedachten veranderen. Op de wachtbanner staat een link ‘Laat maar, blijf gewoon chatten met de assistent’ die het verzoek intrekt (POST /api/v1/widget/request-human/cancel ) en het gesprek direct teruggeeft aan de AI — zonder te wachten op de time-out. Als je het gesprek uit het widgetmenu verwijdert, wordt ook een lopend verzoek geannuleerd. Geen van beide kan een operator onderbreken die de chat al heeft overgenomen: zodra de chat is overgenomen, kan alleen de teamlid met Teruggeven de overdracht beëindigen.
  6. Omdat de bot met één tik wordt uitgeschakeld, vraagt de knop „Praat met een mens“ in de koptekst om een tweede tik ter bevestiging. De eerste tik schakelt hem in („Tik nogmaals om te bevestigen“ ) en na vijf seconden schakelt hij zichzelf weer uit.
  7. Als een medewerker de chat overneemt, ziet de widget dit bij de volgende controle na 3 seconden en toont hij een eenmalige melding ‘Sarah is bij de chat gekomen’ (of ‘Een medewerker is bij de chat gekomen’ als ‘De naam van het teamlid aan bezoekers tonen’ is uitgeschakeld; zie Werkruimte-instellingen ). Het is een kortstondige melding — die wordt ongeveer 8 seconden weergegeven en verdwijnt dan vanzelf, zodat hij nooit boven het invoerveld blijft hangen. De voortdurende status "er is iemand aanwezig" wordt aangegeven door het knipperende "Live-medewerker" -pictogram in de chatkop, dat blijft staan zolang de medewerker het gesprek voert.
  8. Elk bericht in deze flow — de wachtmelding die de bot weergeeft terwijl een verzoek in behandeling is, de wachtbanner en de melding ‘iedereen is bezet’ die verschijnt als een verzoek verloopt zonder antwoord — wordt weergegeven in de taal van de bezoeker, niet in het Engels. Voor een tekst die de bot als antwoord op een bericht weergeeft, is dat de taal waarin het bericht is geschreven; een bericht dat te kort is om te bepalen, valt terug op de taal van de browser, en daarna op de standaardtaal van de medewerker. De meeste Nederlandse bezoekers gebruiken Engelse browsers, dus de browser alleen al zou een Nederlandse vraag met een Engelse zin beantwoorden.
  9. Als er na de time-out van 2 minuten geen medewerker reageert, laat de widget zien: „Er is nu niemand beschikbaar — laat je e-mail achter en we nemen contact op zodra er iemand vrij is.” Het leadformulier wordt geopend voor follow-up buiten de chat om. De melding is nog steeds verzonden, dus operators kunnen het gesprek later via het dashboard overnemen.
  10. De antwoorden van de medewerker verschijnen inline als chatballonnen met een persoonsicoontje; de widget haalt ze elke 3 seconden op zolang hij open is. De berichten van de bezoeker komen op het scherm van de medewerker terecht via een eigen verversing: elke 2 seconden terwijl de chat wacht op een medewerker of wordt overgenomen, anders elke 8 seconden.

Werkwijze van de operator

  1. Het item Gesprekken in de zijbalk toont een rode badge met het aantal gesprekken dat wacht op een medewerker.
  2. Open /app/conversations en schakel over naar het filter Needs you. Elke rij laat zien wanneer de bezoeker op de ‘mens’-knop heeft geklikt, op welke pagina hij zich bevindt en zijn vastgelegde e-mailadres, indien aanwezig.
  3. Klik op een rij → de thread toont live berichten. Klik rechtsboven op Overnemen om het gesprek over te nemen. Dit is de enige plek om een chat over te nemen: op de pagina van een lead zie je het gesprek dat je kunt lezen, met Gesprek openen om hier te komen.
  4. Zolang je het gesprek hebt overgenomen:
    • De bot zal niet automatisch reageren.
    • Gebruik het antwoordvak onderaan (Cmd / Ctrl + Enter om te verzenden).
    • Berichten van bezoekers verschijnen binnen enkele seconden — de pagina wordt elke 2 seconden vernieuwd terwijl je de chat hebt overgenomen.
  5. Klik op Teruggeven als je klaar bent. De server wist claimed_by_user_id, claimed_at, human_requested_at en het typvenster van de operator, en plaatst vervolgens een systeembericht van één regel in de chat (“De operator is even weg. De AI-assistent is er weer om je te helpen.”). De banner „We verbinden je met iemand…“ van de bezoeker verdwijnt bij de volgende poll; de gespreksgeschiedenis blijft intact voor analyses en toekomstig gebruik, en de AI neemt het weer over bij het volgende bericht van de bezoeker.

Werkruimte-instellingen

Op werkplekniveau zijn er een paar instellingen:

  • De naam van het teamlid aan bezoekers tonen (Instellingen › Overname door mens › Beschikbaarheid en meldingen , het selectievakje ‘Livechat personaliseren’ , standaard aan). Als dit aanstaat, ziet de bezoeker de naam van de operator in de melding dat iemand is toegetreden (“Sarah is bij de chat gekomen”). Schakel dit uit voor gereguleerde sectoren (juridisch, gezondheidszorg, financiën) waar de identiteit van individuele operators niet bekend mag worden gemaakt — de bezoeker ziet dan "Een medewerker is aan de chat toegevoegd".
  • Naam van de werkruimte (/settings/workspace ) — de naam die het team ziet in de zijbalk en in uitgaande e-mails. Kan worden bewerkt door eigenaren en beheerders; redacteuren en lagere rollen krijgen een 403-foutmelding.

Meldingen

Er worden twee meldingen getriggerd als een bezoeker om een medewerker vraagt:

  • Een toast in elk geopend dashboardtabblad. Elk tabblad vraagt elke 30 seconden via /app/leads/feed of er nieuwe leads en nieuwe verzoeken om een medewerker zijn, en toont een toast met 'Overnemen' bij elk nieuw verzoek (plus een browsermelding als je dat hebt toegestaan). De ‘Conversaties’-badge in de zijbalk telt de wachtende chats telkens als een pagina wordt geladen. HumanRequestedEvent wordt ook verzonden wanneer een uitzenddriver is geconfigureerd, maar geen enkel scherm zich erop heeft geabonneerd.
  • NotifyOperatorsHumanRequestedJob — database in de wachtrij + e-mailmelding (HumanRequestedNotification ) die via users.live_chat_available = true naar elk lid van de werkruimte wordt doorgestuurd. Leden die het dashboard gesloten hadden, krijgen nog steeds een e-mail, zodat ze het gesprek bij de volgende keer inloggen kunnen claimen.

Als er ook een vastgelegde lead wordt geactiveerd, wordt de e-mail over de vastgelegde lead + de toast-cascade op het dashboard daarnaast ook uitgevoerd. De overdrachtsmelding is idempotent: een tweede verzoek terwijl het eerste nog in de wachtrij staat, leidt niet tot een nieuwe uitzending of melding.

Slimme routering

De server kiest een van de drie reacties op basis van de beschikbaarheid van operators en je openingstijden wanneer een bezoeker om een mens vraagt:

  • In de wachtrij (medewerker online). Er is een medewerker online en het is binnen je openingstijden. De bezoeker ziet "We verbinden je door met iemand…" , het gesprek wordt gemarkeerd, de bot zegt niets en medewerkers krijgen een melding. De wachttijd is beperkt tot 2 minuten (RequestHumanController::WAIT_TIMEOUT_SECONDS = 120 ).
  • Toch in de wachtrij (geen operators online). Binnen de openingstijden, maar niemand heeft aangegeven live chats te willen ontvangen . Je staat nog steeds in de wachtrij en er wordt nog steeds een melding verstuurd — de database en e-mailmelding bereiken elk lid dat zich heeft aangemeld voor live chat, zodat ze het gesprek kunnen overnemen zodra ze het dashboard weer openen. De bezoeker ziet dezelfde banner ‘We verbinden je…’ gedurende die 2 minuten. Na de time-out verandert de widget in ‘Er is nu niemand beschikbaar — laat je e-mail achter en we nemen contact met je op.’
  • Offline — buiten kantooruren. Buiten de kantooruren die je hebt ingesteld. De bezoeker ziet „We zijn nu even gesloten. We zijn er weer op <dag en tijd>. Laat je e-mail achter en we nemen zo snel mogelijk contact met je op.”

Inschrijving door de medewerker

Elk lid van de werkruimte stelt zijn of haar beschikbaarheid individueel in onder Instellingen › Mijn account › Meldingen :

  • Vinkje bij Live chats ontvangen — als dit aan staat EN je beheerderstabblad de afgelopen 2 minuten actief is geweest, word je gezien als een beschikbare medewerker.
  • De hartslagsensor wordt elke 60 seconden geactiveerd zolang het tabblad op de voorgrond staat, en pauzeert wanneer het tabblad verborgen is.

Openingstijden

Configureer dit in Instellingen › Menselijke overname › Beschikbaarheid en meldingen , in het weekrooster onder Kantooruren :

  • Met Kantooruren afdwingen schakel je het schema in. Uit betekent altijd aan: bezoekers kunnen op elk moment om een medewerker vragen.
  • Tijdzone biedt 15 gangbare zones plus Overig (elke IANA-tz)…, waarbij elke IANA-naam kan worden ingevuld (bijvoorbeeld Pacific/Auckland). Een naam die PHP niet herkent, wordt opgeslagen als UTC.
  • Elke dag heeft één of meer open tijdvakken (begin- en eindtijd). Met + Tijdvak voeg je er nog een toe (bijvoorbeeld een lunchpauze of gesplitste diensten); Gesloten zet de hele dag op ‘Gesloten’.
  • Een Open/Gesloten-badge naast de kop geeft de huidige status van het opgeslagen rooster weer; als het gesloten is, staat op de regel eronder wanneer het weer open gaat.

Slack-/Teams-meldingen

Ga naar Instellingen › Menselijke overname › Beschikbaarheid en meldingen, plak daar een URL voor een inkomende webhook voor een van beide platforms. Als een bezoeker om een mens vraagt, stuurt een luisteraar in de wachtrij een korte ping met de URL van het gesprek, zodat een operator direct kan inspringen vanuit Slack / Teams kan instappen zonder het dashboard te openen.

  • Slack — gebruikt de standaard incoming-webhook-URL uit de Slack-app-configuratie. Slack vouwt de gesprekslink automatisch uit.
  • Microsoft Teams — inkomende webhook-URL van de Teams-kanaalconnector. We plaatsen deze als een MessageCard met een knop ‘Gesprek openen’.

Automatische terugval voor niet-opgeëiste gesprekken

Bezoekers mogen nooit eindeloos in een "Verbinding maken..."-ballon blijven hangen. De widget start een client-side timer van 2 minuten op het moment dat de overdracht wordt aangevraagd (zie RequestHumanController::WAIT_TIMEOUT_SECONDS). Als de timer afloopt zonder dat iemand het gesprek heeft opgepakt, verandert de banner in de tekst "Er is niemand in de buurt" en wordt het leadformulier geopend, zodat de bezoeker zijn e-mailadres kan achterlaten. De meldingen zijn één keer verstuurd, bij het eerste verzoek.

Op de server blijft het gesprek vijf minuten gemarkeerd, dus staat het vermeld onder ‘Needs you’ en kan het nog steeds worden overgenomen. Een taak die elke minuut draait (ReleaseStaleHumanRequestsJob) verwijdert vervolgens de markering van elk verzoek dat na vijf minuten nog niet is opgeëist en plaatst in de chat: “Het lijkt erop dat iedereen op dit moment bezig is. Kun je je e-mailadres achterlaten, dan nemen we zo snel mogelijk contact met je op?" in de chat, in de taal van het gesprek. De AI reageert weer vanaf het volgende bericht van de bezoeker. De komende 7 dagen geeft Home het weer als ‘Een bezoeker vroeg om een medewerker en kreeg geen antwoord.

Operator-afwerking (Fase 3)

Opgeslagen antwoorden

Sla de antwoorden op die je team steeds weer typt (instructies voor het opnieuw instellen van het wachtwoord, restitutiebeleid, verwachte leverdata) via Instellingen › Overname door mens › Opgeslagen antwoorden (voorheen ‘standaardantwoorden’ genoemd). Elk item heeft een kort label (waar operators op zoeken) en de volledige tekst van het antwoord. Verander de volgorde met de pijltjes omhoog/omlaag — de meest gebruikte antwoorden moeten bovenaan staan.

Klik in elk live gesprek op de knop ‘Opgeslagen antwoord ’ boven het tekstveld. Zoek op het label of de inhoud met de fuzzy-zoekfunctie, kies er een uit en het tekstveld wordt automatisch ingevuld. De medewerker kan het antwoord bewerken voordat hij op ‘Verzenden’ klikt.

Interne notities

Schakel het antwoordvakje over van het tabblad Antwoord naar het tabblad ‘Notitie’; de plaatshouder verandert dan in Interne notitie (alleen zichtbaar voor je team)…. Interne notities zijn zichtbaar voor andere operators in de gespreksdraad, maar worden nooit naar de bezoeker gestuurd. Handig voor context bij het doorgeven: „Bezoeker lijkt gefrustreerd — ik heb X al geprobeerd, neem het alsjeblieft over.” Automatisch gegenereerde controleberichten bij doorverwijzingen gebruiken deze functie ook.

Typindicatoren

In beide richtingen, geen instellingen nodig:

  • De bezoeker ziet “<Medewerker> is aan het typen…” boven zijn chat terwijl jij in de medewerkerconsoles zit te typen.
  • De medewerker ziet een ballonnetje met drie puntjes in het berichtenlog terwijl de bezoeker in de widget aan het typen is.

Geïmplementeerd als server-side tijdstempels die na 5 seconden automatisch vervallen; beide kanten pollen de bestaande eindpunten, dus er is geen extra infrastructuur nodig.

Gesprek doorverbinden

Klik op de knop Overdragen in de antwoordbalk. Online teamgenoten verschijnen bovenaan met een groen ‘Online’-icoontje; offline teamgenoten staan nog steeds in de lijst (misschien wil je het doorgeven aan iemand die het later overneemt). Als je een ontvanger kiest, wordt de claim opnieuw toegewezen en er verschijnt een interne notitie in de thread („… heb dit gesprek doorgestuurd naar …“). De widget pikt de nieuwe operator op bij de volgende poll na 3 seconden, dus in de typregel verschijnt de nieuwe naam; de melding „is bij de chat gekomen“ verschijnt niet nog een keer.

Editor voor werkurenrooster

Het JSON-tekstveld uit fase 2 is vervangen door een visueel 7-daags rooster onder Instellingen › Handmatige overname › Beschikbaarheid en meldingen . Klik op de knop "+ Venster" op een willekeurige dag om nog een open blok toe te voegen (lunchpauze, gesplitste diensten) toe te voegen, of vink "Gesloten" aan om die dag vrij te nemen. De tijdzonekiezer heeft 15 gangbare IANA-zones plus "Overig" (elke IANA-tz)… voor elke zone die PHP herkent. Zie "Openingstijden" hierboven.

Tags + beoordelingen + herontwerp van de gebruikersinterface (Fase 4)

Gesprekslabels

Categoriseer gesprekken zodat je team ze kan filteren en er rapporten over kan maken. Beheer de lijst onder Instellingen › Handmatige overname › Tags : elke tag heeft een label (max. 60 tekens) en een hex-kleur die de achtergrond van de chip bepaalt.

In elke gespreksdraad heeft het paneel aan de zijkant een gedeelte ‘Tags’ . Klik op de × van een chip om deze los te koppelen; + Tag opent een dropdownmenu met fuzzy-zoekfunctie voor niet-geselecteerde werkruimtetags.

Gesprekenlijst: een dropdownmenu ‘Tags’ voegt zich bij de bestaande filterknoppen ‘Je is nodig’ en ‘Live nu’. Elke rij toont ook toegepaste tags als compacte chips naast de bestaande badges.

Tevredenheidsbeoordelingen

Nadat een medewerker het gesprek heeft afgesloten, ziet de bezoeker een vraag ‘Was dit nuttig?’ met duim-omhoog- en -omlaag-knoppen + een optioneel opmerkingenveld. De eerste beoordeling wordt server-side vergrendeld; latere inzendingen werken alleen de opmerking bij — kopers klaagden over verrassingen in Intercom-stijl waarbij de beoordeling werd overschreven.

Aan de kant van de medewerker: het contextpaneel in het eindvenster toont de beoordeling + opmerking onder de bezoekerskaart. De lijst met gesprekken toont ook een 👍 / 👎-chip op elke rij als er een beoordeling is.

UI van gespreksdraden vernieuwd

De threadpagina is nu een echte helpdesk-interface:

  • Lay-out met twee panelen op desktop (≥ md) — chat aan de linkerkant, contextzijbalk aan de rechterkant. Op mobiel klapt de zijbalk in tot een ‘Sheet’-lade met een ‘Details’-knop.
  • Secties in het rechterdeel van de zijbalk: bezoeker (anonieme ID, taal, vlag voor terugkerende bezoeker, pagina-URL met linkpictogram), lead (e-mail ‘mailto’ / telefoon ‘tel:’ links), tags, tevredenheidsindicator, tijdtegel (leeftijd van de claim / wachttijd / starttijd).
  • Compacte, uniforme actiebalk bovenaan: live pil, statusbadges, knoppen ‘Overnemen’ / ‘Teruggeven’ / ‘Toch teruggeven’ in één cluster.
  • De Composer blijft onderaan staan met de tabbladen ‘Beantwoorden’ / ‘Notitie’, de keuzelijst voor opgeslagen antwoorden, het dropdown-menu voor doorsturen en de typebouncer (allemaal overgenomen uit fase 3).

Verzonden routes (cumulatief)

  • POST /app/conversations/{id}/note — interne notitie
  • POST /app/conversations/{id}/typing — typ-hint voor operator
  • POST /app/conversations/{id}/transfer — claim opnieuw toewijzen
  • POST / DELETE /app/conversations/{id}/tags/{tagId} — tag toevoegen / verwijderen
  • POST /api/v1/widget/typing — typ-hint voor bezoekers (JWT)
  • POST /api/v1/widget/satisfaction — beoordeling door bezoeker (JWT)
  • GET /settings/saved-replies — de pagina 'Opgeslagen antwoorden'; POST / PATCH / DELETE /app/settings/canned-replies/… — CRUD + herschikken
  • GET /settings/tags — de pagina 'Tags'; POST / PATCH / DELETE /app/settings/tags/… — CRUD voor werkruimtetags
  • GET /settings/availability — Beschikbaarheid en meldingen; PATCH /app/settings/live-chat slaat het op

Menselijke overname per agent in- of uitschakelen

Niet elke agent hoeft een medewerker aan te bieden. Bij AI-medewerker → Gedrag › Doorverbinden met een medewerker kiest elke AI-medewerker een van de drie opties:

  • Altijd beschikbaar — een bezoeker kan op elk moment om een medewerker vragen en wacht terwijl het team wordt opgeroepen. Dit is wat elke agent deed voordat deze instelling bestond, en wat bestaande agenten behouden.
  • Alleen als er iemand online is — de overdracht wordt alleen aangeboden als er daadwerkelijk een teamlid achter de desk zit (actief in de afgelopen twee minuten met livechat aan) en de werkplek binnen de openingstijden valt. Anders verschijnt de onderstaande terugvaloptie meteen, in plaats van dat de bezoeker twee minuten moet wachten op informatie die het systeem al vanaf de eerste seconde had.
  • Nooit — alleen AI — helemaal geen doorverbinding naar een medewerker. Voor bedrijven die geen live gesprekken volgen.

Als je dit uitschakelt, worden alle routes in één keer afgesloten: de knop Praat met een medewerker verdwijnt, een bezoeker die ‘praat met een medewerker’ typt, krijgt de fallback in plaats van een knop om het gesprek over te nemen, de assistent krijgt de escalatietool helemaal niet aangeboden en het onderliggende verzoek-endpoint weigert. Het half uitschakelen zou erger zijn dan het aan laten staan — de medewerker zou denken dat de functie uit stond terwijl bezoekers er nog steeds toegang toe hadden.

Wat de bezoeker in plaats daarvan te zien krijgt

Onder de moduskiezer schrijf je de fallback: een bericht, een optionele link naar je eigen contactpagina en een optioneel contactformulier binnen de chat. Je kunt de link, het formulier of beide aanbieden. Laat het bericht leeg en er wordt een verstandige standaardwaarde gebruikt — het is nooit leeg, en het volgt de taal waarin de bezoeker schreef (zie hierboven). Een bericht dat je zelf schrijft, wordt ongewijzigd gebruikt, in één taal. Het formulier is hetzelfde als dat voor leadregistratie, met de velden ingesteld op het tabblad Leadregistratie, onder Het formulier.

Een belangrijk gevolg om te weten: als de overdracht voor een medewerker is uitgeschakeld, worden er geen overdrachtsmeldingen voor hem of haar verstuurd, en een bezoeker die echt iemand nodig heeft, heeft alleen de route die je hier hebt ingesteld. Dat is het doel van de fallback: zorg dat ze een echte medewerker krijgen.