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 y 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 actualizados a tus usuarios de forma automática. 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.
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": "<the workstation system id>", //Obligatorio si tienes más de un sistema de estación de trabajo "plantillaId": "<template id>", //Requerido "endUsersIds": ["<end user id 1>","<end user id 2>","<...>"], //Necesitas el ID de usuario final o el ID de audiencia (puedes utilizar ambos), elimina el que no estás utilizando "audiencesIds": ["<audience id 1>","<audience id 2>","<...>"], //Necesitas el ID de usuario final o el ID de audiencia (puedes utilizar ambos), elimina el que no estás utilizando "notificationType": "<how notification will display, push v popup>", //Opcional, envío predeterminado, eliminar si no se utiliza "título": "<notification title as appears in the ComCenter notification table>", //Opcional, elimina si no se utiliza "runtimeTitle": "<what will appear to end-users in the Workstation list and in the push notification>", //Opcional, elimina si no se utiliza "runtimeDescription": "<what will appear to end-users i in the Workstation list and in the push message>", //Opcional, elimina si no se utiliza "startAt": "<start date YYYY-MM-DD hh:mm>", // Opcional, por defecto en este momento, la zona horaria es UTC, puedes añadir una fecha y no una hora, la hora predeterminada es 00:00 UTC, elimina lo que no estés utilizando "endAt": "<end date YYYY-MM-DD hh:mm>", // Opcional, por defecto dentro de 30 días a partir de ahora, puedes añadir una fecha y ninguna 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:
