B Blengi docs

Je workspace beheren

Leads & handmatige afhandeling

Leads (/app/leads ; het heette vroeger Inbox, en /app/inbox stuurt nog steeds hierheen) geeft een overzicht van alle vastgelegde leads. Als je er een opent, zie je de details en status van de lead, en het gesprek waaruit de lead is voortgekomen, zodat je het kunt lezen. Om de chat over te nemen of te reageren, opent Gesprek openen het gespreksscherm — de enige plek waar een teamlid een chat kan overnemen.

Een balk boven de lijst laat zien hoeveel leads er in totaal zijn die ‘Nieuw’, ‘Gekwalificeerd’, ‘Gecontacteerd’, ‘Gewonnen’ en ‘Verloren’ zijn (de leadpijplijn die vroeger op het Dashboard stond). Als je op een van die aantallen klikt, krijg je de lijst te zien die op die status is gefilterd. Op de startpagina zie je de leads die nog ‘Nieuw’ zijn.

Met de periode-instelling — Altijd (standaard), ‘Laatste 7 dagen ’, 30 of 90 (?period=7d|30d|90d ) — beperk je de lijst, de statistieken per status en de totalen tot leads die in die dagen zijn vastgelegd: vandaag en de dagen ervoor, vanaf middernacht, dezelfde periode als bij ‘Gesprekken’ en Resultaten. De tegel Nieuwe leads op Home opent Leads met de laatste 7 dagen, dus de lijst toont het aantal op de tegel. Een lead die is verzonden vanuit een testchat in je dashboard heeft het label ‘Test ’: deze wordt weergegeven zodat je het formulier en de e-mail kunt controleren, maar Home en Resultaten tellen deze niet mee.

Leads en Conversations kunnen worden gefilterd op één AI-medewerker: een chip geeft de naam weer, linkt ernaar terug en verwijdert het filter. Dit vervangt de afzonderlijke lijsten die elke AI-medewerker vroeger had; hun adressen (/app/agents/{id}/leads en /app/agents/{id}/conversations ) openen de gefilterde lijsten. De cijfers van de gefilterde lijst tellen alleen die AI-medewerker mee.

Lay-out

/app/leads toont leads, met de nieuwste bovenaan. Als je er een opent, zie je links het gesprek dat ertoe heeft geleid — berichten van bezoekers aan de ene kant, de antwoorden van de AI-medewerker en eerdere antwoorden van mensen aan de andere kant — met Gesprek openen en, als er iemand in de chat zit, wie dat is. Het e-mailadres, de naam, het telefoonnummer, de status en de plaats waar de lead is binnengekomen, staan aan de rechterkant. Het gespreksscherm linkt terug naar Open lead in het zijpaneel.

De kolom ‘Status’ is een inline-keuzelijst — pas deze ter plekke aan om een lead te verplaatsen van ‘nieuw’ → ‘gekwalificeerd’ → ‘gecontacteerd’ → ‘gewonnen / verloren’. De lijst wordt ook automatisch vernieuwd wanneer het tabblad weer de focus krijgt of je terugnavigeert vanuit een gespreksdraad, zodat een statuswijziging die je elders hebt aangebracht, wordt weergegeven zonder dat je handmatig hoeft te verversen.

De gespreksindex bij /app/conversations omvat elk gesprek, ongeacht of het een lead heeft opgeleverd — handig om eerdere sessies te doorzoeken die niet tot een conversie hebben geleid.

Live updates

Updates komen binnen via polling, niet via websockets. Een geopend gespreksscherm verversen zijn berichten elke 2 seconden terwijl de chat wacht op iemand of wordt overgenomen, en anders elke 8 seconden (alleen zolang het tabblad zichtbaar is; als je op de Live-knop klikt, wordt het gepauzeerd). De widget van de bezoeker vraagt elke 3 seconden om nieuwe reacties van het team en de status van de overname, zolang deze open is. De server zendt wel gebeurtenissen uit op privékanalen als er een uitzenddriver is geconfigureerd, maar geen enkel scherm is daarop geabonneerd.

Overnemen

Klik in het gespreksscherm op Overnemen. (Vroeger had de hoofdpagina zijn eigen knoppen voor ‘Overnemen’, ‘Teruggeven’ en ‘Reageren’; die zijn verdwenen, dus er is nu één scherm met één set knoppen.) Er gebeuren een paar dingen:

  1. Het gesprek krijgt claimed_by_user_id + claimed_at toegewezen aan jou (route: POST /app/conversations/{conversation}/claim).
  2. Bij de volgende poll na 3 seconden ziet de widget van de bezoeker de overname: er verschijnt ongeveer 8 seconden lang een kort berichtje "<Naam> is bij de chat gekomen" ("Een medewerker is bij de chat gekomen" als namen verborgen zijn), en een 'Live agent'-pilletje in de chatkop zolang je de chat vasthoudt.
  3. De AI wordt gepauzeerd. Elk bericht van een bezoeker wacht op je in het gesprek. Elk antwoord dat je verstuurt (POST /app/conversations/{conversation}/reply) wordt opgeslagen als een bericht met rol assistant en model human:<your user id>; de widget pikt het op bij de volgende poll en toont het als een tekstballon van een teamlid.

WhatsApp-chats

Chats van WhatsApp staan in dezelfde lijst, met een WhatsApp-badge en de naam en het nummer van de klant; filter op Website of WhatsApp via het kanaalmenu. Een antwoord dat je typt op een WhatsApp-chat wordt meteen via WhatsApp verstuurd. WhatsApp staat een gratis antwoord alleen toe binnen 24 uur na het laatste bericht van de klant: in de chat staat tot wanneer, en een antwoord dat WhatsApp weigert, wordt bewaard en gemarkeerd als niet bezorgd. Bij elk bericht staat ‘verzonden’, ‘bezorgd’ of ‘gelezen’. Zie het WhatsApp-kanaal.

Vrijgeven

Klik op Hand terug om vrij te geven (route: POST /app/conversations/{conversation}/release ). Het volgende bericht van de bezoeker doorloopt opnieuw de RAG-pijplijn. In de chat verschijnt de tekst “De medewerker is even weg. De AI-assistent staat weer klaar om te helpen.” , en de widget verwijdert de ‘Live agent ’-pil bij de volgende poll. Handig wanneer:

  • Je de vraag buiten het script hebt beantwoord en de rest weer onder de FAQ valt.
  • De bezoeker tevreden is en waarschijnlijk gaat vertrekken.
  • Je je dienst afrondt — door het werk over te dragen blijft de dienstverlening 24/7 gewaarborgd.

Leads vastleggen

Leads komen op twee manieren binnen:

  • Bezoekersgestuurd — het inline leadformulier van de widget, geactiveerd door een gedragsregel of doordat de bezoeker expliciet vraagt om gecontacteerd te worden. Ingediende leads komen terecht in /app/leads.
  • Via webhook — elke vastgelegde lead activeert de uitgaande webhook lead.captured, zodat je deze naar je CRM kunt doorsturen. Zie Uitgaande webhooks.

Live in-app-meldingen

De admin-shell controleert elke 30 seconden GET /app/leads/feed op nieuw vastgelegde leads in de werkruimte en toont elke lead als een Sonner-toast rechtsonder op elke pagina in de admin-SPA. Klik op de toast om direct naar de lead te gaan.

De belknop in de bovenste koptekst vraagt de browser om toestemming voor native meldingen. Zodra die is verleend, activeert elke nieuwe lead ook een melding op OS-niveau, zodat werkruimteleden een melding krijgen op tabbladen waarop ze niet actief werken. Toestemming geldt per domein — als je deze eenmaal weigert, kun je dit alleen ongedaan maken via de instellingen van je browser.

Het ophalen van gegevens wordt gepauzeerd op verborgen tabbladen om te voorkomen dat inactieve dashboards HTTP-verkeer verspillen. De cursor staat in sessionStorage, dus als je een tweede tabblad opent, krijg je geen dubbele melding voor leads die je al hebt gezien.

E-mailmeldingen

Standaard wordt elke vastgelegde lead per e-mail verstuurd naar elke werkruimte-eigenaar en -beheerder. Per AI-medewerker kun je onder Lead vastleggen › Wie op de hoogte wordt gebracht van een nieuwe lead, maximaal 10 extra adressen toevoegen (ze hebben geen account nodig) en de optie ‘Ook verzenden naar de werkruimte-eigenaren en beheerders’ uitschakelen, zodat alleen die adressen het bericht ontvangen. De melding (App\Notifications\NewLeadCaptured) wordt in de wachtrij geplaatst — het HTTP-verzoek van de bezoeker wacht nooit op SMTP, dus een trage mailserver kan het vastleggen van leads of de chat niet vertragen.

Teamontvangers worden gefilterd via workspace_users.role IN ('owner', 'admin') met accepted_at IS NOT NULL. In afwachting van uitnodigingen ontvangen redacteuren en kijkers geen lead-e-mails, tenzij hun adres een van de extra ontvangers is; een extra adres dat al bij zo’n eigenaar of beheerder hoort, krijgt één e-mail, niet twee. De voettekst van de e-mail geeft de titel van je white-label-site weer (ingesteld in Instellingen → Systeem).

Het gesprekslogboek opschonen

Er wordt een nieuwe Conversation-rij toegevoegd telkens wanneer een bezoeker de widget voor het eerst binnen 24 uur laadt. Bezoekers die alleen even langskomen zonder iets te typen, zorgen ook voor een rij, wat betekent dat /app/conversations na verloop van tijd vol kan raken met lege sessies. Twee functies houden het overzichtelijk:

  • Filter Alleen actieve gesprekken (standaard). De lijst verbergt gesprekken zonder berichten van bezoekers. Schakel Alles weergeven in de filterbalk in om elke sessie te zien — handig als je op zoek bent naar botverkeer of QA-belastingen. De tegel ‘Gesprekken’ op het dashboard en de lijst met medewerkers werken volgens dezelfde regel, dus de cijfers komen overeen met deze lijst. Onder Heeft jou nodig en Nu live worden alle overeenkomende sessies weergegeven, ook die waarbij de bezoeker om een medewerker vroeg voordat hij iets typte (de knop in de chatbalk werkt meteen): de tegels en de startpagina tellen die mee, dus de lijst toont ze ook.
  • Periodefilter . All time / Last 7 days / Last 30 days / Last 90 days (?period=7d|30d|90d ) begrenst de lijst op basis van de starttijd van het gesprek en blijft van kracht bij zoeken, de ‘pills’, de ‘engaged’-schakelaar en paginering. De afgelopen 7 dagen zijn vandaag en de zes dagen daarvoor, vanaf middernacht — dezelfde periode als bij ‘Resultaten’ en ‘Home’ onder ‘Deze week ’. Het aantal naast het bedieningselement is het aantal gesprekken in dat venster onder de huidige filters — het snelste antwoord op ‘hoeveel echte gesprekken hebben we deze week gehad’. Onbekende waarden vallen terug op ‘Alle tijden’, dus een oude bladwijzer geeft nooit een foutmelding.
  • Per rij verwijderen . Beheerders en eigenaren zien een prullenbakpictogram als je er met de muis overheen gaat. Verwijderen heeft een domino-effect op berichten, leads en toegepaste tags via externe sleutels in de database; analyse-events blijven behouden (externe sleutel nullOnDelete ), zodat de geaggregeerde statistieken intact blijven.
  • Lege sessies in bulk verwijderen . De knop in de filterbalk verwijdert de lege sessies die hij telt: die van de AI-medewerker waarop de lijst is gefilterd (?agent= ), of van de hele werkruimte als dat niet het geval is, en de bevestiging geeft aan welke. Een sessie is leeg als de bezoeker geen bericht heeft gestuurd, niet om een medewerker heeft gevraagd en geen teamlid het heeft overgenomen. Sessies waarin de bezoeker iets heeft geschreven of op een medewerker wacht, worden nooit aangeraakt. Er blijven nu nog twee over: een sessie met een lead (het pre-chat- formulier slaat er een op vóór elk bericht, en als je de sessie verwijdert, wordt de lead mee verwijderd) en een sessie die minder dan een uur geleden is geopend, waarbij de bezoeker misschien nog aan het typen is. Geen van beide wordt meegeteld in de knop.
  • Geselecteerde sessies in bulk verwijderen . Vink de selectievakjes aan bij alle zichtbare rijen en klik vervolgens op ‘N geselecteerde verwijderen ’. De globale werkruimte-scope op Conversation voorkomt het smokkelen van ID’s tussen tenants — ID’s van andere werkruimtes worden aan de serverzijde stilzwijgend verwijderd.

Kijkers en Bewerkers zien geen verwijderopties; de controles ConversationPolicy::delete + WorkspacePolicy::bulkDeleteConversations vereisen Beheerder of Eigenaar. Verwijderen is onomkeerbaar — er is geen 'soft-delete'-spoor en het auditlogboek registreert het verwijderen van gesprekken nog niet.

Auditlog

Overnemen en teruggeven (claimen, vrijgeven) schrijven geen audit_logs -rijen. De thread zelf toont de regel voor het teruggeven en, na een overdracht, een interne notitie waarin beide teamleden worden genoemd. Platformmedewerkers kunnen het auditlogboek van een werkruimte bekijken op /admin/workspaces/{workspace}/audit ; er is geen auditpagina voor klanten.