Configurer les Flux de travail Zendesk pour Agent Workspace (Browser Extension) (Agent Integrated)

You can configure Search, Custom Create, and Standard Create workflows for Zendesk and NiCE CXone Agent Workspace (Browser Extension) (Agent Integrated). These workflows search or create Zendesk records, also called entities or objects. This is the back end configuration of dynamic data mapping.

Type de Workflow

Description

Flux de travail

Recherche Les flux de travail de recherche analysent Zendesk à la recherche des enregistrements applicables à l'interactionClosed The full conversation with an agent through a channel. For example, an interaction can be a voice call, email, chat, or social media conversation. que l'Agent traite. Rechercher un ANI
Recherche personnalisée
Création personnalisée Les flux de travail de création personnalisée permettent de créer le type d’enregistrement voulu depuis les champs standard et personnalisés. Créer un enregistrement personnalisé
Standard Créer Les flux de travail de création standard créent des enregistrements Zendesk standard avec des champs de données standard. La charge utile SNIPPET de ces flux de travail doit inclure les champs standard et uniquement ceux-là. Créer un Ticket
Créer un utilisateur

Les flux de travail s'exécutent en utilisant les rôles et autorisations de l'utilisateur du système. Il s'agit du compte utilisateur Zendesk que vous avez créé spécifiquement pour la configuration de NiCE CXone. Lorsque des enregistrements sont créés, ils utilisent le nom et le fuseau horaire de l'utilisateur du système.

Avant de commencer, consultez le diagramme d'intégration CRM, le diagramme de workflow CRM, et la liste de terminologie d'intégration CRM.

Par ailleurs, téléchargez ce dossier de modèles de scripts. Il contient des scripts voix et digitaux pour NiCE CXone Studio et Desktop Studio.

Configurer les Flux de travail de recherche

Il existe deux flux de travail de recherche : Search for ANI et Custom Search.

Lorsque vous utilisez des mappages de données dynamiques dans un Workflow de recherche, la section Related Interactions de la fiche client icon: a person next to a document. affiche d'abord les enregistrements qui :

  • Correspond aux critères de recherche, et

  • Renseignez des données dans chaque champ mappé.

Les agents peuvent cliquer sur Actualiser dans la carte client icon: a person next to a document. pour afficher tous les enregistrements correspondant aux critères de recherche.

Configurer le Flux de travail Recherche d’ANI

Le workflow Recherche par ANI utilise l'ANIClosed Also known as caller ID. Listed phone number of an incoming voice call. du ACD pour rechercher dans tous les champs téléphone standard les enregistrements correspondants.

N'incluez pas la propriété timeoutMilliSec dans votre code Workflow. Cela peut entraîner la livraison de plusieurs fois la même interaction à vos agents.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Search for ANI.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-clic sur l'action SNIPPET dans le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
    DYNAMIC searchInput
    searchInput.workflowInput.phoneNumber = "{ANI}"
    						
    ASSIGN searchJson = "{searchInput.asjson()}"
    		
  5. Enregistrez votre script.

  6. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le Workflow Recherche personnalisée

Le workflow Custom Search vous permet de rechercher Zendesk des enregistrements qui correspondent à des critères de filtre flexibles. Vous pouvez utiliser Custom Search pour :

  • Rechercher un seul type d'enregistrement Zendesk, comme Ticket.

  • Recherchez Multiple types d'enregistrement Zendesk dans la même instance CRM dans une seule charge utile. Par exemple, vous pouvez rechercher à la fois Ticket et User en même temps.

  • Utilisez plusieurs champs et variables dans le filtre de recherche.

Vous pouvez rechercher n'importe quelle combinaison d'un maximum de 5 enregistrements Zendesk dans une seule charge utile. Il n'existe aucune limite imposée au nombre de champs dans une Custom Search. Cependant, la recherche d'un grand nombre de champs dans une seule charge utile peut ralentir la recherche. Commencez par un petit ensemble de champs, puis étendez-le selon les besoins.

N'incluez pas la propriété timeoutMilliSec dans votre code Workflow. Cela peut entraîner la livraison de plusieurs fois la même interaction à vos agents.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Custom Search.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Exécution du flux de travail.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez l'un des blocs de code d'exemple ci-dessous et collez-le dans l'onglet Text View de la fenêtre de l'Éditeur. Mettez ensuite à jour les valeurs si nécessaire.

  5. Enregistrez votre script.

  6. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer les Flux de travail de création personnalisés

Les flux de travail Création personnalisée vous permettent de configurer une charge utile SNIPPET afin de créer tout type d'enregistrement Zendesk, standard ou personnalisé. Ils vous permettent également de remplir n'importe quel type DE champ, Standard ou personnalisé. Par exemple, vous pouvez créer l’enregistrement Ticket avec une partie des champs standard de ce type d’enregistrement, ainsi que vos propres champs personnalisés.

Il s’agit de la méthode recommandée pour créer des enregistrements Zendesk

Configuration du Flux de travail Créer un enregistrement personnalisé (anciennement Créer une entité)

Le workflow Create Custom Record crée tout type d'enregistrement Zendesk, Standard ou personnalisé. Cet enregistrement permet d’afficher des champs de données standard et personnalisés. Les champs doivent contenir du texte, des nombres ou des variables. Les champs liés sont le plus souvent renseignés par les résultats de recherche ou les listes d'options, mais vous pouvez configurer ce workflow pour ajouter des données codées en dur à un champ lié.

Si vous utilisez l'ancienne version de ce Workflow, appelée Workflow Créer une entité, vous devez configurer votre script Studio avec deux actions supplémentaires : une SNIPPET appelée Snippet for Send Workflow Response, et une CUSTOMEVENT appelée Send Workflow Response. Utilisez ce modèle de script pour Desktop Studio ou ce modèle de script pour Studio.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create Custom Record.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après ONANSWER ou ONASSIGNMENT.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
    DYNAMIC create[Record]
    create[Record].table = "[ticket or user]"
    create[Record].data.[ticket or user].[fieldName] = "[field value]"
    create[Record].data.[ticket or user].[fieldName] = "[field value]"
    
    createPayload.pinnedRecord = "[true or false]"
    createPayload.screenPop = "[true or false]"
    						
    DYNAMIC create[Record]Payload
    create[Record]Payload.workflowInput = create[Record]
    						
    ASSIGN createCustomJson = "{create[Record]Payload.asjson()}"
    		

    Vous devez inclure chacune de ces lignes.

  5. Remplacez l'espace réservé [Record] dans chaque instance de create[Record] par Ticket ou User, selon le type d'enregistrement que vous créez. Par exemple, createTicket.
  6. Remplacez la valeur de l'attribut create[Record].table par ticket ou user, selon le type d'enregistrement que vous créez. Par exemple, si vous créez un ticket, cette ligne devrait êtrecreateTicket.table = "ticket".
  7. Dans les deux attributs suivants, remplacez [ticket or user] par ticket ou user, en fonction du type d'enregistrement que vous créez. Par exemple, si vous créez un ticket, ces lignes doivent commencer par createTicket.data.ticket.
  8. Dans ces mêmes attributs, remplacez [fieldName] par le nom du champ que vous souhaitez inclure dans l'enregistrement. Par exemple, createTicket.data.ticket.description. Remplacez [field value] par la valeur que vous souhaitez afficher dans le champ. Par exemple, createTicket.data.ticket.description = "This ticket is new."
  9. Pour ajouter des champs supplémentaires, créez d'autres attributs qui suivent le même format :

    
    create[Record].data.[ticket or user].[fieldName] = "[field value]"
    		

    Par exemple :

    
    createTicket.data.ticket.group_id = "12345678910112"
    				
  10. Modifiez la valeur de l'attribut createPayload.pinnedRecord sur true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche aux agents dans la section Interactions actuelles de la fiche client. Lorsqu'elle est définie sur false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  11. Modifiez la valeur de l'attribut createPayload.screenPop en true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Zendesk. Si la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  12. Enregistrez votre script.

  13. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer les Flux de travail de création Standard

Les flux de travail de création Standard créent des enregistrements Zendesk Standard avec les champs spécifiés dans la charge utile du flux de travail.

Vous ne pouvez pas ajouter ou supprimer de champs dans la charge utile SNIPPET des flux de travail de création standard. Si vous ajoutez ou supprimez des champs, l’enregistrement ne sera pas créé. Pour créer un enregistrement Standard ou personnalisé avec les champs souhaités, utilisez le workflow Create Custom Record.

Configurer le Workflow Create Ticket

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create Ticket.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
    DYNAMIC createTicket
    createTicket.subject = "[Ticket Name] - {ANI}"
    createTicket.description = "{ANI}"
    createTicket.requester_id = "{variable}"
    						
    createTicket.pinnedRecord = "[true or false]"
    createTicket.screenPop = "[true or false]"
    
    DYNAMIC createTicketPayload
    createTicketPayload.workflowInput = createTicket
    						
    ASSIGN createTicketJson = "{createTicketPayload.asjson()}"
    		

    Vous devez inclure chacune de ces lignes. Si vous souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createTicket.description = "".

  5. Modifiez la valeur de l'attribut createTicket.subject par le nom du Ticket. Par exemple, createTicket.subject= "Auto Created Ticket for {ANI}". Cette valeur peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que cette valeur soit mise à jour pour chaque interaction.

  6. Remplacez la valeur de l'attribut createTicket.description par une description du Ticket. Par exemple, createTicket.data.ticket.description = "Ticket created for {ANI}". Cette valeur peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que cette valeur soit mise à jour pour chaque interaction.

  7. Modifiez la valeur de l'attribut createTicket.requester_id par le nom de la Variable que vous souhaitez utiliser. Par exemple, createTicket.requester_id = "{userRecord.id}".
  8. Remplacez la valeur de l'attribut createTicket.pinnedRecord par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s'affiche pour les agents dans la Section Interactions actuelle de la fiche client. Lorsque la valeur est définie sur false, il s'affiche dans la Section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  9. Modifiez la valeur de l'attribut createTicket.screenPop en true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Zendesk. Si la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  10. Cliquez sur l'action Workflow Execute qui suit l'élément SNIPPET de ce Flux de travail. Modifiez la propriété workflowPayload de cette action pour {createTicketJson}. Veillez à inclure les accolades.

  11. Enregistrez votre script.

  12. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le workflow Create User

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create User.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Exécution du flux de travail.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
    DYNAMIC createUser
    createUser.phoneNumber = "{ANI}"
    createUser.name = "Auto Created User for {ANI}"
    						
    createUser.pinnedRecord = "[true or false]"
    createUser.screenPop = "[true or false]"
    
    DYNAMIC createUserPayload
    createUserPayload.workflowInput = createUser
    						
    ASSIGN createUserJson = "{createUserPayload.asjson()}"
    		

    Vous devez inclure chacune de ces lignes. Si vous souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur null (""). Par exemple, createUser.name = "".

  5. Remplacez la valeur des attributs createUser.phoneNumber et createUser.name en fonction de vos besoins. Par exemple, createUser.name = "Caller {ANI} to Billing".

  6. Remplacez la valeur de l'attribut createUser.pinnedRecord par true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche pour les agents dans la section Interactions actuelle de la fiche client. Lorsqu'elle est définie sur false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  7. Modifiez la valeur de l'attribut createUser.screenPop en true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Zendesk. Si la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  8. Cliquez sur l'action Workflow Execute qui suit l'SNIPPET de ce Flux de travail. Modifiez la propriété workflowPayload de cette action en {createUserJson}. Veillez à inclure les accolades.

  9. Enregistrez votre script.

  10. Vous pouvez tester votre script en simulant une interaction dans Studio.

Épingler les enregistrements

Vous pouvez épingler un enregistrement à la Section Interaction actuelle de la fiche client. Lorsqu'un enregistrement est épinglé, il est lié icon of a check mark in a green box. à des fins de mémorialisation des données et d'informations de chronologie par défaut. Cela signifie que les informations de mémorialisation des données et de chronologie seront ajoutées à l'enregistrement Zendesk une fois l'interaction terminée. Si l'agent ne souhaite pas que les informations soient mappées, il peut dissocier l'enregistrement.

  1. Ouvrez l'action SNIPPET Snippet for Create Workflow dans votre script.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[RecordType]Payload :

    						
    createPayload.pinnedRecord = "true"					
    		
  3. Make sure that createPayload matches the earlier lines in your workflow.

  4. Enregistrez votre script.

Configurer les enregistrements pour Screen Pop

Vous pouvez configurer des enregistrements afin qu'ils apparaissent automatiquement sous forme de pop-up d'écran dans Zendesk. Cette opération s'effectue en modifiant la charge utile du workflow.

Dans les Flux de travail de recherche

Par défaut, les enregistrements à correspondance uniqueClosed Occurs when a Search workflow returns only one record. apparaissent sous forme de fenêtres contextuelles. Vous pouvez modifier ce comportement en définissant l'attribut screenPop sur false.

Les enregistrements de correspondance Multiple n'apparaissent pas sous forme de fenêtres contextuelles, même si vous définissez l'attribut screenPop sur true.

  1. Ouvrez l'action SNIPPET du Workflow dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant ASSIGN searchJson = "{searchInput.asjson()}" :

    						
    searchPayload.screenPop = "[true or false]"				
    		
  3. Configurez le code collé.

    1. Assurez-vous que searchPayload correspond aux lignes précédentes de votre workflow. Par exemple, dans le Custom Search workflow, cette ligne doit être payload.screenPop. Dans le Search for ANI workflow, elle doit être searchInput.workflowInput.screenPop.

    2. Modifier la valeur de l'attribut screenPop :

      • Définissez-le sur true pour afficher l'enregistrement sous forme de fenêtre contextuelle.

      • Définissez-le sur false pour ne pas l'afficher.

  4. Enregistrez votre script.

Dans Créer des Flux de travail

Par défaut, les enregistrements créés n'apparaissent pas sous forme de fenêtres contextuelles. Vous pouvez modifier ce comportement en définissant l'attribut screenPop sur true.

  1. Ouvrez l'action SNIPPET du workflow dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[Record]Payload :

    						
    createPayload.screenPop = "[true or false]"				
    		
  3. Configurez le code collé.

    1. Assurez-vous que createPayload correspond aux lignes précédentes de votre workflow. Par exemple, dans le workflow standard Créer un Ticket, cette ligne doit être createTicket.screenPop.

    2. Modifier la valeur de l'attribut screenPop :

      • Définissez-le sur true pour afficher l'enregistrement sous forme de fenêtre contextuelle.

      • Définissez-le sur false pour ne pas l'afficher.

  4. Enregistrez votre script.

Configurer la mise en cache des Workflows

Vous pouvez contrôler si les résultats du workflow de recherche et de création sont mis en cache. Pour ce faire, modifiez la charge utile du workflow. Lorsque les résultats sont mis en cache, ils apparaissent dans la fiche client dans l'application Agent.

Rechercher des Flux de travail

Par défaut, les résultats de Search workflow sont mis en cache. Vous pouvez modifier ce comportement en définissant l'attribut cacheResponse sur false. Les enregistrements retournés n'apparaîtront pas dans l'application Agent.

  1. Ouvrez l'action SNIPPET du workflow dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant ASSIGN searchJson = "{searchInput.asjson()}" :

    						
    searchPayload.cacheResponse = "[true or false]"				
    		
  3. Configurez le code collé.

    1. Assurez-vous que searchPayload correspond aux lignes précédentes de votre workflow. Par exemple, dans le Custom Search workflow, cette ligne doit être payload.cacheResponse.

    2. Modifier la valeur de l'attribut cacheResponse :

      • Définissez-le sur true pour mettre en cache les résultats du workflow.

      • Définissez-le sur false pour ne pas les mettre en cache.

  4. Enregistrez votre script.

Dans Créer des Flux de travail

Par défaut, les résultats de Create workflow sont mis en cache. Vous pouvez modifier ce paramètre en définissant l'attribut cacheResponse sur false. Les enregistrements créés n'apparaîtront pas dans l'application Agent.

  1. Ouvrez l'action SNIPPET du workflow dans votre script.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[Record]Payload :

    						
    createPayload.cacheResponse = "[true or false]"				
    		
  3. Configurez le code collé.

    1. Assurez-vous que createPayload correspond aux lignes précédentes de votre workflow. Par exemple, dans le workflow standard Créer un Ticket, cette ligne doit être createTicket.cacheResponse.

    2. Modifier la valeur de l'attribut cacheResponse :

      • Définissez-le sur true pour mettre en cache les résultats du workflow.

      • Définissez-le sur false pour ne pas les mettre en cache.

  4. Enregistrez votre script.