Saltar al contenido principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Evento JSON


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Consejo Q: Los eventos JSON solo están disponibles para los usuarios que hayan adquirido acceso a la API de Qualtrics . Si está interesado en obtener esta función, hable con su Ejecutivo de Cuenta o tu Gerente de éxito de XM .

Acerca del Evento JSON

¿Alguna vez ha deseado que una solicitud realizada en su sitio web activador un ticket en Qualtrics? ¿Alguna vez ha deseado crear una integración perfecta entre Qualtrics y su propio sistema interno? ¿Alguna vez ha deseado activador una tarea en la pestaña Flujos de trabajo , pero con un evento que ocurre fuera de Qualtrics?

Los eventos JSON permiten que el software externo inicie flujos de trabajo a través de una solicitud HTTP. En lugar de esperar a que un evento en Qualtrics activador más acciones en la plataforma, puede simplemente configurar un evento JSON para recibir solicitudes de un tercero.

Consejo Q: Usted debe generar un token de API antes de que esta función esté disponible para usted. Si ya tienes un token de API, no necesitas generar uno nuevo.
Atención :Configurar un evento JSON requiere conocimientos de programación avanzados. Si bien nuestro equipo de soporte estará encantado de ayudar con los aspectos básicos de la introducción de información en el evento, no podemos brindar asistencia en los aspectos de programación. En cambio, siempre puede preguntar a los usuarios especializados de nuestra comunidad.

Limitaciones

El evento JSON es no compatible con las siguientes configuraciones y configuraciones:

  • Cualquier cosa que no sea HTTP (por ejemplo, cola de mensajes, SMS).
  • Llamadas HTTP salientes.
  • Procesar XML (se ignorará el cuerpo de la solicitud XML ).
  • Procesar cualquier cosa que no sea JSON.
  • Autenticar de cualquier forma que no sea un encabezado X- API-TOKEN o nuestra autenticación básica HTTP modificada.
    Consejo Q: OAuth y otras formas de autenticación son incompatibles con los eventos JSON .
  • Cualquier análisis JSON que no pueda satisfacerse mediante consultas JSONPath en el cuerpo JSON .
  • Llamadas que exceden el límite de velocidad de la API de 3000 por minuto.
  • Cargas útiles superiores a 100 KB.

Tipos de autenticación admitidos

Autenticación basada en token/autenticación de encabezado

Puedes autenticarte pasando tu token de API a través del encabezado de la solicitud como X- API-TOKEN.

Ejemplo:En el siguiente ejemplo POST, en cURL especificamos la URL base, el tipo de contenido y el token en el encabezado. El ID de la Encuesta y el formato de exportación se especifican en el cuerpo.

curl -X POST -H 'X- API-TOKEN: yourapitokenhere' -H 'Tipo de contenido: aplicación/ json' -d '{

    "identificador de encuesta": "SV_012345678912345",

    "formato": "csv"

}' 'https: qualtrics.com/ API/v3/responseexports'

Autenticación básica HTTP

La autenticación básica suele ser una versión codificada en Base64 de nombre de usuario:contraseña. Sin embargo, para mejorar la seguridad, Qualtrics utiliza una cadena codificada en Base64 de nombre de usuario:x-api-token.

Para utilizar la autenticación básica, debe configurar encabezados en la solicitud HTTP. El encabezado específico es Autorización .

Ejemplo: Digamos que su nombre de usuario de Qualtrics es demo@ qualtrics.com y su Token de API es f8gIK7G6GFH985Y4. Primero escribirías,

 qualtrics:f8gIK7G6GFH985Y4

Luego de la codificación Base64, esto aparecería como:

 Básico ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=

Así que el Autorización El encabezado que agregue a su solicitud HTTP tendrá el valor Básico ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ= .

Consejo Q: Consulte estas herramientas para codificación base64 y decodificación base64 .

Configuración de un Evento JSON

  1. Primero, necesitarás crear un flujo de trabajo. Ir a la Página de Flujos de trabajo independientes .
    En la pestaña de flujos de trabajo , haga clic en crear un flujos de trabajo y luego iniciarlo cuando se recibe un evento

    Consejo Q: También puedes utilizar eventos JSON en el Flujos de trabajo pestaña en un proyecto. Solo recomendamos agregar un flujo de trabajo a un proyecto específico si están explícitamente relacionados. (Por ejemplo, eres Distribuyendo ese proyecto con el evento JSON .)
  2. Asegúrate de estar en el Sus flujos de trabajo pestaña.
  3. Hacer clic Crear un flujo de trabajo .
  4. Seleccionar Se inicia cuando se recibe un evento .
  5. Seleccione el JSON evento.
    Elegir el evento JSON para iniciar el flujo de trabajo
  6. Si lo desea, especifique una Resumen del Activador , que debe describir el propósito del evento JSON . Agregar un resumen, copiar el punto final y habilitar la autenticación
  7. Se le proporcionará una URL. Use esto para invocar su nuevo flujo de trabajo desde fuera de Qualtrics, utilizando Postman, su propio sistema interno u otras aplicaciones similares. Para copiarlo, haga clic Copiar URL .
  8. De forma predeterminada, los eventos JSON requieren autenticación . Si desea permitir solicitudes no autenticadas, puede deshabilitarlas Requerir autenticación por Qualtrics .
  9. Ahora, puedes definir los datos del evento . Esto capturará datos de la solicitud entrante. Para comenzar, haga clic en Configuración avanzada .
    definir datos de evento en la sección de configuración avanzada

    Consejo Q: Para obtener información sobre la sección de Prueba, consulte Capturando eventos abajo.
  10. En el cuadro de la izquierda, ingrese el nombre del campo JSON . En el cuadro de la derecha, indique la ubicación dentro de los datos del evento (cuerpo de la solicitud HTTP).
    Consejo Q: ¡Las ubicaciones deben estar en formato JSONPath! Consulte la siguiente tabla para obtener una guía rápida de la sintaxis JSONPath.
  11. Para agregar otro campo, haga clic en Agregar un campo JSON .
  12. Si desea agregar un parámetro QUERY, agréguelo en el Parámetros de CONSULTA sección. Para obtener más información sobre qué son estos parámetros y cómo funcionan en la API, consulte nuestra Documentación de la API sobre parámetros .
    Advertencia: No es aconsejable pasar datos de identificación personal a través de parámetros QUERY. Cualquier información de identificación personal o datos confidenciales deben pasar a través del cuerpo POST siempre que sea posible, ya que POST es más seguro. Por favor contacto con el Soporte técnico de Qualtrics Si tiene preguntas o inquietudes.
  13. Para eliminar un campo, haga clic en el signo menos ( ).
  14. Para guardar los cambios, haga clic en Ahorrar .
  15. Ahora puedes agregar condiciones y un tarea a su flujo de trabajo haciendo clic en el signo más ( + ). Las condiciones determinan cuándo se ejecuta un flujo de trabajo , mientras que las tareas son el resultado del flujo de trabajo. Ver el Creación de Flujos de trabajo para obtener más información.
    Al hacer clic en el signo más, aparece un menú con las opciones Agregar una tarea y Agregar una condición .

Consejo Q : Haga clic en su evento JSON para cambiar los parámetros y los campos JSON .

Atención: Un evento JSON solo se puede activar a través de API desde la misma cuenta que creó el evento. Si se utiliza una cuenta diferente para activar la API para un evento JSON , es posible que aún reciba una respuesta de API de éxito 202; sin embargo, esto significa que se utilizó un token de API válido para realizar una solicitud válida, pero no necesariamente significa que se utilizó el token de API correcto o que el evento JSON se activó correctamente. Si recibe un mensaje de API 202-success, deberá verificar la plataforma para confirmar que se utilizó la API correcta.

 

Capturando eventos

Al crear un evento de API externo, es posible que necesite analizar datos del cuerpo de la publicación. Sin embargo, a veces puede resultar difícil analizar estos datos. Si desea saber qué está enviando su API externa, siga estos pasos.

  1. Haga clic en su evento JSON .
    seleccionando el evento JSON
  2. De forma predeterminada, el Capturar campos JSON de los resultados de la prueba para que puedan usarse como texto canalizado en otras tareas de este flujo de trabajo Se habilitará esta opción. Esta opción hace que los campos analizados en el cuerpo de la carga útil estén disponibles automáticamente como texto dinámico Cuando agregas tu flujo de trabajo tareas .
    haciendo clic en ejecutar una nueva prueba
  3. Hacer clic Ejecutar una nueva prueba .
  4. Verá un mensaje que indica que Qualtrics está esperando recibir el evento de su sistema externo. Activa tu API externa.El evento json esperando recibir un evento de su sistema externo
    Consejo Q: Para cancelar esta prueba, haga clic en Cancelar prueba .
  5. Si la prueba fue exitosa, verá el mensaje Conectado exitosamente al servidor . La carga útil se analizará y se agregará a la ventana.Una prueba exitosa: la carga útil JSON está en la ventana del evento
  6. Si lo desea, haga clic en Ejecutar una nueva prueba para ejecutar otra prueba. Necesitará ejecutar su siguiente llamada API después de hacer clic en esta opción.
  7. Haga clic en Guardar.

Sintaxis de JSONPath

La siguiente tabla proporciona algunos de los conceptos básicos de la sintaxis JSONPath. Tenga en cuenta que estos no están establecidos por Qualtrics, sino que son estándares utilizados con JSON.

Atención :La configuración de un Evento JSON requiere conocimientos avanzados de programación. Si bien nuestro equipo de soporte estará encantado de ayudar con los aspectos básicos de la introducción de información en el evento, no podemos brindar asistencia en los aspectos de programación. Siempre puedes intentar preguntarnos Comunidad de usuarios dedicados en cambio.
Ruta JSON Descripción Ejemplo
$ El objeto/elemento raíz $.tiendas[0].nombre
@ El objeto/elemento actual $.stores[?(@.name===”Tienda ACME”)]
. Operador infantil $.descripción del evento
.. Operador descendiente recursivo $.stores[0]..precio
* Comodín $.tiendas[*].nombre
[] Operador de subíndice $.tiendas[0].nombre
[,] Operador sindical $.tiendas[0,1]
[inicio:fin:paso] Operador de corte de matriz $.tiendas[0:10:2]
?() Aplica un filtro $.stores[?(@.name==”Tienda ACME”)]
() Expresión de script $.tiendas[(@.length-1)]

Ejemplo de sintaxis JSONPath

En este ejemplo, le mostraremos cómo, dado un objeto JSON , se puede utilizar la tabla JSONPath.

Este es nuestro objeto JSON :

{
 "eventDescription": "Ingresos mensuales",
 "tiendas": [
 {
 "nombre": "Tienda Acme",
 "total": 1000000,
 "Artículo superior":

 { "price": "50", "description": "Yunque" }
 },
 {
 "nombre": "El puesto de plátanos",
 "total": 250000,
 "Artículo superior":

 { "price": "4", "description": "El Gob" }
 },
 {
 "nombre": "Planeta Pizza",
 "total": 80000,
 "Artículo superior":

 { "precio": "15", "descripción": "Pepperoni" }
 }
 ]
 }

Ahora, debemos agregar los valores de retorno que vemos en la tabla JSONPath para que quede más claro.

$ -> Tienda Acme
 @ -> [
 {
 "nombre": "Tienda Acme",
 "total": 1000000,
 "Artículo superior":

 { "price": "50", "description": "Yunque" }
 }
 ]
 . -> Ingresos mensuales
 ..-> 50

 -> ["Tienda Acme", "El puesto de plátanos", "Pizza Planet"]
 [] -> Tienda Acme
 [,] -> [
 Macro desconocida: { "nombre"}
 ,

 Macro desconocida: { "nombre"}
 ]

 **Cambie el ejemplo de [start:end:step] a "$.stores[1:3:1]"
 [inicio:fin:paso] -> [
 {
 "nombre": "El puesto de plátanos",
 "total": 250000,
 "Artículo superior":

 { "price": "4", "description": "El Gob" }
 },
 {
 "nombre": "Planeta Pizza",
 "total": 80000,
 "Artículo superior":

 { "precio": "15", "descripción": "Pepperoni" }
 }
 ]

 ?() -> [{
 "nombre": "Tienda Acme",
 "total": 1000000,
 "Artículo superior":

 { "price": "50", "description": "Yunque" }
 }]

 () -> [
 {
 "nombre": "Planeta Pizza",
 "total": 80000,
 "Artículo superior":

 { "precio": "15", "descripción": "Pepperoni" }
 }
 ]

Ejemplo de API en Node Javascript

El siguiente ejemplo es una plantilla básica que puede seguir al formatear los datos de su Evento .

Atención :La configuración de un Evento JSON requiere conocimientos avanzados de programación. Si bien nuestro equipo de soporte estará encantado de ayudar con los aspectos básicos de la introducción de información en el evento, no podemos brindar asistencia en los aspectos de programación. Siempre puedes intentar preguntarnos Comunidad de usuarios dedicados en cambio.
var solicitud = require('solicitud-promesa');
 var surveyId = "SV_XXXXXXXXXXXX";
 var triggerId = "OC_XXXXXXXXX";
 var brandId = "SU_ID_DE_MARCA";
 var id_usuario = "UR_XXXXXXXXXXXXXXX";
 var centro de datos = "xx1";
 var apiToken = "SU_TOKEN_API_QUALTRICS";

 var url = "https://" + datacenter + "qualtrics/inbound-event/v1/ evento/ JSON/activadores" +
      "?contextId=" + surveyId + "&userId=" + userId + "&brandId=" + brandId + "&triggerId=" + triggerId;
 var carga útil = {
     "text": "Esto es un texto",
     "objeto": {
         "número": 4
     },
     "matriz": ["a", "b", "c", "d"]
 };

 var opciones = {
     url: url,
     json: verdadero,
     cuerpo: carga útil,
     encabezados: {
         "Content-Type": "application/ json", // ¡¡¡REQUERIDO!!!
        "X- API-TOKEN": apiToken
     }
 };

 solicitud.post(opciones).then(función (ret) {
     console.log("éxito:", url, carga útil);
 }).catch(función (err) {
     console.log("error: ", url);
     consola.log(err);
 });

Ejemplo: Integración con Freshdesk

Consejo Q: Esto es independiente de la tarea de Freshdesk .

El Evento JSON se puede utilizar para integrarse con Freshdesk como una regla de webhook en Dispatch’r. Esto significa que los eventos en Freshdesk pueden luego activador tareas en Qualtrics, como la creación de un ticket o la distribución de una encuesta.

Consejo Q: El Soporte técnico de Qualtrics puede ayudarlo a configurar su Evento JSON y conectarlo a través de Freshdesk. Sin embargo, es posible que existan algunas preguntas sobre la funcionalidad de Freshdesk que no puedan responder. Si tiene preguntas sobre el lado de Freshdesk, intente consultar su documentación sobre Reglas del despachador .
  1. En Qualtrics, configure su Evento a Evento JSON .
    seleccionando el evento JSON
  2. Copiar la URL.
    haciendo clic en copiar URL en el evento JSON
  3. En una nueva pestaña, inicie sesión en Freshdesk.
  4. En el Administración sección, navegue hasta la opción que mejor se ajuste al tipo de regla que desea establecer.
    Tres opciones diferentes en la parte superior de la sección de productividad del servicio de asistencia técnica cuando hace clic en el engranaje de administración en la barra lateral de la izquierda

    Consejo Q: Aprenda la diferencia entre el Despachador, Supervisor y Observador r en la documentación de soporte de Freshdesk.
  5. Crear una nueva regla.
    Botón Nueva regla en negro en la esquina superior derecha
  6. Establezca condiciones para determinar qué evento de Freshdesk debe activador una tarea en Qualtrics.
    El nombre es Qualtrics CSAT, la descripción es Encuesta enviada cuando se resuelve el ticket . Conjunto de condiciones para el ejemplo dado aquí, Estado resuelto. Acción expandida para que se muestre el webhook de Activador

    Ejemplo: Tal vez cuando un Freshdesk Agente hace que el boleto sea El estado cambia de cualquier estado a Resuelto , le gustaría enviar una encuesta CSAT utilizando Qualtrics.
  7. Añade una nueva acción y selecciona Gancho web de Activador .
    La acción tiene un menú expandido con el webhook de activador resaltado
  8. Establecer el Tipo de solicitud a CORREO .
    El campo de tipo de solicitud dice POST y la URL de devolución de llamada tiene la URL del evento JSON
  9. En URL de devolución de llamada , pegue la URL del Evento JSON del paso 2.
  10. Para utilizar la autenticación de token, agregue encabezados personalizados, ingrese X- API-TOKEN: y configúrelo igual a su token de API .
    En el cuadro de encabezado personalizado, dice X- API-TOKEN: y luego un token de API difuminado.
  11. Para utilizar la autenticación básica HTTP, haga clic en Requiere autenticación , agregue su nombre de usuario de Qualtrics y luego, en lugar de su contraseña, ingrese su token de API .
    Autenticación básica: requiere que se haya seleccionado la autenticación y se haya completado la información mencionada anteriormente
  12. Asegúrese de que Codificación es JSON .
    La codificación es json y el correo electrónico del solicitante se selecciona del cuerpo.
  13. Seleccione manualmente el contenido que desea omitir o elija Avanzado para ingresar un cuerpo JSON .
  14. Guarda tu regla.
  15. En Qualtrics, finalice su flujo de trabajo. En este ejemplo, probablemente agregaríamos un Enviar encuesta por correo electrónico o Enviar encuesta por mensaje de texto (SMS).
    En la ventana de selección de tarea , busqué enviar una encuesta y apareció una opción para correo electrónico y mensaje de texto.
  16. No te olvides de publicar Su encuesta cambia cuando esté listo para lanzarla.
Consejo Q: Para obtener más información sobre Freshdesk Webhooks , consulte la documentación vinculada en su sitio de soporte.

Ejemplo: Integración con ServiceNow

Consejo Q: Esto es independiente de la Tarea de ServiceNow .

El Evento JSON se puede utilizar para integrarse con ServiceNow. Esto significa que los eventos en ServiceNow pueden luego activador tareas en Qualtrics, como la creación de un ticket o la distribución de una encuesta.

Consejo Q: El Soporte técnico de Qualtrics puede ayudarlo a configurar su Evento JSON y conectarlo a través de ServiceNow. Sin embargo, es posible que existan algunas preguntas sobre la funcionalidad de ServiceNow que no puedan responder. Si tiene preguntas sobre cómo iniciar sesión y activar su instancia de desarrollador de ServiceNow, intente consultar su documentación sobre Instancias de desarrollador personal .
  1. En Qualtrics, configure su Evento a Evento JSON .
    seleccionando el evento JSON
  2. Copiar la URL.
    haciendo clic en copiar URL en el evento JSON
  3. En una nueva pestaña, inicie sesión en su instancia de desarrollador de ServiceNow.
  4. Seleccionar Mensaje REST .
    elegir un mensaje REST
  5. Hacer clic Nuevo.
  6. Ponle un nombre a tu mensaje de rest .
    Dar un nombre al mensaje, especificar el punto final y elegir el tipo de autenticación
  7. En el Punto final campo, pegue la URL que copió en el Paso 2.
  8. Cambiar el tipo de autenticación a Básico .
  9. Ir a la Solicitud HTTP pestaña.
    Eligiendo la solicitud HTTP y agregando el X- API-TOKEN
  10. Haga doble clic para agregar X- API-TOKEN .
  11. Haga doble clic para pegar su token de API .
    pegando el token de API
  12. En una nueva fila, agregue el nombre Tipo de contenido .
  13. Establezca el valor en aplicación/ json .
  14. Haga clic en Enviar.
    haciendo clic en Enviar
  15. Vuelve a abrir tu mensaje de Rest .
    abriendo el mensaje de rest
  16. En Métodos HTTP, haga clic en Nuevo .
    haciendo clic en Nuevo
  17. Dale un nombre al método.
    Configurar el método HTTP y darle un nombre
  18. Establezca el método HTTP en CORREO .
  19. Establezca el tipo de autenticación en Heredar del padre .
  20. Haga clic en Enviar.
  21. Vuelva a abrir el método POST HTTP que acaba de crear.
    abriendo el método POST
  22. En la parte inferior de la página, seleccione Vista previa del uso del script .
    copiando el texto
  23. Copiar el texto.
  24. Buscar y seleccionar Reglas de negocio .
    Servicio ahora. Reglas de negocio buscadas y seleccionadas a la izquierda. Nuevo botón superior en verde azulado, centro
  25. Seleccionar Nuevo .
  26. Seleccione una tabla.
    Campos vitales resaltados en rojo en la página
  27. Seleccionar Avanzado .
  28. Determinar cuándo se ejecuta la regla de negocio.
    Ejemplo: Si ha seleccionado Incidente para su tabla y desea enviar una encuesta de CSAT para los tickets resueltos, puede agregar una condición que indique que esta regla debe ejecutarse cuando Estado del incidente cambios a Resuelto .
    Consejo Q: El Soporte técnico de Qualtrics puede ayudarlo a configurar su Evento JSON y conectarlo a través de ServiceNow. Sin embargo, es posible que existan algunas preguntas sobre la funcionalidad de ServiceNow que no puedan responder. Si tiene preguntas sobre cómo/cuándo se ejecutan las reglas comerciales, consulte la documentación de ServiceNow en Cómo funcionan las reglas de negocio .
  29. Ir a la Avanzado pestaña.
    Pestaña Avanzada abierta y cuerpo JSON resaltado. Botón de enviar en la parte inferior
  30. Pegue el contenido que copió del Paso 22 donde dice Añade tu código aquí .
    pegando el contenido
  31. Añade un cuerpo. Aquí es donde usted comunica la información que desea transmitir a Qualtrics.
    añadiendo un cuerpo

    Ejemplo: Este es un ejemplo del código final que incluirías en este campo. La mayor parte de este código es el mensaje saliente proporcionado por ServiceNow y variará de un ejemplo a otro. Lamentablemente, el Soporte técnico de Qualtrics no puede ayudarlo con ninguna codificación personalizada; si tiene problemas con su código, comuníquese con Comunidad de ServiceNow para solicitar ayuda.

    La parte en negrita del código incluye tres funciones adicionales no incluidas en el código original: un cuerpo JSON que extrae el ID del usuario y el estado del incidente, y una llamada que recupera la dirección de correo electrónico del cliente del incidente para que se le pueda enviar el CSAT (en cursiva a continuación). Ver Documentación de ServiceNow y consultar a sus comunidad Si tienes preguntas adicionales.

    (función ejecutarRule(actual, anterior /*nulo cuando es asíncrono*/) {
    
         // Añade tu código aquí
        
      intentar {
          var r = new sn_ws.RESTMessageV2(' Evento JSON de Qualtrics ', ' Evento JSON POST');
          var cuerpo = {
              "ID de usuario": gs.getUserID()
              "estado del incidente": current.state.getDisplayValue()
          };
         
         var objetivo = nuevo GlideRecord('sys_user');
          objetivo.addQuery('sys_id', '=', current.caller_id);
          objetivo.query();
          mientras(objetivo. siguiente()) {
              cuerpo["correo electrónico"] = objetivo.correo electrónico.getDisplayValue();
          }  
     var respuesta = r.execute();
          var cuerporespuesta = respuesta.getBody();
          var httpStatus = respuesta.getStatusCode();
          gs.addInfoMessage(httpStatus);
         }
     captura(ex) {
          var mensaje = ex.mensaje;
          gs.addInfoMessage("Error al comunicarse con Qualtrics " + mensaje);
    
     }
    
     })(actual, anterior);
  32. Añade el cuerpo a la solicitud. Agregue lo siguiente debajo de la parte en negrita y cursiva del código del paso anterior:
     r.setRequestBody(JSON.stringify(cuerpo)); 
  33. Haga clic en Enviar.
  34. En Qualtrics, finalice su flujo de trabajo. Para continuar con el ejemplo de la encuesta CSAT, probablemente agregaríamos una Enviar encuesta por correo electrónico o Enviar encuesta por mensaje de texto (SMS).
    En la ventana de selección de tarea , busqué enviar una encuesta y apareció una opción para correo electrónico y mensaje de texto.
  35. No te olvides de publicar Su encuesta cambia cuando esté listo para lanzarla.

Ejemplo: Integración con Microsoft Dynamics a través de Microsoft Flow

Consejo Q: Esto es independiente de la Tarea de Microsoft Dynamics .

El Evento JSON hace que los eventos en Microsoft Dynamics puedan luego activador tareas en Qualtrics, como la creación de un ticket o la distribución de una encuesta. Por ejemplo, cada vez que elimina un registro de cuenta en Microsoft, puede distribuir una encuesta de Qualtrics al propietario de la cuenta que haga preguntas de salida (por ejemplo, ¡Lamentamos que se vaya!). ¿Cómo estuvo tu tiempo con nosotros? ¿Cómo podemos mejorar?)

Para integrar el Evento JSON con acciones que ocurren en Microsoft Dynamics, en realidad necesita realizar la configuración dentro de Microsoft Flow en lugar de Dynamics. No se preocupe: Microsoft Flow viene gratis con cada cuenta de Microsoft Dynamics, por lo que puede iniciar sesión en Flow con su información de Dynamics. aquí .

Consejo Q: El Soporte técnico de Qualtrics puede ayudarlo a configurar su Evento JSON y conectarlo a través de Microsoft Flow y Microsoft Dynamics. Sin embargo, es posible que existan algunas preguntas sobre la funcionalidad de Microsoft que no puedan responder. Si tiene preguntas sobre el lado de Microsoft, intente consultar su documentación. Fluir y sus recurso para Dinámica .
  1. En Qualtrics, configure su Evento a Evento JSON .
    seleccionando el evento JSON
  2. Copiar la URL.
    haciendo clic en copiar URL en el evento JSON
  3. En una pestaña separada, vaya a https://us.flow.microsoft.com/en-us/ y use su información de Microsoft Dynamics para iniciar sesión en Flow.
  4. Seleccionar Mis flujos A la izquierda.
    Esquina superior izquierda de Microsoft Flow, mis flujos seleccionados de la tercera opción del menú de la izquierda y el nuevo botón en la parte superior hecho clic y expandido para mostrar automatizado desde la tercera opción en blanco en la lista
  5. Hacer clic Nuevo y seleccione Automatizado – desde cero .
  6. Nombra el flujo.
    Construya una ventana de flujo automatizada. imagen e instrucciones a la izquierda, pasos descritos a la derecha de la ventana que desciende por la línea.
  7. Seleccione un activador. Este es el evento que ocurre en Microsoft que iniciará la tarea en Qualtrics. Puede elegir lo que mejor se adapte a sus necesidades, pero para este ejemplo elegiríamos “Cuando se elimina un registro (Dynamics 365)”.
  8. Hacer clic Crear .
  9. Bajo Nombre de la Organización , inicie sesión en su cuenta de Dynamics.
    Ampliación de la imagen cuando se elimina un registro con los campos de nombre de la organización y nombre de la entidad directamente debajo. Botón de nuevo paso en la parte inferior, a la izquierda del centro.
  10. Bajo Nombre de la entidad , elija el tipo de registro o archivo. Para nuestro ejemplo, utilizaríamos “Cuentas”.
  11. Hacer clic Siguiente paso , y seleccione Agregar una acción .
  12. Seleccionar HTTP .
    http y opciones expandidas
  13. Cambiar el Método a CORREO .
  14. Pegue la URL de su Evento JSON en el Dirección URL campo.
  15. Utilice autenticación de token. Bajo Encabezados , ingresar X- API-TOKEN y en el campo de al siguiente , pega tu token de API .
  16. Bajo Cuerpo , puedes ingresar un cuerpo JSON . Esto le ayuda a decidir la información que desea pasar de Dynamics a Qualtrics.
    Consejo Q: Utilice el Añadir contenido dinámico Botón para seleccionar los campos de registro de Dynamics que desea transferir a Qualtrics. Asegúrese de seguir el formato JSON adecuado, como se muestra en la captura de pantalla. Para obtener ayuda para solucionar problemas de contenido dinámico, comuníquese con Soporte técnico de Microsoft .
  17. Cuando haya terminado, haga clic en Ahorrar .
  18. En Qualtrics, finalice su flujo de trabajo. En este ejemplo, probablemente agregaríamos un Enviar encuesta por correo electrónico o Enviar encuesta por mensaje de texto (SMS).
    En la ventana de selección de tarea , busqué enviar una encuesta y apareció una opción para correo electrónico y mensaje de texto.
  19. No te olvides de publicar Su encuesta cambia cuando esté listo para lanzarla.
Consejo Q: Se prefiere Microsoft Flow para estos pasos porque puede enviar más información a Qualtrics en el cuerpo JSON . Si configura esto dentro de Microsoft Dynamics en lugar de Flow, solo los campos modificados durante el evento de Dynamics se enviarán a Qualtrics. Por ejemplo, si elige activador en función de una actualización de registro y solo se cambia un campo de “correo electrónico”, el “nombre” y la “dirección” no se enviarán a Qualtrics, incluso si solicita específicamente esos campos en el cuerpo. Flow enviará todo lo que usted solicitó a Qualtrics, independientemente de si ese campo se modificó en el evento desencadenante.

Ejemplo: Integración con Genesys PureCloud

Consejo Q: Para configurar esta integración, debe tener acceso a Genesys Cloud Architect y Genesys Web Service Data Actions.

Al utilizar eventos JSON , puede integrarse con Genesys PureCloud para enviar a los clientes una encuesta de seguimiento después de completar una interacción de soporte telefónico o de chat.

  1. Ir a la Página de Flujos de trabajo globales.
    Al hacer clic en crear un flujo de trabajo y luego en basado en evento
  2. Crear un nuevo flujo de trabajo basado en eventos .
  3. Para el evento de flujo de trabajo , seleccione el JSON evento.
    elegir el evento JSON
  4. Hacer clic Copiar URL para copiar el punto final del evento a su portapapeles.
    haciendo clic en copiar URL
  5. Sin cerrar la ventana del Evento JSON , abra una nueva pestaña en su navegador y navegue hasta Genesys.
  6. Vaya a Admin.
    Acceder a acciones desde la pestaña de administración
  7. Hacer clic Comportamiento.
  8. Hacer clic Agregar acción .
    el botón agregar acción
  9. Seleccionar Acciones de datos de servicios web como nombre de integración.
    Darle un nombre a la integración y darle un nombre a la acción

    Consejo Q: Si no tiene la opción de seleccionar las Acciones de datos de servicios web, entonces debe habilitar la integración. Ver Esta página Para más información.
  10. Dale un toque a tu acción Acción Nombre .
  11. Haga clic en Añadir.
  12. Navegar hasta el Configuración pestaña.
    Seleccionando JSON y definiendo nuestras propiedades en la pestaña de configuración de contratos
  13. Ir a la Contratos pestaña.
  14. En Contrato de entrada, seleccione JSON .
  15. Configure las propiedades que se envían a Qualtrics.

    Ejemplo: Por ejemplo, el siguiente código pasará la dirección de correo electrónico, el número de teléfono, el nombre y el apellido.

    {
            "tipo": "objeto",
            "propiedades": {
              "dirección de correo electrónico": {
                "tipo": "cadena"
              },
              "número de teléfono": {
                "tipo": "cadena"
              },
              "nombre de pila": {
                "tipo": "cadena"
              },
              "apellido": {
                "tipo": "cadena"
              }
            },
            "Propiedades adicionales": verdadero
          }
  16. Ir a la Configuración pestaña.Cambiando la solicitud a POST y pegando nuestra url JSON
  17. Cambie el tipo de solicitud a CORREO .
  18. En el Plantilla de URL de solicitud campo, pegue la URL del Evento JSON en Qualtrics.
  19. Hacer clic Agregar encabezado.
    agregando nuestro token de API como encabezado
  20. En el Llave caja, entrar X- API-TOKEN .
  21. En el Valor casilla, ingrese su token de API de Qualtrics .
  22. Ir a la Prueba pestaña.Agregar valores de prueba antes de ejecutar una prueba
  23. Introduzca valores de prueba para sus propiedades.
  24. Hacer clic Ejecutar Acción .
  25. Genesys le informará si la acción fue exitosa. Si falla, se mostrará la respuesta de error para ayudarle a solucionar el problema.
    El mensaje de acción exitosa
  26. Regrese a su Evento JSON en Qualtrics y verifique que sus propiedades se hayan pasado a Qualtrics correctamente.Ver la carga útil de prueba y hacer clic en Guardar
  27. Haga clic en Guardar.
  28. Haga clic en el signo más ( + ) y luego Tarea Para configurar el tarea Quiere seguir cuándo se activa el evento JSON . En nuestro caso, queremos enviar una encuesta a los encuestados, por lo que seleccionamos una Enviar encuesta por correo electrónico o Enviar encuesta por mensaje de texto (SMS).Haciendo clic en el signo más y luego en la tarea
    Consejo Q: Al configurar su tarea, utilice el texto dinámico Menú para utilizar valores pasados ​​desde Genesys (por ejemplo, correo electrónico del cliente, nombre, etc.).
  29. Después de configurar la tarea en Qualtrics, regrese a Genesys y haga clic en Guardar y Publicar .
    publicando la acción
  30. Hacer clic .
  31. Vaya a Admin.Seleccionar arquitecto desde la página de administración
  32. Hacer clic Arquitecto .
  33. Seleccionar Invitación a Encuesta en el menú desplegable de flujo.Seleccionar la invitación a la encuesta desde el menú desplegable de flujo
  34. Haga clic en Añadir.Darle al flujo un nombre, una descripción y una división.
  35. Dale un toque a tu flujo Nombre , Descripción , y División .
  36. Hacer clic Crear flujo .
  37. En la sección Datos de su Caja de herramientas, seleccione Acción de datos de llamada y arrástrelo al cuadro desplegable en el flujo.Arrastrando el título Acción de datos de llamada al flujo
  38. Dale un toque a tu acción Nombre .Darle un nombre a la acción de datos de llamada, seleccionar la categoría y seleccionar la acción de datos que creamos anteriormente
  39. Para la categoría, seleccione Acción de datos de servicios web .
  40. Para Acción de datos, seleccione la acción de datos que creó anteriormente.
  41. Siguiente a cada propiedad, haga clic en el menú desplegable y seleccione Expresión .añadiendo expresiones a cada propiedad
  42. Para los valores de propiedad, ingrese qué datos se envían para cada propiedad. El cuadro completará automáticamente sus campos a medida que escribe.
    Consejo Q: Esta página tiene todas las propiedades predeterminadas incluidas en el flujo de invitación a la encuesta . También puedes utilizar expresiones complejas en situaciones donde falta información de contacto del cliente o requiere formato adicional.
    Consejo Q: La información de Contacto está precedida por Encuesta.Contacto con el cliente .
  43. Haga clic en el cuadro más abajo en su flujo.Agregar la acción de abortar la encuesta al final del flujo
  44. Seleccionar Caja de instrumento , entonces Invitaciones a Encuesta , entonces Encuesta sobre el aborto .
  45. Seleccionar optar por no participar para la Disposición.Cambiar la disposición de optar por no participar antes de publicar el flujo
  46. Haga clic en Publicar. Genesys validará el flujo y luego lo publicar . Una vez hecho esto, el flujo estará en su lugar y comenzará a enviar encuestas a los clientes cuando completen las interacciones de soporte.

Preguntas frecuentes

Muchas de las páginas de este sitio han sido traducidas del inglés original utilizando la traducción automática. Aunque en Qualtrics hemos realizado nuestra diligencia debida para obtener las mejores traducciones automáticas posibles, la traducción automática nunca es perfecta. El texto original en inglés se considera la versión oficial, y cualquier discrepancia entre el inglés original y las traducciones automáticas no son legalmente vinculantes.