Een tool maken (bèta)

Bètafuncties. Het maken van volledig aangepaste tools van het begin af aan is in open bèta en beschikbaar voor alle Klantenserviceagent-accounts. Aanmelden is niet nodig. Je vindt de pagina Tools in Klantenserviceagent. De functies worden nog uitgebreid en kunnen veranderen.

Wat je leert

Hoe je Klantenserviceagent met een volledig aangepaste tool verbindt met een HTTP-eindpunt, een toolbeschrijving schrijft die Klantenserviceagent daadwerkelijk zal gebruiken, en je tool test voordat je deze aan een vaardigheid koppelt.

Voordat je van start gaat

Je hebt nodig:

• Klantenserviceagent ingeschakeld
• Een HTTP-eindpunt dat je wilt dat Klantenserviceagent belt — een eindpunt waarvoor geen geheime inloggegevens (API-sleutel, tokens, enz.) nodig zijn om vandaag toegang te krijgen (geverifieerd eindpunt binnenkort beschikbaar, zie waarschuwing hieronder)
• Een vaardigheid om de tool aan te koppelen: een vaardigheid waarmee Klantenserviceagent wordt geleverd of een volledig aangepaste vaardigheid die je hebt aangemaakt

Als je nog geen vaardigheid hebt ingesteld, maak er dan eerst een aan. Tools doen op zichzelf niets. Ze moeten gekoppeld zijn aan een vaardigheid.

Waarschuwing: Binnenkort komt er een veilige opslag voor API-sleutel en andere geheimen. Totdat het verzonden is, moet je geen API-sleutel, tokens of andere gevoelige inloggegevens in volledig aangepaste tools gebruiken. De configuratie van de tool is nog geen veilige plek om ze op te slaan. Gebruik voorlopig alleen tools met eindpunt die veilig zijn om te bellen zonder geheime autorisatie (zoals een intern eindpunt achter de positieve lijst van IP-adressen, of eindpunt dat niet-gevoelige identificatoren accepteert). Support voor geauthenticeerd eindpunt is onderweg.

Wat een volledig aangepaste tool is

Een volledig aangepaste tool is een HTTP-verzoek dat een Klantenserviceagent tijdens een gesprek kan doen. Het maken van volledig aangepaste tools is in open bèta en beschikbaar voor alle Klantenserviceagent-accounts. Gebruik er een als de tools waarmee Klantenserviceagent wordt geleverd niet bieden wat je nodig hebt, bijvoorbeeld een bestelling opzoeken in je eigen orderbeheersysteem in plaats van Shopify, de voorraad controleren in een aangepast magazijnsysteem of een ticket aanmaken in een helpdesk die Klaviyo niet heeft integreert niet met.

Zie het artikel Klantenserviceagent-tools begrijpen voor het onderliggende concept.

Wanneer maak je een volledig aangepaste tool?

Kies voor een volledig aangepaste tool als:

• Je hebt realtime gegevens nodig van een systeem waarmee Klaviyo nog niet integreert
• Je wilt dat de Klantenserviceagent een actie onderneemt in een extern systeem (een abonnement opzeggen in je eigen systeem, een ticket maken, een record bijwerken)
• Een bestaande tool past niet. Je gebruikt bijvoorbeeld een aangepaste OMS in plaats van Shopify voor bestellingen

Als de informatie niet vaak verandert en voor elke klant hetzelfde is, voeg deze dan als content toe. Tools zijn voor dynamische gegevens en acties per klant.

Instellen

1. Open de pagina Tools

Ga naar Klantenserviceagent > Tools en klik dan op Tool maken.

2. Geef en beschrijf de tool

• Naam — Een korte identificator, zoals 'Inventaris ophalen' of 'Retourticket maken'.
• Beschrijving — Natuurlijke taal die uitlegt wat de tool doet en wanneer je de tool moet gebruiken. Klantenserviceagent leest deze beschrijving om te beslissen of ze de tool voor een bepaald verzoek wilt gebruiken. Wees specifiek.

Een voorbeeld van een goede beschrijving:

Haalt realtime voorraadtellingen voor een bepaalde product-SKU op uit het magazijnsysteem. Gebruik deze optie wanneer een shopper vraagt of een specifiek product op voorraad is.

Voorbeeld van vage beschrijving (vermijden):

Krijgt productinfo.

3. Configureer het HTTP-verzoek

• Methode — GET, POST, PUT, DELETE of PATCH.
• URL — De volledige eindpunt-URL. Je kunt tijdelijke aanduidingen opnemen voor dynamische waarden (zie Stap 5).
• Headers – Alle headers die je eindpunt vereist, waaronder Content-Type en authenticatieheaders.

4. Configureer de tekst van de aanvraag (voor POST, PUT, PATCH)

Geef een JSON-tekst op. Gebruik tijdelijke aanduidingen voor waarden die klantenserviceagent tijdens runtime moet invullen.

Voorbeeldtekst:

{
"customer_id": "{{profile_id}}",
"sku": "{{product_sku}}"
}

5. Tijdelijke aanduidingen gebruiken voor dynamische waarden

Klantenserviceagent kan tijdens runtime waarden invullen met tijdelijke aanduidingen. Veelvoorkomende tijdelijke aanduidingen:

• {{profile_id}} – De Klaviyo-profiel-ID van de klant in het gesprek
• {{conversation_id}} – De huidige gespreks-ID
• Elke parameter die je definieert in je invoerschema (bijv. {{product_sku}}, {{order_id}})

Tijdelijke aanduidingen werken in de URL, kopteksten en tekst.

6. Verificatie

Ondersteuning voor geverifieerd Eindpunt is binnenkort beschikbaar. Gebruik tot die tijd geen API-sleutel, tokens of andere geheimen in een volledig aangepaste tool. Gebruik alleen eindpunt dat veilig kan bellen zonder geheime inloggegevens, bijvoorbeeld een intern eindpunt beschermd door IP-vermelding op de positieve lijst, of een openbaar eindpunt dat niet-gevoelige identificatoren accepteert.

Beveiligde geheime opslag is onderweg, en zal het geverifieerde eindpunt ontgrendelen.

7. Test de tool

Klik op Testtool. Geef voorbeeldwaarden voor alle invoerparameters. Controleer of:

• Het antwoord is teruggekomen
• Het antwoordformaat is wat de Klantenserviceagent verwacht
• Eventuele foutsituaties worden behandeld

8. Opslaan en aan een vaardigheid koppelen

Klik op Opslaan. Om Klantenserviceagent de tool daadwerkelijk te laten gebruiken, open je de vaardigheid die je wilt gebruiken en voeg je de tool daar toe.

Een goede toolbeschrijving schrijven

De beschrijving is het belangrijkste veld. Klantenserviceagent kiest welke tool hij gebruikt, volledig op basis van de beschrijving, niet op de naam. goede beschrijvingen:

• Vertel in één zin wat de tool doet
• Vertel wanneer het in één zin moet worden gebruikt
• Zijn specifiek over de geretourneerde gegevens of de ondernomen actie

Slechte beschrijvingen zijn vaag ('krijgt klantinfo'), te breed ('verhandelt alles wat met bestellingen te maken heeft'), of vertellen Klantenserviceagent hoe ze zich moeten gedragen in plaats van wat de tool doet.

Overwegingen bij de beveiliging

• Gebruik nog geen volledig aangepaste tools voor eindpunt waarvoor geheime inloggegevens nodig zijn. Ondersteuning voor geverifieerd Eindpunt is binnenkort beschikbaar. Gebruik, totdat het is verzonden, alleen eindpunt die veilig zijn om te bellen zonder geheime autorisatie.
• Gebruik waar mogelijk plaatsing op de positieve lijst met IP-adressen. Als je eindpunt intern is, beperk dan de toegang tot IP-bereiken van Klaviyo in plaats van te vertrouwen op geheimen.
• Let op welke data je verzendt. Klantenserviceagent geeft klantgegevens door aan de tool op basis van wat de vaardigheidsinstructies zeggen. Bekijk welke velden je eindpunt ontvangt.
• Tarievenlimieten. Als je eindpunt frequentielimieten heeft, zorg er dan voor dat deze hoog genoeg zijn om je verwachte gespreksvolume aan te kunnen.

Probleemoplossing

Symptoom: Klantenserviceagent gebruikt de tool nooit.
Waarschijnlijke oorzaak: de beschrijving is te vaag of de tool is niet gekoppeld aan de vaardigheid die hem zou gebruiken.
Oplossing: herschrijf de beschrijving om specifiek te beschrijven wanneer deze gebruikt moet worden. Controleer of de tool in de lijst met tools van de vaardigheid verschijnt.

Symptoom: de tool retourneert een fout tijdens het testen.
Waarschijnlijke oorzaak: verkeerde URL, misvormde tekst of een payload die je eindpunt niet accepteert.
Oplossing: gebruik de testtoolfuncties om de onbewerkte aanvraag en het onbewerkte antwoord te controleren. Verifieer het formaat van de URL en de tekst ten opzichte van de verwachte invoer van je eindpunt.

Probleem: Klantenserviceagent gebruikt de tool maar geeft verkeerde parameters door.
Waarschijnlijke oorzaak: de namen van de tijdelijke aanduidingen komen niet overeen met het schema, of de instructies van de vaardigheid zijn onduidelijk over wat je moet doorgeven.
Oplossing: Controleer of namen van tijdelijke aanduidingen precies overeenkomen. Werk de instructies van je vaardigheid bij om expliciet te zijn over wanneer je de tool gebruikt en welke parameters je moet opgeven.

Symptoom: de tool is traag, waardoor vertragingen in de reacties worden veroorzaakt.
Waarschijnlijke oorzaak: eindpuntlatentie.
Oplossing: Optimaliseer je eindpunt. Controleer of je resultaten aan jouw kant in de cache kunt opslaan.

Veelgestelde vragen

Kan één tool door meerdere vaardigheden worden gebruikt?
Ja. Eenmaal gemaakt, kan een tool aan een willekeurig aantal vaardigheden worden gekoppeld.

Welke autorisatiemethoden worden ondersteund?
Ondersteuning voor geverifieerd Eindpunt is binnenkort beschikbaar. Gebruik voorlopig eindpunt waarvoor geen geheime inloggegevens nodig zijn (intern eindpunt met IP-lijst, of openbaar eindpunt met niet-gevoelige identificatoren).

Wat gebeurt er als mijn eindpunt down is of als er een fout optreedt?
Foutafhandeling voor volledig aangepaste tools is nog niet ontwikkeld. Als je eindpunt uitvalt, kan Klantenserviceagent een beperkte of verwarrende reactie geven. Totdat de foutafhandeling wordt verzonden, gebruik je alleen eindpunt waar je vertrouwen in hebt — en houd het gedrag van tools nauwkeurig in de gaten.

Kan ik een tool bewerken nadat ik deze heb gemaakt?
Ja. Je kunt de naam, beschrijving, configuratie en bijgevoegde vaardigheden op elk moment bewerken.

Kan ik een versie van een tool aanpassen?
Versiebeheer wordt nog niet ondersteund. Bewerkingen van een tool zijn onmiddellijk van kracht voor elke vaardigheid die de tool gebruikt.

Additional resources