API-acties

De informatie op deze helppagina is zowel van toepassing op Studio als op Desktop Studio.

API-acties zijn Studio acties waarmee u CXone Mpower API's in uw scripts kunt gebruiken. U kunt de actie gebruiken in plaats van de API op te roepen met de traditionele integratiemethoden, zoals het gebruik van een fragment of de RestAPI -actie. API-acties bevinden zich allemaal op het tabblad Framework in Desktop Studio. In Studio bevinden ze zich in het API-actiespalet.

De API-acties verschillen van de standaard Studio-acties. Ze zin momenteel niet gedocumenteerd in de online help. De API's die overeenkomen met de API-acties, zijn echter wel gedocumenteerd in de CXone Mpower developer portal Een vierkant met een pijl die uit het midden naar de rechterbovenhoek wijst.. U kunt deze documentatie gebruiken wanneer u werkt met API-acties in uw scripts.

Niet elke CXone Mpower API heeft een overeenkomende API-actie in Studio.

Stel de beveiligingsgebruiker in uw script in

Voor alle API-acties en veel Framework-acties is een beveiligingsgebruiker vereist om goed te kunnen functioneren. Een beveiligingsgebruiker is een CXone Mpower-werknemersprofiel met machtigingen die toegang tot en interactie met CXone Mpower toestaan. Bij gebruik in een script, geeft de beveiligingsgebruiker de Framework- of API-actie toegang tot CXone Mpower. Dit moet een specifieke account zijn die alleen voor dit doel wordt gebruikt. U moet een geldig, actief CXone Mpower-medewerkersprofiel gebruiken.

De beveiligingsgebruiker heeft machtigingen nodig om toegang te verlenen en de nodige acties uit te voeren in CXone Mpower. Er is geen ingestelde lijst van machtigingen omdat de vereisten verschillen afhankelijk van de acties die worden gebruikt.

  1. Maak een CXone Mpower medewerkersprofiel. Voor deze gebruiker:
    • Geef een naam die deze identificeert als een beveiligingsgebruiker.
    • Stel Inlogauthenticator op het tabblad Beveiliging van pagina Nieuwe medewerker maken van Niets geselecteerd. Als er geen inlogauthenticator is, betekent dit dat deze account niet kan worden gebruikt om aan te melden bij CXone Mpower. Dit is in orde omdat u niet hoeft aan te melden met de account. Dit wordt alleen gebruikt om toegang te bieden via Studio-scripts.
    • Wijs deze een rol toe met de geschikte machtigingen. De beste praktijk is het maken van een rol die specifiek is voor de beveiligingsgebruiker.
    • Nadat u het nieuwe werknemersprofiel hebt opgeslagen, gaat u naar ACD > ACD-gebruikers en zoet u het nieuwe profiel. Noteer het nummer in de id-kolom. Dit is de agent-ID van de gebruiker. U kunt deze gebruiken om de gebruiker te zoeken wanneer u uw script configureert.
  2. In uw Studio-script, voegt u een SetSecurityUser -actie toe. Deze actie bevindt zich op het tabblad Framework in Desktop Studio en het tabblad API-acties in Studio. Plaats de actie voor elke ander Framework- of API-acties. In Studio bevindt de SetSecurityUser -actie zich in het palet API-acties.
  3. In de eigenschap Agent in SetSecurityUser, voert u de naam of agent-ID van de beveiligingsgebruiker in. Selecteer dan de passende record. U kunt een variabele vervanging gebruiken in dit veld als u meer dan een beveiligingsgebruiker gebruikt.
  4. Laat de uitvoervariabele als de standaard SecurityUser. Dit is gedefinieerd in de eigenschap ScriptVar (out) (in StudioScriptvariabele). Als u deze wijzigt, moet u elk framework of elke API-actie in het script configureren met de nieuwe variabele. Er zijn verschillende namen voor de eigenschap die de variabele bevat, afhankelijk van het gebruikte Framework of API-actie. Security User en AuthContext zijn twee gebruikelijke.

API-actieversies

Wanneer nieuwe versies van CXone Mpower API's worden uitgegeven, kunnen nieuwe versies van de overeenkomende acties worden uitgegeven in Studio. Het is doorgaans het beste om de nieuwste versie van de actie te gebruiken. Oudere versies werken nog steeds in de meeste gevallen. U kunt de verschillende versies proberen om te zien welke werken en de benodigde functionaliteit bieden.

Sommige API-acties hebben de versie in de actienaam. U kunt dit zien wanneer u kijkt naar de boomstructuur van acties op het tabblad Framework. Niet alle API-acties bevatten het versienummer. Voor deze acties kunt u de versie vinden in de uitgebreide eigenschappen van de actie. U kunt de uitgebreide eigenschappen alleen zien in het tabblad Eigenschappen wanneer de actie is geselecteerd in het tabblad Framework.

Niet elke versie van elke API heeft een overeenkomende actie in Studio.

Uitgebreide eigenschappen van de API-actie weergeven

Deze taak kan alleen worden voltooid in Desktop Studio.

  1. Schik in Studio de tabbladen opnieuw zodat u het tabblad Eigenschappen en het tabblad Framework tegelijk kunt zien.
  2. Klik op het tabblad Framework op een API-actie.
  3. Op het tabblad Eigenschappen kunt u nu de uitgebreide eigenschappen van de actie zien. De volgende eigenschappen zijn in het bijzonder handig wanneer u leert over een API-actie: 
    • Diversen > Parameters > Werkwoord: deze eigenschap toont u de methode of het werkwoord, gekoppeld met de actie.
    • Diversen > Parameters > Versie: deze eigenschap toont u de versie van de API.
    • Diversen > Web > URI: deze eigenschap kan handig zijn wanneer u de API-documentatie in het developer portal zoekt.
    • Diversen > Parameters: in de sectie Parameters kunt u de eigenschappen uitvouwen om meer informatie te zien over elk van de eigenschappen van de actie.

API-documentatie zoeken

Deze taak kan alleen worden voltooid met Desktop Studio.

CXone Mpower API's zijn gedocumenteerd in de CXone Mpower Developer Portal. API acties in Studio hebben geen directe koppeling met de documentatie die overeenkomt met hun API's. U kunt deze informatie die beschikbaar is in de uitgebreide eigenschappen, echter gebruiken om de documentatie te zoeken.

Het gebruik van de URI vereist een algemene kennis van het CXone Mpower-systeem als een geheel en van de verschillende CXone Mpower API's. Dit is omdat het niet altijd zo eenvoudig is om vast te stellen welke API overeenkomt met een actie in Studio Als u de algemene flow van een contact kent via CXone Mpower, helpt dit u om de URI van een actie correct te interpreteren en de daar gevonden sleutels toe te passen op de structuur van de API-documentatie in het Developers Portal. De voorbeelden in deze sectie tonen de interpretatie die kan vereist zijn.

De startpagina van de API-sectie van de developer portal biedt een overzicht van elke CXone Mpower API.

Voorbeeld 1

Er is soms een duidelijke correlatie tussen een actie en de API ervan:

Op basis van de naam en URI van de actie, zijn de eerste twee API's die moeten worden overwogen, de Agent API en de Admin API. Door te kijken naar de lijst van API-oproepen voor elke agent, kunt u de Agent API elimineren. De beschrijving ervan geeft aan dat deze wordt gebruikt voor het beheren van agentsessies en verschijnt niet om oproepen te hebben die verwant zijn met skills, zoals weergegeven in de volgende afbeelding.

De Admin API geeft aan dat deze werkt met systeemobjecten zoals skills. De lijst van beschikbare API-oproepen voor deze API omvat skills, zoals weergegeven in de volgende afbeelding.

Wanneer u de sectie Skills uitvouwt, is een van de eindpunten GET /skills/agents. De kleine beschrijving voor dit eindpunt zegt dat het "Toewijzingen van skills retourneert".

Voorbeeld 2

De correlatie is soms niet voor de hand liggend, zoals weergegeven in het volgende voorbeeld. In dergelijke gevallen moet u uw kennis van CXone Mpower API's en het platform zelf toepassen om het overeenkomende API-eindpunt te zoeken. -

Op basis van de naam en URI van de actie, is het niet meteen duidelijk welke API u eerst moet bekijken. Als u niet zeker bent waar u wilt starten, kunt u de documentatie bekijken voor elke API en elke sectie die betrekking heeft met contacten, onderzoeken. De Admin API is de enige met een contactsectie op topniveau. Deze API bevat echter helaas geen eindpunten die betrekking hebben op actieve contacten.

Op dit punt kunt u het woord actief invoeren in de actienaam en de URI. Op basis van uw kennis van CXone Mpower, weet u dat actief wijst op contacten die momenteel worden afgehandeld. Hierdoor gaat u Realtime data-API van dichterbij gaan bekijken. Deze API heeft slechts één sectie en wanneer u deze uitvouwt, ziet u dat een van de eindpunten GET /contacts/active is. De kleine beschrijving voor dit eindpunt zegt dat het "Actieve contacten retourneert".