Configurar Flujos de trabajo de Zendesk para 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.

Tipo de flujo de trabajo

Descripción

Flujos de trabajo

Buscar Los flujos de trabajo de búsqueda analizan Zendesk para buscar registros que sean aplicables a la interacciónClosed 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 el agente está gestionando. Buscar ANI (Asignación Automática de Número)
Búsqueda personalizada
Creación personalizada Los flujos de trabajo de Creación personalizada crean cualquier tipo de registro con campos estándar y personalizados. Crear Grabar personalizado
Creación estándar Los flujos de trabajo de Creación estándar crean registros Zendesk estándar con sus campos de datos estándar. La carga útil SNIPPET de estos flujos de trabajo debe incluir los campos estándar y solo esos campos. Crear Ticket
Crear usuario

Los flujos de trabajo se ejecutan utilizando los roles y permisos delusuario del sistema. Esta es la cuenta de usuario Zendesk que creó específicamente para la configuración de NiCE CXone. Cuando se crean registros, estos utilizan el nombre y la zona horaria del usuario del sistema.

Antes de comenzar, revise el diagrama de integración de CRM, el diagrama de flujo de trabajo de CRM, y la lista de terminología de integración de CRM.

Además, descargue esta carpeta de plantillas de scripts. Contiene scripts de voz y digitales para NiCE CXone Studio y Desktop Studio.

Configurar Flujos de trabajo de búsqueda

Hay DOs flujos de trabajo Buscar: Búsqueda por ANI y Búsqueda personalizada.

Cuando utiliza asignaciones de datos dinámicos en un workflow de Search, la sección Related Interactions en la tarjeta de cliente icon: a person next to a document. muestra primero los registros que:

  • Coincide con los criterios de búsqueda, y

  • Tener datos en todos los campos asignados.

Los agentes pueden hacer clic en Actualizar en la tarjeta de cliente icon: a person next to a document. para ver todos los registros que coincidan con los criterios de búsqueda.

Configurar el Flujo de trabajo Búsqueda de ANI

El flujo de trabajo Search for ANI utiliza el ANIClosed Also known as caller ID. Listed phone number of an incoming voice call. del ACD para buscar registros coincidentes en todos los campos de teléfono estándar.

No incluya la propiedad timeoutMilliSec en su código de workflow. Esto puede provocar que se entreguen múltiples interacciones iguales a sus agentes.

  1. En Studio, abra el script donde desea configurar el flujo de trabajo Search for ANI.

  2. Si aún no lo ha hecho, agregue una acción SNIPPET después de BEGIN y antes de la acción Ejecución de flujo de trabajo.

  3. Haga doble clic en la acción SNIPPET en el lienzo del script.

  4. Copie cada una de las siguientes líneas de código y péguelas en la pestaña Vista de texto de la ventana editor.

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

  6. Puede probar su script simulando una interacción en Studio.

Configurar el Workflow de búsqueda personalizada

El workflow de Custom Search le permite buscar Zendesk registros que coincidan con criterios de filtro flexibles. Puede usar Custom Search para:

  • Buscar un solo tipo de registro Zendesk, como Ticket.

  • Busque múltiples tipos de registro de Zendesk en la misma instancia de CRM en una única carga útil. Por ejemplo, puede buscar Ticket y User al mismo tiempo.

  • Use múltiples campos y variables en el filtro de búsqueda.

Puede buscar cualquier combinación de hasta 5 registros de Zendesk en una sola carga útil. No hay un límite impuesto en la cantidad de campos en una Custom Search. Sin embargo, buscar muchos campos en una sola carga útil puede ralentizar la búsqueda. Comience con un conjunto pequeño de campos y amplíelo según sea necesario.

No incluya la propiedad timeoutMilliSec en su código de workflow. Esto puede provocar que se entreguen múltiples interacciones iguales a sus agentes.

  1. En Studio, abra el script donde desea configurar el flujo de trabajo de Custom Search.

  2. Si aún no lo ha hecho, agregue una acción SNIPPET después de BEGIN y antes de la acción Ejecución de flujo de trabajo.

  3. Haga doble clic en la acción SNIPPET en el lienzo del script.

  4. Copie uno de los bloques de código de ejemplo a continuación y péguelo en la pestaña Vista de texto de la ventana del editor. Luego, actualice los valores según sea necesario.

  5. Guardar el script.

  6. Puede probar su script simulando una interacción en Studio.

Configurar Flujos de trabajo de creación personalizados

Los flujos de trabajo de Custom Create le permiten configurar una carga útil de SNIPPET para crear cualquier tipo de registro de Zendesk, estándar o personalizado. También le permiten rellenar cualquier tipo DE campo, estándar o personalizado. Por ejemplo, puede crear un registro de Ticket con algunos de los campos estándar de ese tipo de registro, así como sus propios campos personalizados.

Este es el método recomendado para crear registros Zendesk.

Configurar el Flujo de trabajo Crear registro personalizado (anteriormente Crear entidad)

El workflow Create Custom Record crea cualquier tipo de registro de Zendesk, estándar o personalizado. Este registro puede mostrar campos de datos estándar y personalizados. Los campos deben contener texto, números o variables. Los campos vinculados se suelen completar con resultados de búsqueda o listas de opciones, pero puede configurar este workflow para agregar datos codificados de forma fija a un campo vinculado.

Si usa la versión anterior de este workflow, denominada workflow Crear entidad, debe configurar su script de Studio con DOs acciones adicionales: un SNIPPET llamado Snippet for Send Workflow Response, y un CUSTOMEVENT llamado Send Workflow Response. Use esta plantilla de script para Desktop Studio o esta plantilla de script para Studio.

  1. En Studio, abra el script donde desea configurar el workflow Create Custom Record.

  2. Si aún no lo ha hecho, agregue una acción SNIPPET después de ONANSWER o ONASSIGNMENT.

  3. Haga doble clic en la acción SNIPPET en el lienzo del script.

  4. Copie cada una de las siguientes líneas de código y péguelas en la pestaña Vista de texto de la ventana editor.

    
    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()}"
    		

    Debe incluir cada una de esas líneas.

  5. Reemplace el marcador [Record] en cada instancia de create[Record] con Ticket o User, según el tipo de registro que esté creando. Por ejemplo, createTicket.
  6. Cambie el valor del atributo create[Record].table a ticket o user, según el tipo de registro que esté creando. Por ejemplo, si está creando un ticket, esta línea debería sercreateTicket.table = "ticket".
  7. En los siguientes DOs atributos, cambie [ticket or user] a ticket o user, según el tipo de registro que esté creando. Por ejemplo, si está creando un ticket, estas líneas deberían empezar por createTicket.data.ticket.
  8. En esos mismos atributos, cambie [fieldName] al nombre del campo que desea incluir en el registro. Por ejemplo, createTicket.data.ticket.description. Cambie [field value] al valor que quiere mostrar en el campo. Por ejemplo, createTicket.data.ticket.description = "This ticket is new."
  9. Para agregar campos adicionales, cree atributos adicionales que sigan el mismo formato:

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

    Por ejemplo:

    
    createTicket.data.ticket.group_id = "12345678910112"
    				
  10. Cambie el valor del atributo createPayload.pinnedRecord a true o a false. Cuando se establece en true, el registro creado se muestra a los agentes en la sección de Interactions actual de la tarjeta del cliente. Cuando se establece en false, se muestra en la sección de Interactions reciente de la tarjeta del cliente. Si no incluye este atributo en la carga útil, se asumirá como false.
  11. Cambie el valor del atributo createPayload.screenPop a true o false. Si se define a true, el registro creado aparece automáticamente al agente como una pantalla emergente en Zendesk. Si se define a false, no aparece. Si no incluye este atributo en la carga útil, se asumirá como false.

  12. Guardar el script.

  13. Puede probar su script simulando una interacción en Studio.

Configurar Flujos de trabajo de creación Estándar

Los flujos de trabajo estándar de creación crean registros Zendesk estándar con los campos especificados en la carga útil del flujo de trabajo.

No puede agregar ni eliminar campos en la carga útil SNIPPET de los flujos de trabajo de Creación Estándar. Si agrega o borra campos, el registro no se creará. Para crear un registro estándar o personalizado con los campos que desea, use el flujo de trabajo Create Custom Record.

Configurar el Workflow de creación de Ticket

  1. En Studio, abra el script donde desea configurar el flujo de trabajo Create Ticket.

  2. Si aún no lo ha hecho, agregue una acción SNIPPET después de BEGIN y antes de la acción Ejecución de flujo de trabajo.

  3. Haga doble clic en la acción SNIPPET en el lienzo del script.

  4. Copie cada una de las siguientes líneas de código y péguelas en la pestaña Vista de texto de la ventana editor.

    
    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()}"
    		

    Debe incluir cada una de esas líneas. Si desea mantener un campo en blanco, puede usar un valor nulo (""). Por ejemplo, createTicket.description = "".

  5. Cambiar el valor del atributo createTicket.subject al nombre del Ticket. Por ejemplo, createTicket.subject= "Auto Created Ticket for {ANI}". Este valor puede ser una codificación rígida, una variable o una combinación de ambos. Use una variable si desea que este valor se actualice para cada interacción.

  6. Cambie el valor del atributo createTicket.description a una descripción del ticket. Por ejemplo, createTicket.data.ticket.description = "Ticket created for {ANI}". Este valor puede ser una codificación rígida, una variable o una combinación de ambos. Use una variable si desea que este valor se actualice para cada interacción.

  7. Cambie el valor del atributo createTicket.requester_id al nombre de la variable que desea usar. Por ejemplo, createTicket.requester_id = "{userRecord.id}".
  8. Cambie el valor del atributo createTicket.pinnedRecord a true o false. Cuando se establece en true, el registro creado se muestra a los agentes en la sección Interactions actual de la tarjeta del cliente. Cuando se establece en false, se muestra en la sección Interactions reciente de la tarjeta del cliente. Si no incluye este atributo en la carga útil, se asumirá como false.
  9. Cambie el valor del atributo createTicket.screenPop a true o false. Si se define a true, el registro creado aparece automáticamente al agente como una pantalla emergente en Zendesk. Si se define a false, no aparece. Si no incluye este atributo en la carga útil, se asumirá como false.

  10. Haga clic en la acción Ejecución de flujo de trabajo que viene después de este SNIPPET de este Flujo de trabajo. Cambie la propiedad workflowPayload de esa acción a {createTicketJson}. Asegúrese de incluir las llaves.

  11. Guardar el script.

  12. Puede probar su script simulando una interacción en Studio.

Configurar el Flujo de trabajo Create User

  1. En Studio, abra el script donde desea configurar el flujo de trabajo Create User.

  2. Si aún no lo ha hecho, agregue una acción SNIPPET después de BEGIN y antes de la acción Ejecución de flujo de trabajo.

  3. Haga doble clic en la acción SNIPPET en el lienzo del script.

  4. Copie cada una de las siguientes líneas de código y péguelas en la pestaña Vista de texto de la ventana editor.

    
    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()}"
    		

    Debe incluir cada una de esas líneas. Si desea mantener un campo en blanco, puede usar un valor nulo (""). Por ejemplo, createUser.name = "".

  5. Cambie los valores de los atributos de createUser.phoneNumber y createUser.name según sus necesidades. Por ejemplo, createUser.name = "Caller {ANI} to Billing".

  6. Cambie el valor del atributo createUser.pinnedRecord a true o false. Cuando se configura en true, el registro creado se muestra a los agentes en la sección Interactions actual de la tarjeta del cliente. Cuando se configura en false, se muestra en la sección Interactions reciente de la tarjeta del cliente. Si no incluye este atributo en la carga útil, se asumirá como false.
  7. Cambie el valor del atributo createUser.screenPop a true o false. Si se define a true, el registro creado aparece automáticamente al agente como una pantalla emergente en Zendesk. Si se define a false, no aparece. Si no incluye este atributo en la carga útil, se asumirá como false.

  8. Haga clic en la acción Workflow Execute que aparece después del SNIPPET de este Flujo de trabajo. Cambie la propiedad workflowPayload de esa acción a {createUserJson}. Asegúrese de incluir las llaves.

  9. Guardar el script.

  10. Puede probar su script simulando una interacción en Studio.

Anclar registros

Puede fijar un registro en la sección Interacción actual de la tarjeta de cliente. Cuando se fija un registro, este se enlaza icon of a check mark in a green box. para la memorización de datos e información de la línea de tiempo de forma predeterminada. Esto significa que la información de memorización de datos y de la línea de tiempo se agregará al registro Zendesk cuando se complete la interacción. Si el agente no desea que la información se asigne, puede desenlazar el registro.

  1. Abra la acción Snippet for Create Workflow SNIPPET en su script.

  2. En la carga útil del flujo de trabajo, copie esta línea de código y péguela antes de DYNAMIC create[RecordType]Payload:

    						
    createPayload.pinnedRecord = "true"					
    		
  3. Asegúrese de que createPayload coincide con las líneas anteriores de su flujo de trabajo.

  4. Guardar el script.

Configurar registros para la ventana emergente de pantalla

Puede configurar los registros para que aparezcan automáticamente como ventanas emergentes en pantalla en Zendesk. Esto se hace editando la carga útil del workflow.

Buscar en Flujos de trabajo

De manera predeterminada, los registros de coincidencia únicaClosed Occurs when a Search workflow returns only one record. aparecen como screen pops. Puede cambiar esto configurando el atributo screenPop en false.

Múltiples registros de coincidencia no aparecen como screen pops, incluso si establece el atributo screenPop en true.

  1. Abra la acción SNIPPET del Workflow en su script Studio.

  2. En la carga útil del flujo de trabajo, copie esta línea de código y péguela antes de ASSIGN searchJson = "{searchInput.asjson()}":

    						
    searchPayload.screenPop = "[true or false]"				
    		
  3. Configure el code pegado.

    1. Asegúrese de que searchPayload coincida con las líneas anteriores de su flujo de trabajo. Por ejemplo, en el Custom Search flujo de trabajo, esta línea debe ser payload.screenPop. En el Search for ANI flujo de trabajo, debe ser searchInput.workflowInput.screenPop.

    2. Cambiar el valor del atributo screenPop:

      • Configúrelo en true para mostrar el registro como pantalla emergente.

      • Configúrelo en false para no mostrarlo.

  4. Guardar el script.

En Crear Flujos de trabajo

De forma predeterminada, los registros creados no aparecen como screen pops. Puede cambiar esto configurando el atributo screenPop en true.

  1. Abra la acción SNIPPET del workflow en su script Studio.

  2. En la carga útil del flujo de trabajo, copie esta línea de código y péguela antes de DYNAMIC create[Record]Payload:

    						
    createPayload.screenPop = "[true or false]"				
    		
  3. Configure el code pegado.

    1. Asegúrese de que createPayload coincida con las líneas anteriores de su flujo de trabajo. Por ejemplo, en el flujo de trabajo estándar Crear Ticket, esta línea debe ser createTicket.screenPop.

    2. Cambiar el valor del atributo screenPop:

      • Configúrelo en true para mostrar el registro como una pantalla emergente.

      • Configúrelo en false para no mostrarlo.

  4. Guardar el script.

Configurar el almacenamiento en caché de Workflow

Puede controlar si los resultados del workflow de Búsqueda y Creación se almacenan en caché. Esto se hace editando la carga útil del workflow. Cuando los resultados se almacenan en caché, aparecen en la tarjeta del cliente en la aplicación de agente.

Buscar en Flujos de trabajo

De manera predeterminada, los resultados de Search workflow se almacenan en caché. Puede cambiar esto configurando el atributo cacheResponse en false. Los registros devueltos no aparecerán en la aplicación del agente.

  1. Abra la acción SNIPPET del Workflow en su script Studio.

  2. En la carga útil del flujo de trabajo, copie esta línea de código y péguela antes de ASSIGN searchJson = "{searchInput.asjson()}":

    						
    searchPayload.cacheResponse = "[true or false]"				
    		
  3. Configure el code pegado.

    1. Asegúrese de que searchPayload coincida con las líneas anteriores en su flujo de trabajo. Por ejemplo, en el flujo de trabajo Custom Search, esta línea debe ser payload.cacheResponse.

    2. Cambiar el valor del atributo cacheResponse:

      • Configúrelo en true para almacenar en caché los resultados del workflow.

      • Configúrelo en false para no almacenarlos en caché.

  4. Guardar el script.

En Crear Flujos de trabajo

De forma predeterminada, los resultados de Create workflow se almacenan en caché. Puede cambiar esto configurando el atributo cacheResponse en false. Los registros creados no aparecerán en la aplicación del agente.

  1. Abra la acción SNIPPET del workflow en su script.

  2. En la carga útil del flujo de trabajo, copie esta línea de código y péguela antes de DYNAMIC create[Record]Payload:

    						
    createPayload.cacheResponse = "[true or false]"				
    		
  3. Configure el code pegado.

    1. Asegúrese de que createPayload coincida con las líneas anteriores de su workflow. Por ejemplo, en el workflow estándar Crear Ticket, esta línea debe ser createTicket.cacheResponse.

    2. Cambiar el valor del atributo cacheResponse:

      • Configúrelo en true para almacenar en caché los resultados del workflow.

      • Configúrelo en false para no almacenarlos en caché.

  4. Guardar el script.