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:
- Het gesprek krijgt
claimed_by_user_id+claimed_attoegewezen aan jou (route:POST /app/conversations/{conversation}/claim). - 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.
- 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 rolassistanten modelhuman:<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
Conversationvoorkomt 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.