Workflow Execute

Déclenche un workflow CRM systèmes tiers qui gèrent des éléments tels que les contacts, les informations de vente, les détails de soutien et les historiques de cas. lorsqu'il est déclenché par un agent dans une NiCE CXone Agent Workspace (Agent)application. Workflows include things such as displaying data about a contact or creating a ticket. Other actions used in the script send the results and relevant data to the agent application when the agent answers the call. The other actions also pass any necessary information back to the CRM when the call completes. You can define a music file or other audio sequence to play for the contact while the script executes the workflow. This action is located on the Framework tab in Studio.

Dépendances

• Before you can configure this action, you must set up a CRM systèmes tiers qui gèrent des éléments tels que les contacts, les informations de vente, les détails de soutien et les historiques de cas. configuration in Agent Integrations in NiCE CXone. You can integrate CRMs with Agent Workspace (Agent), Agent Workspace (Embedded) (Agent Embedded), Agent Workspace for Microsoft Teams (Agent for Microsoft Teams), and Agent Workspace (Browser Extension) (Agent Integrated).
• You must use a separate Workflow Execute action for each workflow you want to use in your script. You can include more than one Workflow Execute action in your script.
• To use the configuration wizard in this action, you must be logged in to NiCE CXone or log in to Studio using the Login button with your NiCE CXone user name and password. If you log in with the Login with Session ID button when you are not logged in to NiCE CXone, the wizard will not appear. This is because access to the wizard depends on Global Authentication, which is only used when you log in with your NiCE CXone user name and password.
• This action must be used with the Agent Workflow Configuration action. It can only be used in CRM integration scripts.
• The Studio Framework tab must be enabled for your NiCE CXone tenant. Contact your account representative for more information.

Types de scripts pris en charge

	``` ```
Téléphone	Digital

Propriétés d'entrée

Ces propriétés définissent les données que l'action utilise lors de son exécution.

Propriété	Description
Caption	Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action. La valeur par défaut est le nom de l’action.
configurationId	L'ID de configuration du CRM que vous utilisez. Ce champ est renseigné automatiquement par l'assistant de configuration de l'action. Si vous utilisez une variable dans ce champ, formatez-la avec des accolades ( { } ). Par exemple, {integrationConfigId}.
Phrase	Utilisez cette propriété pour documenter le texte que contient l’invite. Le script n’utilise pas le texte dans cette propriété. Étant donné que certaines invites peuvent être complexes et contenir plusieurs segments, il peut être utile d’inclure le texte écrit sans le formatage requis par la propriété Sequence.
Sequence	Définissez l'invite que l'action joue. Un prompt peut être un fichier audio WAV préenregistré ou une synthèse vocale Permet aux utilisateurs d’entrer des invites enregistrées sous forme de texte et d’utiliser une voix générée par ordinateur pour prononcer le contenu. (TTS). Si l'invite est un fichier audio, saisissez le nom du fichier entre guillemets doubles. Par exemple, "salutation.wav". Si le fichier audio se trouve dans un dossier différent, indiquez le chemin d'accès au fichier. Par exemple, si le script se trouve dans le dossier racine et le fichier audio dans un sous-dossier de sous-dossier, entrez "Sous-dossier\Sous-dossier2\Fichier-audio.wav". Si le script se trouve dans un sous-dossier à un niveau en dessous de la racine et que le fichier audio se trouve dans un autre sous-dossier au même niveau, entrez "\..\Sous-dossier\Fichier-audio.wav ». Si le Prompt est de type synthèse vocale, entrez le texte que vous souhaitez que le service TTS Permet aux utilisateurs d’entrer des invites enregistrées sous forme de texte et d’utiliser une voix générée par ordinateur pour prononcer le contenu. lise. Chaque segment doit être placé entre guillemets doubles et inclure un caractère de référence de chaîne de caractères pour identifier le type d'information dont il s'agit. Par exemple : "%Le solde de votre compte est""silence.wav" "${accountBalance}" Pour plus d'informations sur le formatage des invites dans cette propriété, y compris les caractères de préfixe de référence de chaîne à utiliser, consultez la page Invites. Certaines actions disposant de la propriété Séquence ont accès à l'éditeur de séquence, qui est une interface graphique permettant de créer des invites. Cette action n'a pas accès à cet éditeur. Toutefois, vous pouvez utiliser l'éditeur de séquence à partir d'une action qui le prend en charge, comme Play. Ajoutez Play à votre script et créez votre séquence des invites. Collez le texte de la séquence du champ séquence dans Play dans cette action, puis supprimez Play. Remarque : la durée de l’invite dans cette propriété doit être de 60 secondes ou plus. Cela permet d'éviter que le contact n'entende un silence si la séquence se termine mais que le flux de travail n'a pas terminé son exécution. L’exécution du flux de travail peut ne pas prendre beaucoup de temps, mais des retards peuvent survenir. La lecture d'une invite est facultative pour cette action.
workflowId	L'ID du flux de travail que cette action gère. Ce champ est renseigné automatiquement par l'assistant de configuration de l'action. Si vous utilisez une variable dans ce champ, formatez-la avec des accolades ( { } ). Par exemple, {searchWorkflowId}.
workflowPayload	Saisissez le nom de la variable qui contient la charge utile de flux de travail que cette action traite. Ceci est déclaré dans la dernière ligne de la charge utile SNIPPET précédente. Placez le nom dans des accolades { }. La charge utilise doit être convertie en JSON. Dans les scripts du modèle d’intégration CRM, ce champ est défini sur {searchJson} car Snippet for Search Workflow Snippet déclare la variable searchJson avec la valeur {searchInput.asjson()}.
dynamicDataMappingId	The ID of the dynamic data mapping to display in the customer card when this workflow is executed.
actionType	Les flux de Travail pour le type d’action sélectionné dans l’assistant WORKFLOW EXECUTE.

Propriétés de sortie

Ces propriétés contiennent des variables qui stockent les données renvoyées par l'exécution de l'action. Elles sont disponibles à des fins de référence et d’utilisation lorsque l'action est terminée.

Condition	Description
errorArgs (out)	Enter the name of the variable to hold information about the error. The default variable is workflowErrorOutput. You don't need to format the variable name with curly braces.
resultSet (out)	Enter the name of the variable that you want to hold the result of the specified workflow. The default variable is workflowResultOutput. This field does not require curly brackets.
cacheKey (out)	La variable qui contient les résultats de la recherche. Les résultats sont stockés dans un Elasticache.

Conditions de branche résultantes

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition	Description
Default	Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
Success	Chemin emprunté si l’action se termine sans erreur et si tous les appels d’API ou retours de données ont abouti (codes de réponse 2xx).
Timeout	Le chemin emprunté lorsque l'exécution du workflow dépasse la valeur de dépassement DE délai spécifiée dans la saisie. Si vous souhaitez que ce workflow ait un délai d'expiration, vous devez ajouter la variable timeoutMilliSec = "[number of milliseconds" à l'extrait de code d'entrée du workflow et la définir sur un nombre égal ou supérieur à 6 000 ms (60 secondes).
ValidationError	Le chemin emprunté lorsqu’une entrée ne peut pas être validée. Cela inclut : Id des paramètres : doit être un id des paramètres valide provenant de la page Intégrations d’agents > Configurations dans NiCE CXone. ID du workflow : doit être un ID de workflow valide provenant de la page Intégrations d’agents > Configurations dans NiCE CXone. Charge utile de flux de travail : doit être une chaîne JSON valide.
InvalidWorkflow	Le chemin emprunté lorsque le flux de travail spécifié n’est pas valide.
InternalError	Le chemin à emprunter lorsque l’action rencontre une erreur.
NotConfigured	Le chemin emprunté si des Intégrations d’agents ne sont pas activées pour votre locataire Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone.. Contactez votre représentant de compte pour faire activer la fonctionnalité.

Code d'action SNIPPET requis

Cette action nécessite des Snippet actions avec un code personnalisé. Des informations sur les snippets requis sont disponibles dans l’aide en ligne pour l’intégration de votre CRM avec une application Agent Workspace (Agent).

Sélection d’actions et de flux de travail

1. Double-cliquez sur l’ Workflow Execute action dans votre script pour lancer l’assistant Custom CRM Configurations.

   Voir l'image

   
2. Sélectionnez la Configuration CRM personnalisée que vous souhaitez que cette action Exécution du flux de travail utilise. Si la liste déroulante est vide, vous devez mettre en place une configuration avant de continuer. Vous devez choisir la même configuration dans les actions Agent Workflow Configuration et Exécution du flux de travail de ce script.

3. Sélectionnez une ou plusieurs Actions que vous souhaitez que les agents puissent effectuer lorsque ce script s'exécute.

   En savoir plus sur les types d’actions

   Valeur du champ	Détails
   Tout sélectionner	Sélectionnez les trois actions décrites ci-dessous.
   Create Timeline	Les agents peuvent ajouter des informations sur la chronologie dans la section Activités de la carte client.
   Data Memorialization	Les agents peuvent ajouter les données de l'enregistrement sélectionné dans la section Activités de la carte client au dossier du contact actuel. Vous déterminez les données qui peuvent être ajoutées en les mappant pour ce CRM dans la page Intégrations de l'agent de NiCE CXone. Voir la étapes d'intégration CRM correspondant au CRM de votre organisation et à l'application Agent que vous utilisez.
   Recherche	Les agents peuvent effectuer une recherche de deuxième niveau. Après avoir effectué une recherche initiale, ils peuvent effectuer une nouvelle recherche pour révéler davantage d'informations sur les résultats de la recherche initiale. La fonction Search doit être sélectionnée pour que les enregistrements de recherche s'affichent dans Customer Card.

4. Dans la section Workflow Mapping, sélectionnez les Flux de travail que vous souhaitez assigner aux Actions que vous avez sélectionnées. Vous ne pouvez sélectionner qu’un seule flux de travail par action. La colonne Action indique à quelle option du workflow chaque action correspond.

   L'exemple suivant montre les flux de travail disponibles pour ServiceNow. Si vous utilisez un autre CRM, les options seront différentes.

   Voir l'image

   
5. Si vous souhaitez modifier un mappage de flux de travail, effacez la première sélection avant de choisir un nouveau flux de travail. Si vous voulez supprimer tous les mappages sélectionnés, cliquez sur la case à cocher dans l’en-tête de la colonne.
6. Cliquez sur Prochain.
7. Vérifiez vos sélections dans la fenêtre Custom CRM Configurations Updated . Si vous devez modifier une sélection, cliquez sur la fenêtre et effectuez vos modifications.
8. Cliquez sur enregistrer dans la fenêtre Custom CRM Configurations Updated pour appliquer vos sélections aux propriétés de Workflow Execute.

Exemple de script

The following example shows the Workflow Execute action being used to integrate a CRM application with Agent Workspace (Agent), Agent Workspace (Embedded) (Agent Embedded), or Agent Workspace (Browser Extension) (Agent Integrated). You can find more information about using the action, including a sample script to download, on the help page integration process help page.