Please log in to continue
WalkMe stores your data in the region chosen during account setup.
We have data centers in the US and EU that follow local privacy and compliance laws. If you're not sure which region to select, check with your admin.
Con la API de notificaciones del menú de escritorio/móvil, puedes utilizar eventos en cualquier sistema (incluso si no tiene un fragmento de WalkMe) para activar una notificación en WalkMe y mantener automáticamente actualizados a tus usuarios. Activa notificaciones del menú con una llamada REST a nuestro Webhook de notificación de WalkMe.
Este artículo proporcionará la información necesaria para realizar la llamada REST, que requiere un token de autenticación y una carga útil JSON.
Cualquier sistema que pueda llamar a una API REST se puede utilizar para activar notificaciones en el menú de escritorio o móvil.
Llamar a la API requiere algunos permisos y configuración técnica. Asegúrate de que tienes acceso y puedes hacer lo siguiente:
Esto es lo que necesitas de WalkMe para activar la API. A continuación se muestran los pasos sobre cómo recopilar todo.
Específicamente, encontrarás la información necesaria para utilizar un JSON de notificación con la siguiente información:
¿Qué es un token de acceso?
Un token de acceso es una credencial que puede ser utilizada por una aplicación para acceder a una API. Informan a la API que el portador del token ha sido autorizado a acceder a una acción en particular.
El token de acceso autentica la llamada a la API, lo que permite a la aplicación pasar datos de su sistema al menú.
Desde el panel Crear nueva clave:
Desde el panel Detalles clave:
Para obtener soporte adicional y obtener el token de autorización: página del desarrollador.
Ve al Centro de comunicaciones y crea una plantilla personalizada (aprende a crear una notificación). Hay algunas cosas que debes tener en cuenta para la notificación que creas para la API:
En el caso de que desees que una notificación sea personalizada, ya sea para el usuario o para el evento que se está activando, puedes añadir valores dinámicos que la API completará automáticamente.
En la imagen, hay dos ejemplos de valores que se sobrescriben con texto dinámico que se reemplazará dependiendo de los valores que la API desencadene.
Este es un ejemplo de notificación de API con Salesforce que se activa cuando se ha asignado un nuevo lead. Notificará al vendedor el nombre de la oportunidad y lo vinculará al cliente potencial en Salesforce.
Nota: el nombre del valor (ejemplo: OPP_NAME_ATTRIBUTE) debe copiarse exactamente en el JSON para que pueda ser reemplazado.
Los siguientes pasos conectarán la notificación con la API.
Para soporte adicional, página de desarrollador.
Ahora es el momento de introducir algo de información sobre la aplicación de conexión a API. Para mayor claridad, utilizamos Zapier para explicar, pero no estamos respaldando esta aplicación sobre ninguna otra. Cualquier aplicación similar funcionará.
La información que se utiliza a continuación es universalmente necesaria en todas las aplicaciones:
Añade autenticación básica
Al utilizar la autenticación básica, el ID del cliente es el nombre de usuario y el secreto del cliente se utiliza como contraseña.
Una vez que hayas añadido esta información, se te dará un token de acceso.
Ahora es el momento de rellenar los espacios en blanco y utilizar el código JSON que llamará a la notificación.
|
{ "notificación": { "systemId": "<el identificador del sistema de la estación de trabajo>", //Obligatorio si tienes más de un sistema de estaciones de trabajo. "templateId": "<id de plantilla>", //Requerido "endUsersIds": ["<ID del usuario final 1>","<ID del usuario final 2>","<...>"], //Necesitas el ID del usuario final o el ID de la audiencia (puedes utilizar ambos), elimina el que no estás utilizando. "audiencesIds": ["<ID de audiencia 1>","<ID de audiencia 2>","<...>"], //Necesitas el ID del usuario final o el ID de la audiencia (puedes utilizar ambos), elimina el que no estás utilizando. "notificationType": "<cómo se mostrará la notificación, push v ventana emergente>", //Opcional, push predeterminado, elimina si no estás utilizando "title": "<el título de la notificación tal y como aparece en la tabla de notificaciones de ComCenter>", //Opcional, elimina si no se utiliza. "runtimeTitle": "<lo que aparecerá para los usuarios finales en la lista de Workstation y en la notificación push>", //Opcional, elimina si no se utiliza. "runtimeDescription": "<lo que aparecerá a los usuarios finales i en la lista de Estaciones de trabajo y en el mensaje push>", //Opcional, elimina si no estás utilizando "startAt": "<fecha de inicio AAAA-MM-DD hh:mm>", // Opcional, predeterminado en este momento, la zona horaria es UTC, puedes añadir una fecha y no una hora, el tiempo predeterminado es 00:00 UTC, elimina lo que no estés utilizando "finAt": "<fecha de finalización AAAA-MM-DD hh:mm>", // Opcional, por defecto 30 días a partir de ahora, puedes añadir una fecha y no una hora, el tiempo predeterminado es 00:00, elimina lo que no estés utilizando "sobrescribir": [ { // Pueden seguir más pares separados {key:value}por comas. // Por ejemplo, el valor podría ser una URL que se pasa desde ServiceNow para abrir un ticket. ] } } |
Aquí hay un ejemplo del código JSON con datos reales con pocas líneas eliminadas para hacerlo más simple.
| { "notificación": { "systemId": "bcf4c7f5682b4aa6875a0fc9bdfa21ca", "templateId": "1e5afe51-2d2a-4b22-a60a-cf2d6c01d726", "endUsersIds": ["name@email.com"], "runtimeTitle": "Prueba API 3", "notificationType": "Push", "anulación": [ ] {"clave": "URL", “value”: “www.someurl.com”} ] } } |
Ahora que tenemos la información que necesitamos, conectemos los puntos. Para realizar la llamada (conectar los sistemas para crear y publicar nuevas notificaciones en el menú de escritorio o móvil de la organización), necesitarás tu JSON más:
