B Blengi docs

Je workspace beheren

Opvolging (tickets)

Een follow-up (een ticket, in de code en de database) is een blijvend ondersteuningsdossier: iets wat iemand nog moet doen na de chat. Gesprekken kunnen stilvallen; follow-ups blijven staan totdat iemand ze afhandelt. Gebruik ze voor zaken die meer vereisen dan het live chatvenster — factuurgeschillen, bugmeldingen, accountproblemen, een terugbelverzoek.

Je vindt ze op het tabblad Follow-ups van Gesprekken , naast ‘Heeft je nodig ’, Live nu en Alles (/app/conversations/follow-ups ). Het tabblad laat zien hoeveel er nog openstaan. Het oude adres /app/tickets stuurt je daarheen, en /app/tickets/{ticket} naar de follow-up zelf.

Hoe follow-ups worden aangemaakt

Er zijn twee manieren. Een knop in de chat kan er geen openen: geen enkel knoptype maakt een follow-up aan.

  1. De AI-medewerker opent er een tijdens de chat via de open_ticket -tool. Dit is automatisch ingeschakeld voor AI-medewerkers met het websitetype help_center (de HelpCenterPreset levert de ticketing -functionaliteit die de tool nodig heeft). Andere typen kunnen zich aanmelden door ticketing toe te voegen aan de vertical_overrides.capabilities van de AI-medewerker.
  2. Een teamlid, vanuit het gesprek. In het zijpaneel van een gesprek staan de vervolgacties vermeld en kun je een vervolgactie aanmaken: een onderwerp, een prioriteit en een optionele notitie. Eigenaren, beheerders en redacteuren kunnen er een aanmaken; kijkers zien alleen de lijst.

Status en prioriteit

De status doorloopt vier waarden die worden ondersteund door constanten op App\Models\Ticket :

StatusBetekenis
openAangemaakt, nog niet opgepakt. Standaard bij het invoeren. Het tabblad ‘Vervolgacties’ telt deze mee.
pendingWordt bewerkt.
resolvedKlaar. Er wordt een stempel geplaatst op resolved_at.
closedGearchiveerd.

De prioriteit is een van de volgende: low, normal, high, urgent. De lijst toont de dringende zaken eerst. De AI stelt dit in wanneer het een follow-up opent; je team kan dit aanpassen op de pagina van de follow-up.

Pagina’s en eindpunten

  • GET /app/conversations/follow-ups — de lijst, gefilterd op status (standaard ‘open’; ‘in behandeling’, ‘opgelost’, ‘gesloten’ of ‘alles’). Beperkt tot de werkruimte via de eigenschap BelongsToWorkspace. Elk lid van de werkruimte kan deze bekijken.
  • GET /app/conversations/follow-ups/{ticket} — één follow-up, met Open gesprek als deze uit een chat komt.
  • PATCH /app/tickets/{ticket} — status, prioriteit of toegewezen persoon wijzigen. Eigenaar, beheerder of redacteur (TicketPolicy::update).
  • POST /app/conversations/{conversation}/follow-ups — maak er een aan vanuit een gesprek. Dit mag iedereen doen die dat gesprek kan overnemen (bijvoorbeeld de AI-medewerker), dus een lid van een andere werkruimte wordt geweigerd.

Schema

De tabel tickets (migratie 2026_05_13_092105_create_tickets_table.php) blijft ongewijzigd door de overstap naar Conversations:

  • workspace_id, agent_id, conversation_id (mag leeg zijn).
  • subject (maximaal 200 tekens), body.
  • status (open / in behandeling / opgelost / gesloten), priority (laag / normaal / hoog / urgent).
  • assigned_to_user_id — mag leeg zijn.
  • metadata JSON — waar het vandaan komt: de open_ticket-tool slaat source: 'open_ticket_tool' op; de follow-up van een teamlid slaat source: 'team_member' en created_by_user_id op.
  • resolved_at wordt gestempeld wanneer de status verandert naar opgelost.
  • Tijdstempels.

Hoe de open_ticket-tool werkt

Kijk bij Tools & rich messages voor de structuur van het register. Het invoerschema van de tool:

  • subject — verplicht, maximaal 200 tekens.
  • body — verplicht. De AI wordt gevraagd om de account- of bestelnummers van de bezoeker op te nemen, wat ze hebben geprobeerd en wat er misging.
  • priority — optioneel, standaard ingesteld op normal.

Bij het starten voegt de tool een Ticket-regel toe die gekoppeld is aan het huidige gesprek en stuurt een bevestiging terug die de AI verwerkt in zijn antwoord. Er wordt geen melding verstuurd: nieuwe follow-ups verschijnen in het tabblad ‘Follow-ups’ en de teller.