Skip to content
Work Expertise Services CV Portfolio Integrations Laravel packages Blog Sign in Get in touch

FreeScout API

Een helpdesk is een gedeelde mailbox met geheugen. FreeScout is er een die je zelf host. Hieronder staat wat ik op hun api gebouwd heb: gesprekken die aankomen met het dossier er al bij, en antwoorden die terugkomen naar het scherm waar de rest van de zaak staat.

Wat FreeScout is

FreeScout is een open source helpdesk die je op je eigen server zet: een gedeelde mailbox waar een ploeg samen in werkt, met gesprekken, toewijzing, statussen, notities en een geschiedenis per klant. Het is zelf in Laravel geschreven, met modules ernaast voor wat de kern niet doet.

Dat laatste is hier geen detail. De rest-api zit in het pakket zelf en praat over gesprekken, threads, klanten, mailboxen en gebruikers; een sleutel in de header volstaat om binnen te geraken. Voor de andere richting, gebeurtenissen die vanuit de helpdesk vertrekken, komt er een module bij. Samen is dat genoeg om de helpdesk aan een applicatie te hangen zonder dat iemand nog moet overtikken.

Wat ik erop gebouwd heb

Zes stukken tussen een melding in de applicatie en een gesprek dat behandeld en afgesloten is, zonder dat iemand in twee schermen tegelijk moet zitten.

Een gesprek aanmaken met het dossier erbij

Wat in de applicatie een melding is, wordt bij FreeScout een gesprek: het onderwerp, het bericht van de klant, en de gegevens van de zaak als eerste blok eronder. Het bestelnummer, de winkel, het toestel, de laatste vier stappen die de gebruiker zette. De klantendienst begint dus niet met uitzoeken over welke bestelling het gaat.

De klant is een klant, geen mailadres

Voor er een gesprek vertrekt, gaat er een klant naartoe: naam, mailadressen, telefoon en het klantnummer uit de applicatie. Het mailadres is de sleutel, dus wie vorige maand al eens schreef, krijgt er geen tweede fiche bij. Mailt iemand vanaf een tweede adres, dan hangt dat adres bij dezelfde klant.

De juiste mailbox, de juiste status

Welke mailbox een gesprek binnenkomt, volgt uit de gegevens: de winkel, de taal of het merk waar de melding over gaat. Meteen daarbij horen de status en de toewijzing. Iets dat op de klant wacht, komt als pending binnen en niet als actief, zodat een wachtrij toont wat er echt ligt.

Antwoorden die terug in de applicatie komen

De webhooks duwen terug wat er met het gesprek gebeurt: een antwoord van de klant, een antwoord van een medewerker, een toewijzing, een status die verspringt, een gesprek dat gesloten wordt. Dat hangt bij de bestelling in het eigen scherm, zodat iemand die daar kijkt niet in een tweede portaal moet gaan zoeken.

Een knop in beide richtingen

Vanuit het eigen scherm ga je met een klik naar het gesprek, en vanuit het gesprek terug naar de bestelling. Twee deeplinks, meer is het niet, en het scheelt de klantendienst de hele dag door een zoekopdracht.

Bijlagen en interne notities

Een foto die de klant opstuurde, een pdf van de factuur of een logregel gaat als bijlage mee met de thread. Wat de collega's onderling schrijven, gaat als notitie: die staat bij het gesprek, maar vertrekt nooit naar de klant.

Hoe het in elkaar zit

Vijf keuzes die bepalen of de helpdesk ook klopt op de dag dat een bericht niet binnenkomt of dezelfde klant vanaf een ander adres schrijft.

Het gesprek is van FreeScout, het dossier van de applicatie

De helpdesk houdt bij wat er gezegd is, de applicatie houdt bij wat er waar is: de bestelling, de betaling, het toestel. Die scheiding houdt beide kanten klein. Wat FreeScout toont van het dossier, is een kopie op het moment van schrijven, en geen tweede waarheid die later uit elkaar loopt.

Twee keer dezelfde webhook verandert niets

Een webhook mag opnieuw komen na een uitrol of een server die even niet antwoordde. Wat binnenkomt wordt weggeschreven op het nummer van het gesprek en van de thread, dus dezelfde gebeurtenis levert geen tweede regel op in de tijdlijn en geen tweede melding voor de collega.

Een ticket vertrekt uit een wachtrij

Niemand die op verzenden duwt, wacht tot de helpdesk geantwoord heeft. Het aanmaken gaat door een wachtrij, met een herhaling voor een fout die overwaait en een melding voor een fout die blijft. Ligt FreeScout plat, dan blijft de melding in de wachtrij staan en gaat ze niet verloren.

Alleen wat de klantendienst nodig heeft

Er gaat geen volledig klantenbestand naar de helpdesk. Wat meegaat, is wat iemand nodig heeft om dit ene geval te behandelen. Dat scheelt een kopie van persoonsgegevens in een tweede systeem, en het maakt de vraag wat er waar staat achteraf beantwoordbaar.

Zelf gehost, dus er is een verdieping onder de api

FreeScout draait op je eigen server en is zelf een Laravel-applicatie. Waar de api ophoudt, kan je er een module naast zetten of in de databank kijken. Dat is de reden waarom de keuze hierop viel en niet op een pakket waar je alleen langs de voordeur binnen mag.

Wat een api toevoegt aan een mailbox

Een gedeelde mailbox is geen slecht systeem: iedereen ziet alles, en wie antwoordt, antwoordt. Waar het misloopt is de context. De mail zegt "mijn pakket is niet aangekomen" en niets meer, dus begint de behandeling met opzoeken wie er schrijft, wat hij bestelde en wat de vervoerder erover zegt. Dat kwartier gaat niet naar de klant.

Een gesprek dat via de api vertrekt, komt binnen met dat opzoekwerk er al in. Niet als bijlage en niet als link, maar als eerste blok in het gesprek zelf, in de taal waarin de klantendienst denkt. Wat daarna nog opgezocht moet worden, is het echte werk.

De tweede winst zit in de terugweg. Zolang de helpdesk een eiland is, weet het eigen scherm niet of er over deze bestelling al gesproken werd. Met de webhooks staat dat er wel, en dan kan een tweede melding over hetzelfde geval bij het bestaande gesprek terechtkomen in plaats van onderaan een nieuwe rij.

Wil jij je helpdesk aan je applicatie hangen

Draait je klantendienst op een gedeelde mailbox terwijl de gegevens in een eigen applicatie of webshop staan, dan is dit het patroon: de applicatie maakt het gesprek met het dossier erbij, en de helpdesk duwt terug wat er gezegd is. Stuur me gerust een mail als je wil weten wat dat voor jouw geval betekent.

Wat bij de klantendienst een bug blijkt, gaat langs naar Jira. De andere software waar ik al mee koppelde staat bij de koppelingen, en wat er als eigen applicatie uit groeide bij het portfolio.