A través de la integración de Awardco con Viva Engage, las organizaciones pueden compartir reconocimientos públicos de Awardco dentro de sus comunidades de manera fluida. Para lograr esto, necesitará crear un usuario bot, agregar ese usuario a cualquier comunidad donde desee que se publiquen reconocimientos, crear una aplicación de Viva Engage para hacerse pasar por ese usuario y conectar esa aplicación a Awardco. Debe contar con un administrador de Microsoft 365 para crear el usuario, asegurarse de que el usuario tenga una licencia válida para acceder a Viva Engage y haber iniciado sesión como administrador de Awardco para conectar la cuenta del usuario bot a Awardco. Siga los pasos descritos en el artículo a continuación para configurar la integración con éxito.
Nota: Esta integración le permite ver el feed de reconocimientos para reconocimientos puntuales en Viva Engage. Sin embargo, no admite enviar reconocimientos directamente a través de Viva Engage, incluidos los reconocimientos de programas automatizados, ni mostrar imágenes y videos en el feed.
- Registrar una aplicación en Microsoft Entra ID
- Obtener el ID de cliente y el secreto de cliente
- Configurar permisos de API
- Crear un usuario bot
- Agregar un usuario bot a una comunidad
- Conectar la aplicación Viva Engage a Awardco
- Configurar metadatos para la publicación de reconocimientos
- Preguntas frecuentes (FAQ)
Registrar una aplicación en Microsoft Entra ID
- Un administrador de Microsoft 365 (o alguien con los permisos adecuados, como Desarrollador de aplicaciones o Administrador de aplicaciones en la nube) debe iniciar sesión en el Portal de Microsoft Azure (http://portal.azure.com).
- Seleccione Microsoft Entra ID (o búsquelo).
- En Administrar, seleccione Registro de aplicaciones y luego haga clic en + Nuevo registro.
- Complete los detalles del registro:
- Nombre: Asigne un nombre significativo (por ejemplo, "Integración Awardco Viva Engage").
- Tipos de cuentas compatibles: Seleccione "Cuentas en este directorio organizacional solamente" (Inquilino único).
- URI de redireccionamiento: Ingrese lo siguiente reemplazando [your-subdomain] con el subdominio de su empresa https://[your-subdomain].awardco.com/viva-engage/auth.
- Registre la aplicación.
Obtener el ID de cliente y el secreto de cliente
- Una vez registrado, será dirigido a la página de descripción general de la aplicación. El ID de aplicación (cliente) es el ID de cliente. Guárdelo para más adelante.
- Secreto de cliente: En la navegación izquierda, vaya a Certificados y secretos. Haga clic en + Nuevo secreto de cliente, asigne una descripción, seleccione un tiempo de expiración y haga clic en Agregar. COPIE INMEDIATAMENTE el valor del secreto.
- Nota: Este es su nuevo secreto de cliente y no podrá recuperarlo después de salir de esta página.
Configurar permisos de API
- En la navegación izquierda, vaya a Permisos de API.
- Haga clic en + Agregar un permiso.
- Agregue los siguientes permisos
- Bajo Microsoft Graph
- openid
- profile
- User.read
- Bajo Yammer
- user_impersonation
- Bajo Microsoft Graph
- Conceder consentimiento de administrador: Después de agregar el permiso, un administrador debe hacer clic en Conceder consentimiento de administrador para [Su organización]
Crear un usuario bot
Para crear su usuario bot para publicar reconocimientos:
- Inicie sesión en el Centro de administración de Microsoft 365 como administrador de Microsoft 365. https://admin.microsoft.com/Adminportal/Home#/users
- Haga clic en "Agregar un usuario".
- Nombre al usuario como desee. Por ejemplo, podría poner su nombre para mostrar como “Reconocimiento de Mi Empresa”.
- Asigne un nombre de usuario y una contraseña. También puede solicitar que le envíen la contraseña por correo electrónico. ¡Asegúrese de guardar el nombre de usuario y la contraseña porque los necesitará más adelante!
- Seleccione una licencia para asignar al usuario. Asegúrese de que el usuario tenga acceso a Viva Engage.
- Puede omitir las configuraciones opcionales a menos que desee hacer alguna edición.
- Revise la información y, si está correcta, haga clic en “Finalizar adición”.
- ¡Asegúrese de guardar el nombre de usuario y la contraseña porque los necesitará más adelante!
Agregar un usuario bot a una comunidad
- Use el nuevo usuario bot para iniciar sesión en Viva Engage https://web.yammer.com/. Puede que desee hacerlo en una ventana de incógnito de su navegador.
- Haga que el usuario cree y/o se una a las comunidades en las que desea publicar reconocimientos.
Una forma opcional para que los administradores otorguen permisos al bot para publicar en cualquier comunidad:
- Inicie sesión en Viva Engage (Yammer) como administrador global.
- Vaya al Centro de administración de Yammer (Configuración > Administrador de red).
- Seleccione Administradores en el menú.
- Encuentre su usuario bot.
- Concédale el estado de Administrador verificado.
Conectar la aplicación Viva Engage a Awardco
Para conectar la aplicación Viva Engage a Awardco:
- Navegue a https://[your-subdomain].awardco.com/settings/integrations/viva-engage
- Seleccione el botón Administrador en la parte inferior del menú de navegación izquierdo.
- Seleccione “Plataforma”, luego “Integraciones”, y luego ingrese a la Biblioteca de integraciones dentro del portal de administración.
- Busque y seleccione "Microsoft Viva Engage".
- Haga clic en Comenzar configuración.
- Haga clic en Siguiente.
- Ingrese el ID de cliente que guardó anteriormente.
- Ingrese el secreto de cliente que guardó anteriormente.
- Inicie sesión con el bot que desea que publique los reconocimientos en la nueva página que se abre.
- Haga clic en Continuar.
- Seleccione una comunidad a la que desea que el bot publique.
Configurar metadatos para la publicación de reconocimientos
Para configurar reglas de metadatos para que los usuarios de diferentes ubicaciones o departamentos puedan ver reconocimientos relacionados con personas que conocen (por ejemplo, :
- Acceda a Configuración de la comunidad.
- Seleccione un campo de metadatos en el que basar las reglas.
- Haga clic en “Agregar regla”.
- Seleccione uno o más valores de metadatos.
- Seleccione la comunidad de Viva Engage en la que desea publicar reconocimientos para esos valores de metadatos.
- Haga clic en “Guardar regla”.
- Continúe agregando y guardando reglas según sea necesario.
- Puede desactivar la “Comunidad predeterminada” si no desea que se publiquen reconocimientos para usuarios que no tengan uno de los valores de metadatos listados.
Preguntas frecuentes (FAQ)
- ¿Qué hago si no veo comunidades en Awardco?
- Agregue el usuario bot a todas las comunidades en las que desee publicar reconocimientos.
- ¿Qué hago si los reconocimientos no se publican en Viva Engage?
- Asegúrese de que la integración no esté pausada en “Pausar integración”.
- Verifique que la comunidad predeterminada esté configurada o que las reglas de metadatos se apliquen para el destinatario del reconocimiento.
- Compruebe que está viendo la comunidad correcta.
- Asegúrese de que los reconocimientos sean públicos.
- ¿Puedo personalizar cómo se ven los reconocimientos en Viva Engage?
- Debido a las limitaciones de la API de Viva Engage, no podemos formatear el texto del reconocimiento ni permitir ninguna personalización.
- ¿Los comentarios y reacciones en Viva Engage aparecerán en el feed de Awardco?
- No, esto no es posible actualmente.
- ¿Puedo conectar SharePoint con Viva Engage para mostrar reconocimientos?
- Puede configurarlo siguiendo los pasos en nuestro artículo de soporte Mostrar reconocimiento en SharePoint usando la integración de Viva Engage.
If you have any questions, please contact Awardco Admin Support.