AGENT LIST

Deze Help-pagina is bedoeld voor Studio. Deze informatie is ook beschikbaar voor Desktop Studio.

Icoon van een capsulevorm met GET erin.

Geeft alle agenten terug die zijn toegewezen aan de bedrijfseenheid Een organisatorische eenheid die wordt gebruikt om technische ondersteuning, facturering en globale instellingen voor uw CXone Mpower-omgeving te beheren, tenzij ze zich in een matrix bevinden met de profielinformatie van elke agent. Kan informatie over een specifieke agent retourneren door een agent-ID in te voeren in de eigenschap AgentID. De volgende velden worden geretourneerd in de variabele die is opgegeven in de parameter ListVar:

• BusinessUnitID	• UserName
• MiddleName	• Email
• TeamId	• ReportToId
• ReportToMiddleName	• IsSupervisor
• LastModified	• Custom1
• Custom3	• Custom5
• AgentID	• FirstName
• LastName	• IsActive
• TeamName	• ReportToFirstName
• ReportToLastName	• LastLogin
• Location	• Custom2
• Custom4	• InternalId

U kunt deze actie bijvoorbeeld gebruiken om te controleren of een bepaalde agent actief is, om het e-mailadres van de agent te vinden, om te kijken tot welk team de agent behoort en voor nog veel meer andere toepassingen. AgentList is een van de beschikbare API's die u kunt gebruiken binnen Studio. Framework-acties en machtigingen moeten voor uw bedrijfseenheid zijn ingeschakeld om deze actie te kunnen gebruiken.

Afhankelijkheden

Zorg er altijd voor dat de SetSecurityUser -actie voorafgaat aan deze actie en dat de uitvoervariabele van die actie overeenkomt met de invoervariabele SecurityUser van de eigenschappen van de Agent List-actie.
Dit is een API-actie, die zich in het palet API-acties bevindt.

Ondersteunde scripttypen


Generiek	E-mail	Chat	Telefoon	Voicemail	Werkitem	SMS

Invoereigenschappen

Deze eigenschappen definiëren gegevens die de actie gebruikt bij het uitvoeren.

Vertakking	Beschrijving
Add Caption	Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram.
Beveiligingsgebruiker	De uitvoerwaarde van de SetSecurityUser-actie die een geselecteerde agent authenticeert op basis van diens machtigingen in het beveiligingsprofiel. Dit veld accepteert variabelen die zijn opgemaakt met accolades ( { } ). De standaardwaarde is SecurityUser (zelfde standaard uitvoerwaarde van SetSecurityUser).
Agent-ID	De agent-ID. U kunt een variabele gebruiken voor dit veld, zoals {agentId}.Als deze optie leeg wordt gelaten, worden alle gebruikers die gekoppeld zijn met de tenant Een organisatorische eenheid die wordt gebruikt om technische ondersteuning, facturering en globale instellingen voor uw CXone Mpower-omgeving te beheren worden geretourneerd in een array. In de Waardemodus: Voer de agent-ID in of klik op de knop plus + of min - om een ID-nummer toe te voegen. In de Expressiemodus: Voer de agent-ID in.

Vertakking

Beschrijving

Add Caption

Voer een korte woordgroep in die deze actie in het script uniek identificeert. Het bijschrift verschijnt op het scriptcanvas onder het actiepictogram.

Beveiligingsgebruiker

De uitvoerwaarde van de SetSecurityUser-actie die een geselecteerde agent authenticeert op basis van diens machtigingen in het beveiligingsprofiel. Dit veld accepteert variabelen die zijn opgemaakt met accolades ( { } ). De standaardwaarde is SecurityUser (zelfde standaard uitvoerwaarde van SetSecurityUser).

Agent-ID

De agent-ID. U kunt een variabele gebruiken voor dit veld, zoals {agentId}.Als deze optie leeg wordt gelaten, worden alle gebruikers die gekoppeld zijn met de tenant Een organisatorische eenheid die wordt gebruikt om technische ondersteuning, facturering en globale instellingen voor uw CXone Mpower-omgeving te beheren worden geretourneerd in een array.

In de Waardemodus: Voer de agent-ID in of klik op de knop plus + of min - om een ID-nummer toe te voegen.

In de Expressiemodus: Voer de agent-ID in.

Uitvoereigenschappen

Deze eigenschappen bevatten variabelen die gegevens bevatten die worden geretourneerd na het uitvoeren van de actie. Ze zijn beschikbaar voor referentie en gebruik wanneer de actie wordt voltooid.

Vertakking	Beschrijving
ListVar	Bevat de geretourneerde data. De inhoud van deze variabele wordt opgeslagen in een array. De standaardwaarde is Agents, maar dit kan worden gewijzigd in elke gewenste waarde.

Resultaatvertakkingsvoorwaarden

Met Resultaatvertakkingsvoorwaarden kunt u vertakkingen maken in uw script om verschillende resultaten te behandelen wanneer de actie wordt uitgevoerd.

Voorwaarde	Beschrijving
Default	Het pad dat altijd wordt gevolgd, behalve als het script voldoet aan een voorwaarde die vereist dat het een van de andere vertakkingen volgt. Dit pad wordt ook gevolgd als de andere vertakkingen van de actie niet zijn gedefinieerd.
Geslaagd	Het pad dat wordt gevolgd als de actie zonder fouten is voltooid en eventuele API-aanroepen of geretourneerde gegevens succesvol waren (2xx responscodes).
InvalidAgentId	Het pad dat wordt gevolgd als de agent-ID ongeldig is.
InvalidSecurityUser	Het pad dat wordt gevolgd als een ongeldige beveiligingsgebruiker wordt gebruikt

Andere opties

Afhankelijk van de gegevens die u wilt verkrijgen, kunnen aanvullende API-acties nuttig zijn. Bijvoorbeeld,, All Agent Skill Assignments, Agent States V4, Get Agents List, Get Agent Details by Agent ID enz.