Zapier
Start een Zap bij een nieuwe lead of een nieuw ticket, een gewijzigd ticket, een beëindigd gesprek of een antwoord, en laat een Zap je agent iets vragen, iets leren of met een ticket aan de slag gaan.
De Zapier-integratie van ChatterLab start een Zap wanneer er iets gebeurt in je werkruimte: een bezoeker laat zijn contactgegevens achter of opent een ticket, een ticket verandert, een gesprek eindigt, of je agent antwoordt. De lead, het ticket, het gesprek of het antwoord kan dan verder naar een CRM, een spreadsheet, de chat van je team of elke andere app die Zapier koppelt. Een Zap kan ook iets doen in ChatterLab: je agent een vraag stellen, hem iets leren, of de status van een ticket zetten en er een notitie bij zetten. Ze hoort bij Studio en hoger: ze koppelt met een API-sleutel en werkt via webhooks.
Opmerking. De integratie staat nog niet in de app-gids van Zapier. Je voegt ze aan je Zapier-account toe via onze uitnodigingslink, en ze werkt op dezelfde manier.
Ze toevoegen aan Zapier
- Open onze uitnodigingslink terwijl je bij Zapier bent aangemeld, en aanvaard de uitnodiging. ChatterLab staat dan tussen de apps die je in de Zap-editor kunt kiezen.
- Maak er in ChatterLab een sleutel voor: druk in Werkruimte-instellingen, onder Ontwikkelaars, op de kaart API-sleutels, op Nieuwe sleutel en kies bij Wat hij mag voor Beheren. Een Zap aanzetten voegt een webhook toe, en dat kan alleen een sleutel die mag beheren.
Een Zap maken
- Maak in Zapier een Zap en kies ChatterLab als trigger, met een van de events onder De triggers.
- Koppel je account met de sleutel. Met een sleutel voor de hele werkruimte noemt Zapier de koppeling naar je werkruimte.
- Kies bij Agent de agent wiens events de Zap moeten starten. Laat je het leeg, dan doen die van elke agent dat, ook van agents die je later toevoegt.
- Test de trigger. Zapier toont tot drie recente voorbeelden van de agent die je koos, of van de oudste agent van je werkruimte als je er geen koos. Het zijn echte, met wat bezoekers schreven, behalve bij Ticket Updated, dat een verzonnen ticket toont: wat er veranderde en hoe, wordt pas verteld wanneer het gebeurt.
- Voeg de stappen toe die moeten volgen en zet de Zap aan. Op de kaart Webhooks in Werkruimte-instellingen, Ontwikkelaars, verschijnt een webhook naar hooks.zapier.com.
De triggers
| Trigger | Start de Zap wanneer | De Zap krijgt |
|---|---|---|
| New Lead | Een bezoeker gegevens achterlaat in het formulier van de chat | De lead |
| New Ticket | Een bezoeker een vraag aan je team doorgeeft, of een mail aan de agent een ticket wordt | Het ticket |
| Ticket Updated | De status van een ticket verandert, je team antwoordt, er een notitie bij komt of de bezoeker per e-mail antwoordt | Het ticket, met wat er veranderde en langs welke weg |
| Conversation Ended | Een gesprek 30 minuten stil is | Het gesprek, met alle berichten |
| New Answer | Een bezoeker een antwoord krijgt, in de chat, per e-mail of via WhatsApp | Het antwoord, met de vraag van de bezoeker |
| Weak Answer | Een antwoord als zwak telt, zoals in het Overzicht | Het antwoord en de vraag, met waarom het zwak is |
Elke trigger krijgt wat de bijbehorende webhook verstuurt, in de vorm waarin de API het teruggeeft. De gebeurtenissen op de pagina over webhooks zeggen precies wanneer elk verstuurd wordt en wat erin staat.
- Conversation Ended komt opnieuw, in zijn geheel, telkens de bezoeker terugkomt en het gesprek weer stil wordt. Bewaar het onder zijn Conversation ID en vervang wat je had. Gesprekken in de Testomgeving of via de API starten het nooit, en ook geen gesprek waarin de bezoeker alleen maar groette.
- New Answer start de Zap één keer voor elk antwoord, en elke run is een taak in je Zapier-abonnement: een drukke agent kan er honderden per dag gebruiken. Antwoorden in de Testomgeving of via de API starten het nooit.
- Weak Answer volgt de regel van het Overzicht, dus ook antwoorden via de API tellen mee. De test toont de zwakste antwoorden van de agent van de laatste 30 dagen, niet de recentste.
- Ticket Updated heeft een schakelaar, Include changes made with an API key, die uit staat. Zie Lussen.
De acties
| Actie | Wat ze doet |
|---|---|
| Ask Agent | Stelt de agent een vraag en geeft zijn antwoord terug, met de betrouwbaarheid, de onderbouwing en de bronnen waarop het steunt |
| Add Text Source | Voegt een tekst met een titel toe aan wat de agent weet |
| Add Q&A Source | Voegt een vraag met haar antwoord toe, tot 500 en 10.000 tekens |
| Set Ticket Status | Zet een ticket op open, wachtend op de klant of opgelost. De bezoeker krijgt geen mail |
| Add Ticket Note | Voegt een notitie van tot 10.000 tekens toe, die alleen je team ziet. De bezoeker krijgt geen mail |
Elke actie vraagt naar de agent. De acties voor tickets tonen de tickets van die agent, met de laatste activiteit eerst, of nemen een Ticket ID uit een eerdere stap. Een trigger die elke agent volgt, vertelt de actie niet om welke agent het ging, dus een Zap die iets doet met het ticket van een trigger, heeft in beide dezelfde agent nodig.
- Ask Agent is een vraag zoals elke andere: ze kost credits zoals een vraag in de chat, en dat geldt ook voor het testen van de stap in de Zap-editor, die de agent echt iets vraagt. Ze staat in Activiteit als een gesprek via de API. Wil je een gesprek voortzetten, geef dan de Conversation ID van een eerdere Ask Agent-stap mee.
- Add Text Source en Add Q&A Source blijven in afwachting tot de agent ze geleerd heeft, wat seconden tot een minuut duurt. Een tekst die de agent boven de opslag van zijn abonnement zou brengen, wordt geweigerd.
- Een ticket de status geven die het al heeft, verandert niets.
Lussen
Een Zap die op zijn eigen trigger reageert, kan zichzelf opnieuw starten, en nog eens, en kost elke keer taken en credits.
- Een wijziging met een API-sleutel is de manier waarop Zapier een ticket wijzigt, dus Ticket Updated slaat zulke wijzigingen over, tenzij je Include changes made with an API key aanzet. Laat het uit voor een Zap die bij bijgewerkte tickets een notitie toevoegt of een status zet.
- Zwakke antwoorden op vragen met een API-sleutel worden verstuurd, zoals het Overzicht ze telt, dus Weak Answer slaat ze over, tenzij je Include answers to questions asked with an API key aanzet. Laat het uit voor een Zap die de agent bij een zwak antwoord opnieuw iets vraagt: de agent antwoordt dan waarschijnlijk weer zwak.
- Ask Agent start nooit New Answer of Conversation Ended: het gesprek waarin Ask Agent vraagt, is altijd een gesprek dat via de API begon. Krijgt Ask Agent de Conversation ID van een gesprek van een bezoeker, uit New Answer of Conversation Ended, dan begint het een nieuw gesprek in plaats van het hunne voort te zetten.
Let op. Zet een Zap in Zapier uit zodra je ziet dat hij vaker loopt dan bezoekers schrijven. Hoeveel, en lussen op de pagina over webhooks zegt er meer over.
Wat er daarna gebeurt
- Elk event start de Zap binnen enkele seconden. Conversation Ended kan een paar minuten na de 30 stille minuten komen, omdat we om de paar minuten kijken.
- Zapier controleert dat elke levering door ChatterLab ondertekend is, en negeert een levering die dat niet is.
- Af en toe start één event de Zap twee keer, bijvoorbeeld wanneer Zapier er langer dan 5 seconden over deed om te antwoorden. De Lead ID, Ticket ID, Conversation ID of Answer Message ID is dan beide keren dezelfde.
- Een Zap uitzetten verwijdert zijn webhook. Elke Zap die aanstaat, neemt een van de 25 webhooks van de werkruimte in, samen met de webhooks die je zelf toevoegt.
- Een sleutel verwijderen stopt geen Zap die aanstaat: zijn webhook blijft versturen, en een levering heeft geen sleutel nodig. Zet de Zap eerst uit, of verwijder zijn webhook op de kaart Webhooks. Zapier vraagt je opnieuw te koppelen zodra het de sleutel nodig heeft, bijvoorbeeld wanneer je de trigger test, een actie uitvoert of de Zap uitzet.
- Zapier, een bedrijf in de Verenigde Staten, krijgt wat je Zap meekrijgt: met Conversation Ended, New Answer en Weak Answer ook wat bezoekers schreven. Eenmaal daar is het aan jouw zorg toevertrouwd, onder de voorwaarden van Zapier.