Cómo enviar datos de eventos de WalkMe a sistemas de terceros utilizando Webhooks.

Breve descripción general

Toma decisiones basadas en datos en tiempo real o activa experiencia al instante creando y personalizando Webhooks (también conocidas como callbacks) para enviar datos de eventos de WalkMe a sistemas de terceros que utilices para generar resultados específicos.

Las Webhooks web entregan información de eventos de WalkMe en tiempo real al sistema de tu elección, impulsada por el propio evento. Esto significa Recibes la información de inmediato, para que tus equipos puedan tomar medidas inmediatas sobre la información sensible al tiempo.

Las Webhooks se pueden utilizar para añadir datos de eventos de WalkMe a la herramienta de análisis o de BI, o para activar API de terceros. Ahora, cuando un usuario haga clic en un ShoutOut, puedes añadirlo a una lista de correo en tu sistema de marketing o cuando responda a una encuesta de NPS, puedes enviar una notificación instantánea a un canal de Slack. Con los webhooks, WalkMe se puede integrar directamente en los flujos de trabajo, sin necesidad de esfuerzo de I+D.

Para obtener más información sobre las Webhooks, consulta el siguiente artículo: ¿Qué son las Webhooks?

Casos de uso

• Integrar los datos de eventos de WalkMe en tu herramienta de análisis o BI
• Añadir usuarios a una lista de correo electrónico directamente cuando un usuario interactúa con WalkMe
• Envía notificaciones instantáneamente a los canales de Slack después de que los usuarios realicen una acción

Pasos para enviar datos de WalkMe utilizando Webhooks

1. 1. Ve a la página de Integraciones en Insights en insights.walkme.com
      
   2. Haz clic en Webhooks en Integraciones en tiempo real
      
   3. Haz clic en + NUEVA WEBHOOK
      
   4. Dale un nombre a tu webhook y haz clic en CONTINUAR
   5. Introduce los detalles del evento webhook
      1. Selecciona un evento de WalkMe en el menú desplegable Eventos
      2. Añade condiciones opcionales
         • Al enviar un webhook basado en un paso de SWT, se deben enviar dos eventos al servidor del cliente:
           1. Cuando el paso aparece en el entorno
           2. Cuando se completa el paso (cerrado, procesado, fallado, etc.)
         • Para ello, añade reglas de estado de paso a la condición del webhook, como se muestra en la imagen:
      3. En la sección desplegable Avanzado> puedes especificar cuáles propiedades del evento que has elegido deseas configurar.
         • Puedes cambiar el nombre de las propiedades para que coincidan con los atributos esperados del sistema de destino.
         • Si no les cambias el nombre, estos son los valores que recibirás en la llamada al webhook.
         • También puedes establecer propiedades estáticas adicionales para enviarlas junto con la llamada a las Webhooks utilizando el botón + AÑADIR PROPIEDAD.
           • No se permiten espacios en el nombre de la propiedad.
           • Recomendamos separar las palabras utilizando "_" o estilo camelCase.
   6. Haz clic en Continuar
   7. Introduce los detalles de destino del webhook
      1. Introduce el nombre de la plataforma de destino
         • Esta es la plataforma de terceros a la que deseas que se envíen los datos de eventos, por ejemplo, a Heap Analytics, Mixpanel o Google Analytics
      2. Introduce el tipo de solicitud y la URL de destino
         • Estos especifican cómo realizar la llamada al webhook y dónde
         • Estos detalles se pueden encontrar en la documentación de la API del sistema de destino
      3. Selecciona un tipo de autenticación opcional
         • Consulta la documentación de la API del sistema de destino para comprender si esto es necesario
         • WalkMe admite los siguientes métodos de autenticación:
           • Sin autenticación
           • Token Bearer: requiere un token.
           • Autenticación básica: requiere un nombre de usuario y una contraseña
           • OAuth 2.0
      4. Introduce los encabezados opcionales utilizando el botón + AÑADIR PROPIEDAD.
         • Estos son los valores necesarios para realizar la llamada al webhook
         • Consulta la documentación de la API del sistema de destino para comprender si esto es necesario
   8. Haz clic en Guardar
   9. Se te pedirá que realices una publicación de configuraciones en el Editor.
      • Este paso solo es necesario para el primer webhook que crees
      • Para obtener más información, consulta el siguiente artículo: Cómo publicar configuraciones globales

Para verificar que hayas configurado el webhook correctamente, sigue estos pasos:

1. Accede a tu aplicación
2. Lleva a cabo el evento que la Webhook está rastreando
3. Comprueba que el sistema de destino que has configurado recibe la llamada a la Webhook y ejecuta el resultado deseado

Lista de eventos disponibles

La siguiente tabla muestra todas las opciones disponibles para crear eventos de Webhooks:

Notas técnicas

• Ten en cuenta que para el certificado proporcionado por el cliente, WalkMe requiere el uso de un certificado completo, no uno abreviado.