Evento de Twilio Segment

Acerca de Twilio Segment Events

El evento Twilio Segment le permite integrar Qualtrics con Twilio Segment para enviar datos a Qualtrics basados en eventos en Twilio Segment. El evento Segmento Twilio admite 3 casos de uso principales:

1. Inicio de un workflow basado en eventos de datos en el segmento Twilio.
2. Actualización de la información de contacto en XM Directory basada en eventos en Twilio Segment.
3. Añadir datos de transacción a un contacto basado en eventos en el segmento Twilio.

Configuración de un evento de segmento Twilio

Para utilizar el evento Segmento Twilio, debe completar una configuración tanto en Segmento Twilio como en Qualtrics. Debe añadir Qualtrics como destino de webhook en su instancia de Twilio Segment. En esta sección se tratará la configuración de la integración inicial con Twilio Segment.

Para configurar la conexión, necesitará los siguientes ID de Qualtrics:

• Su token de API (si ya tiene un token, no genere uno nuevo)
• Su ID de centro de datos
• Si añade o actualiza contactos en XM Directory, el ID de directorio del directorio en el que desea guardar sus contactos.

Conexión al segmento Twilio

1. En la pestaña Workflows, haga clic en Crear un workflow.
   
2. Seleccione Iniciado cuando se recibe un evento.
3. Seleccione el evento Twilio Segment.
   
4. En una pestaña separada del navegador, inicie sesión en Segmento Twilio. No cierre Qualtrics.
5. Vaya a la ficha Conexiones.
   
6. Haga clic en Añadir destino.
7. Busque la conexión de Qualtrics y agréguela a su área de trabajo. Haga clic en él para empezar a configurar la conexión.
8. Asigne un nombre a la conexión. Este nombre es para sus propios fines organizativos.
9. Introduzca su token de API de Qualtrics. Consulte Generación de un token de API si necesita ayuda para buscar su token.
10. Introduzca su ID de centro de datos de Qualtrics. Consulte Localización del ID del centro de datos si necesita ayuda para encontrar su centro de datos.
11. Asegúrese de que Activar destino esté activado.
12. Haga clic en Guardar cambios.
13. En la pestaña Asignaciones, haga clic en Nueva asignación.
14. Elija lo que le gustaría hacer:
    
    • Crear y/o actualizar un contacto en XM Directory: Añada o actualice un contacto en XM Directory en función de los eventos de datos en Twilio Segment. Todos los contactos procesados por este evento se deduplicarán según la configuración de su directorio. Consulte Añadir o actualizar contactos en XM Directory para el resto de la configuración de esta opción.
    • Actualizar/insertar transacción de contacto: Añadir datos de transacción a un contacto. Si el contacto no existe, se creará el contacto y, a continuación, los datos de transacción se añadirán a ese contacto. Consulte Añadir transacciones a contactos para el resto de la configuración de esta opción.
    • Iniciar un workflow en Qualtrics: iniciar un workflow de Qualtrics basado en eventos de datos en Twilio Segment. Consulte Desencadenar un flujo de trabajo de Qualtrics para el resto de la configuración de esta opción.
      Consejo Q: Puede utilizar todas estas opciones si lo desea. Solo tendrá que crear asignaciones adicionales después de configurar el primero.

Añadir o actualizar contactos en XM Directory

El evento Segmento Twilio le permite actualizar contactos en XM Directory en función de las modificaciones de sus datos en Twilio Segment.

1. Siga las instrucciones en Configuración de un evento de segmento Twilio para integrar Qualtrics con Twilio Segment. Seleccione la opción Crear y/o actualizar contacto en XM Directory al configurar la integración.
2. Añada cualquier condición de filtro que desee. Estas condiciones determinan cuándo se envían los datos a Qualtrics.
   
   Consejo Q: De forma predeterminada, esta integración incluye automáticamente una condición para “Tipo de evento” es “Identificar”. Puede modificar este filtro o añadir nuevos según sea necesario. Le recomendamos que incluya al menos 1 filtro para limitar los datos que se envían a Qualtrics.
3. Si lo desea, utilice la sección Agregar evento de prueba para probar qué campos se pueden incluir en sus asignaciones.
4. En la sección Seleccionar asignaciones, asigne su ID de directorio de Qualtrics. Si tiene varios directorios, seleccione el directorio al que desea añadir contactos. Consulte Localizar el PoolID para obtener más información. 
5. Si lo desea, ajuste las asignaciones de campo de evento. Consulte esta página de soporte técnico de Twilio para obtener más información. A menudo no necesitará realizar ningún ajuste en las asignaciones preconfiguradas.
6. Haga clic en Guardar.

Añadir transacciones a contactos

El evento Segmento Twilio le permite añadir datos de transacción a contactos existentes en su XM Directory. Si el contacto aún no existe en su directorio, se creará. Los datos de transacción se grabarán en el contacto recién creado.

1. Siga las instrucciones en Configuración de un evento de segmento Twilio para integrar Qualtrics con Twilio Segment. Seleccione la opción Actualizar/insertar transacción de contacto al configurar la integración.
2. Añada cualquier condición de filtro que desee. Estas condiciones determinan cuándo se envían los datos a Qualtrics.
   Consejo Q: De forma predeterminada, esta integración incluye automáticamente una condición para “Tipo de evento” es “Seguimiento” y “Nombre de evento” es “Transacción creada”. Puede modificar este filtro o añadir nuevos según sea necesario. Le recomendamos que incluya al menos 1 filtro para limitar los datos que se envían a Qualtrics.
3. Si lo desea, utilice la sección Agregar evento de prueba para probar qué campos se pueden incluir en sus asignaciones.
4. En la sección Seleccionar asignaciones, asigne su ID de directorio de Qualtrics. Si tiene varios directorios, seleccione el directorio al que desea añadir contactos. Consulte Localizar el PoolID para obtener más información.
5. Si lo desea, ajuste las asignaciones de campo de evento (por ejemplo, si hay campos adicionales que desea transferir a Qualtrics). Consulte esta página de soporte técnico de Twilio para obtener más información. A menudo no necesitará realizar ningún ajuste en las asignaciones preconfiguradas.
6. Haga clic en Guardar.

Desencadenar un workflow de Qualtrics

El evento Segmento Twilio le permite iniciar un workflow en Qualtrics basado en eventos de datos en Segmento Twilio.

1. Siga las instrucciones en Configuración de un evento de segmento Twilio para integrar Qualtrics con Twilio Segment. Seleccione la opción Iniciar un workflow en Qualtrics al configurar la integración.
2. Añada cualquier condición de filtro que desee. Estas condiciones determinan cuándo se envían los datos a Qualtrics.
   
   Consejo Q: le recomendamos que incluya al menos 1 filtro para limitar los datos que se envían a Qualtrics.
3. Utilice la sección Agregar evento de prueba para generar una asignación de campo de prueba.
   Consejo Q: Necesitará al menos 1 condición de filtro para generar un evento de prueba.
4. En Qualtrics, vuelva al evento Twilio Segment. Haga clic en Copiar URL.
5. Vuelva al Segmento Twilio. En la sección Seleccionar asignaciones, pegue la URL copiada en el campo API HTTP para asignarla a su URL de flujo de trabajo.
6. Si lo desea, ajuste las asignaciones de los campos que desea transferir a Qualtrics. En la columna de la izquierda, introduzca el nombre del campo como desea que aparezca en Qualtrics.
7. En la columna de la derecha, seleccione la variable de evento que desea pasar a Qualtrics haciendo clic en la casilla y seleccionando un campo.
8. Active Mostrar vista previa de registro de prueba.
   Consejo Q: No podrá activar esta opción si no generó la asignación de prueba anteriormente. Desplácese hacia arriba hasta la sección Agregar evento de prueba para generar la asignación de prueba.
9. Resalte el payload de evento JSON y cópielo.
10. Haga clic en Guardar.
11. Vuelva al evento Twilio Segment en Qualtrics. Vaya a la sección Opciones avanzadas.
12. Pegue el payload de evento JSON que ha copiado anteriormente en el campo de objeto JSON.
13. Haga clic en Agregar asignación de campos. Sus campos se asignarán automáticamente en función del payload JSON.
14. Vaya a la sección Campos de mapa y verifique que los campos estén asignados correctamente. Puede ajustar sus campos según sea necesario.
15. Para la Vía de acceso, introduzca los nombres de vía de acceso del segmento Twilio para los campos que desea guardar en Qualtrics.
16. Para el Tipo, seleccione el tipo de datos que contiene el campo:
    • Cadena: Los datos son una cadena de texto.
    • Número: Los datos son un valor numérico.
    • Booleano: Los datos son un valor booleano (es decir, verdadero o falso).
17. Haga clic en Añadir un campo para asignar campos adicionales.
18. Haga clic en el signo menos ( – ) para eliminar un campo de la asignación.
19. Si lo desea, puede probar la integración para verificar si los datos correctos se transfieren a Qualtrics haciendo clic en Ejecutar datos de prueba y luego iniciando un evento desde Twilio Segment. Consulte Captura de datos de evento para obtener más información.
    Consejo Q: Consulte la sintaxis JSONPath para obtener más ayuda sobre cómo interpretar su JSON.
20. Haga clic en Guardar.
21. No olvide añadir una tarea a su workflow. Por lo general, se trata de una tarea de XM Directory para distribuir una encuesta.
    Consejo Q: Si desea guardar o actualizar la información de contacto, consulte Añadir o actualizar contactos en XM Directory.
    Ejemplo: Supongamos que un cliente completa su nuevo recorrido de incorporación de usuarios, que actualiza su registro en Twilio Segment. Este cambio de datos puede desencadenar un flujo de trabajo de Qualtrics, que podemos utilizar para distribuir una encuesta al cliente pidiéndole que proporcione comentarios sobre su experiencia de incorporación.