Talkdesk
Voordat je begint
Vereisten
-
Je moet toegang hebben tot Talkdesk's Developer Portal en ServiceNow omgeving om deze integratie te configureren.
-
Daarnaast, om ervoor te zorgen dat Plecto je gegevens ontvangt, moet je scopes in Talkdesk definiëren voordat je het verbindt met Plecto. Lees meer over scopes in Talkdesk's ontwikkelaarsdocumentatie.
Stap 1: Voeg scopes toe in Talkdesk Developer Portal
Een scope beperkt de eindpunten waartoe een client toegang heeft. Het bepaalt ook of een client lees- of schrijfrechten heeft op een eindpunt. Onze integratie met Talkdesk vereist dat je scopes toevoegt in Talkdesk's Developer Portal voordat je je Talkdesk-account kunt verbinden met Plecto.
-
Ga naar de Talkdesk Developer Portal en log in.
-
Navigeer naar het tabblad OAuth Clients. Hier zou je de naam van je bedrijf moeten zien.
-
Klik om het clientprofiel van je bedrijf te bewerken en voeg scopes toe. Hier is een lijst van scopes die aan elk van de gegevenstypen moeten worden toegevoegd. Vind Talkdesk's documentatie over scopes hier.
-
Calls: Dit gegevenstype wordt opgehaald van de Explore API en vereist de volgende scopes:
data-reports:writedata-reports:read -
User Status: Dit gegevenstype wordt opgehaald van de Explore API en vereist de volgende scopes:
data-reports:writedata-reports:read -
Real-time Metrics: Dit gegevenstype wordt opgehaald van de Live API en heeft de volgende scopes nodig:
live-queries:readlive-subscriptions:readlive-subscriptions:write
-
Nieuwe OAuth Client. Als je je clientprofiel niet op de lijst ziet, kun je een nieuwe OAuth Client in Talkdesk aanmaken en scopes toevoegen in het proces.
Redirect URI. Als je gevraagd wordt om een Redirect URI op te geven, kun je het volgende toevoegen: https://app.plecto.com/admin/data-sources/talkdesk/oauth/callback/
Stap 2: Verkrijg je Talkdesk-gegevens van ServiceNow
Wat heb ik nodig?
-
Client ID
-
Client Secret
Je kunt de Client ID en Client Secret verkrijgen uit je ServiceNow-omgeving:
-
Log in op ServiceNow en navigeer naar System OAuth > Application Registry > Talkdesk.
-
Klik op het woord "hier" in het infobericht bovenaan de pagina. Het bericht is vergelijkbaar met het volgende: "Dit record bevindt zich in de Talkdesk-applicatie, maar [Naam] is de huidige applicatie. Om dit record te bewerken, klik hier."
-
Je kunt nu zowel de Client ID als de Client Secret onder de applicatienaam zien. Om de Client Secret te kopiëren, klik je op het hangslotpictogram ernaast.
-
Je moet deze inloggegevens gebruiken om Talkdesk met Plecto te integreren.
Stap 3: Maak Talkdesk-gegevensbronnen in Plecto
-
Ga naar Gegevensbronnen > Nieuwe gegevensbron > Talkdesk.
-
Je wordt gevraagd om de volgende gegevens op te geven:
-
Client ID en Client Secret: Kopieer de informatie uit je ServiceNow-omgeving.
-
Domein: Geef het volledige domein op, bijvoorbeeld:
examplecompany.talkdeskid.comJe kunt het vinden in de URL wanneer je bent ingelogd op Talkdesk. -
Tijdzone
-
-
Klik op Volgende om door te gaan.
-
Selecteer de gegevens die je wilt importeren.
-
Configureer je gegevensbroninstellingen. Hier kun je de titel wijzigen, de standaarddatum kiezen, selecteren welke velden je wilt importeren, en meer.
-
Klik op Volgende om te kiezen hoeveel gegevens je wilt importeren en hoe lang je deze in de gegevensbron wilt bewaren.
-
Klik op Importeren om te voltooien.
Beschikbare gegevens
We bieden drie gegevenstypen die je kunt importeren van Talkdesk naar Plecto. Voor elk gegevenstype dat je toevoegt, zal Plecto één gegevensbron creëren.
Hier zijn alle gegevenstypen die je momenteel van Talkdesk naar Plecto kunt importeren:
Updatefrequentie: 2m
Ondersteunt aangepaste velden? Nee
Ondersteunt webhooks? Nee
Ondersteunt automatische registratieverwijdering? Nee
Ondersteunt relaties? Nee
Updatefrequentie: 5m
Ondersteunt aangepaste velden? Nee
Ondersteunt webhooks? Nee
Ondersteunt automatische registratieverwijdering? Nee
Ondersteunt relaties? Nee
Updatefrequentie: 5m
Ondersteunt aangepaste velden? Nee
Ondersteunt webhooks? Nee
Ondersteunt automatische registratieverwijdering? Nee
Ondersteunt relaties? Nee
Dit gegevenstype stelt je in staat om kant-en-klare KPI's op Plecto-dashboards rechtstreeks vanuit TalkDesk te streamen via Live API.
Updatefrequentie: Direct met webhooks
Ondersteunt aangepaste velden? Nee
Ondersteunt webhooks? Ja
Ondersteunt automatische registratieverwijdering? Nee
Ondersteunt relaties? Nee
Updatefrequentie: 5m
Ondersteunt aangepaste velden? Nee
Ondersteunt webhooks? Nee
Ondersteunt automatische registratieverwijdering? Nee
Ondersteunt relaties? Nee
Streaming gegevens: Talkdesk Realtime Metrics
Je kunt de live status van werknemers op je tabelwidgets op dashboards weergeven. De status komt van een streaming gegevensbron, dus deze wordt elke paar seconden bijgewerkt.
Voeg de werknemerstatus voor Talkdesk toe aan je tabelwidgets:
-
Zorg ervoor dat je de Realtime Metrics-gegevensbron met Plecto hebt geïntegreerd.
-
Zoek in de gegevensbroninstellingen een Dimensie-veld en selecteer Live Employee Status. Sla de gegevensbroninstellingen op.
-
Voeg op je dashboard een nieuwe tabelwidget toe of gebruik een bestaande. Als je een nieuwe widget maakt, sla deze dan eerst op en bewerk deze vervolgens opnieuw (na het opslaan verschijnt er een nieuwe optie genaamd Toon werknemerstatus).
-
Voeg nu een kolom en een van je Talkdesk-formules toe, bijvoorbeeld, Aantal Talkdesk Calls. Dit zal ervoor zorgen dat sommige werknemers op je tabelwidget verschijnen en deze klaar is voor streaming.
-
Controleer ten slotte het vakje Toon werknemerstatus en sla de widget op. Plecto zal beginnen met het ophalen van gegevens uit je Talkdesk-streaminggegevensbron. Je krijgt twee nieuwe kolommen: Status en Tijd in Status.
Opmerking! Plecto zal alleen de streamingstatus van werknemers die in de tabelwidget worden weergegeven, bijwerken.