Viva Engage
Viva Engage es una red social líder para que las empresas realicen un trabajo más inteligente y más rápido. Conéctese a Viva Engage para acceder a las conversaciones de la red empresarial.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Estándar | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Estándar | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft |
| URL | https://microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://products.office.com/yammer/yammer-overview |
| Directiva de privacidad | https://privacy.microsoft.com |
| Categorías | Communication |
Importante
La autenticación de OAuth2 para Yammer (Viva Engage) estará en desuso pronto.
- Las nuevas conexiones deben usar la autenticación entra ID a partir del 1 de septiembre.
- Las conexiones de OAuth2 existentes seguirán funcionando hasta el 15 de noviembre de 2025.
Cambie las conexiones a la autenticación entra ID antes del 15 de noviembre de 2025 para evitar interrupciones.
Problemas y limitaciones conocidos
Las siguientes acciones y desencadenadores no garantizan que devuelvan todos los mensajes, debido a las limitaciones de la API REST de Viva Engage:
- Obtener todos los mensajes
- Obtener mensajes en un grupo
- Obtener mensajes en un subproceso
- Obtener los mensajes de mi fuente siguiente
- Cuando hay un nuevo mensaje en un grupo
- Cuando hay un nuevo mensaje en mi fuente seguida
La siguiente acción puede devolver un máximo de 100 grupos, debido a las limitaciones de la API REST de Viva Engage:
- Obtener grupos
Nota:
La API Viva Engage puede restringir el número de mensajes devueltos. Si esto ocurre, para solucionar este límite, consulte Cómo obtener todos los mensajes de un grupo de Yammer mediante Microsoft Flow. Para obtener más detalles relacionados con los límites de la API de Viva Engage, visite Límites de velocidad de API de Yammer.
Además, es posible que las siguientes acciones y desencadenadores no funcionen con todo el grupo de la empresa , debido a las limitaciones de la API REST de Viva Engage:
- Obtener mensajes en un grupo
- Obtener mensajes en un grupo (V2)
- Cuando hay un nuevo mensaje en un grupo
La característica Aplicaciones de terceros debe estar habilitada en la configuración de Yammer. Normalmente, una respuesta de acción como "La respuesta no está en un formato JSON" significa que la característica está deshabilitada.
Las siguientes acciones permiten crear una publicación de "Anuncio" con un "Título" después de establecer los parámetros avanzados correspondientes; sin embargo, esta publicación no podrá editarse en la interfaz de usuario de Viva Engage. Viva Engage es consciente de este problema y abordará este problema en una actualización futura.
- PostMessage
- PostMessageV2
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Inicio de sesión con el identificador de Entra de Microsoft | Inicio de sesión con el identificador de Entra de Microsoft | Todas las regiones | No se puede compartir |
| Valor predeterminado [EN DESUSO] | Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores. | Todas las regiones | No se puede compartir |
Inicio de sesión con el identificador de Entra de Microsoft
Identificador de autenticación: entraIDUserLogin
Aplicable: Todas las regiones
Inicio de sesión con el identificador de Entra de Microsoft
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Valor predeterminado [EN DESUSO]
Aplicable: Todas las regiones
Esta opción solo es para conexiones anteriores sin un tipo de autenticación explícito y solo se proporciona para la compatibilidad con versiones anteriores.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
| Frecuencia de sondeos de desencadenador | 1 | 15 segundos |
Acciones
| Mensaje posterior (V2) |
Esta operación se usa para publicar un mensaje en un grupo o en toda la fuente de la empresa. Si se proporciona el identificador de grupo, el mensaje se publicará en el grupo especificado; de lo contrario, se publicará en Toda la fuente de la empresa. |
| Mensaje posterior [EN DESUSO] |
Esta operación se usa para publicar un mensaje en un grupo o en toda la fuente de la empresa. Si se proporciona el identificador de grupo, el mensaje se publicará en el grupo especificado; de lo contrario, se publicará en Toda la fuente de la empresa. |
| Mensaje similar |
Esta operación se usa para gustar al mensaje especificado. |
| Obtención de detalles del usuario |
Esta operación devuelve los detalles del perfil de usuario. |
| Obtener grupos |
Obtiene todos los grupos. Si la mía es = 1, obtenga solo grupos a los que pertenece el usuario. |
| Obtener los mensajes de mi fuente siguiente (V2) [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener los mensajes de mi fuente siguiente (V3) en su lugar.
|
| Obtener los mensajes de mi fuente siguiente (V3) |
Esta operación devuelve los mensajes de la fuente Siguiente, que son conversaciones que implican personas, grupos y temas que sigue el usuario. |
| Obtener los mensajes de mi fuente siguiente [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener los mensajes de mi fuente siguiente (V3) en su lugar.
|
| Obtener mensajes en un grupo (V2) [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener mensajes en un grupo (V3) en su lugar.
|
| Obtener mensajes en un grupo (V3) |
Esta operación devuelve los mensajes publicados en un grupo. |
| Obtener mensajes en un grupo [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener mensajes en un grupo (V3) en su lugar.
|
| Obtener mensajes en un subproceso (V2) [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener mensajes en un subproceso (V3) en su lugar.
|
| Obtener mensajes en un subproceso (V3) |
Esta operación devuelve los mensajes publicados en un subproceso. |
| Obtener mensajes en un subproceso [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener mensajes en un subproceso (V3) en su lugar.
|
| Obtener mis redes |
Obtiene todas las redes a las que pertenece el usuario. |
| Obtener todos los mensajes (V2) [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener todos los mensajes (V3) en su lugar.
|
| Obtener todos los mensajes (V3) |
Esta operación devuelve todos los mensajes públicos de la red Viva Engage del usuario que ha iniciado sesión. Corresponde a las conversaciones "All" en la interfaz web Viva Engage. |
| Obtener todos los mensajes [EN DESUSO] |
Esta acción ha quedado en desuso. Use Obtener todos los mensajes (V3) en su lugar.
|
Mensaje posterior (V2)
Esta operación se usa para publicar un mensaje en un grupo o en toda la fuente de la empresa. Si se proporciona el identificador de grupo, el mensaje se publicará en el grupo especificado; de lo contrario, se publicará en Toda la fuente de la empresa.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Identificador de grupo
|
group_id | True | integer |
Grupo en el que se va a publicar un mensaje (0 = Toda la empresa o red). |
|
Texto del mensaje
|
body | True | string |
Mensaje que se va a publicar en la red. |
|
Replicado a id.
|
replied_to_id | integer |
El identificador de mensaje al que responde este mensaje. |
|
|
Direct To Id
|
direct_to_id | integer |
Si se establece, se enviará un mensaje privado directamente al usuario con el identificador indicado. |
|
|
Emisión
|
broadcast | boolean |
Publique el mensaje como anuncio para todos los usuarios de un grupo. |
|
|
Title
|
title | string |
Título del mensaje que se va a publicar. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageListV2
Mensaje posterior [EN DESUSO]
Esta operación se usa para publicar un mensaje en un grupo o en toda la fuente de la empresa. Si se proporciona el identificador de grupo, el mensaje se publicará en el grupo especificado; de lo contrario, se publicará en Toda la fuente de la empresa.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Identificador de grupo
|
group_id | True | integer |
Grupo en el que se va a publicar un mensaje (0 = Toda la empresa o red). |
|
Texto del mensaje
|
body | True | string |
Mensaje que se va a publicar en la red. |
|
Replicado a id.
|
replied_to_id | integer |
El identificador de mensaje al que responde este mensaje. |
|
|
Direct To Id
|
direct_to_id | integer |
Si se establece, se enviará un mensaje privado directamente al usuario con el identificador indicado. |
|
|
Emisión
|
broadcast | boolean |
Publique el mensaje como anuncio para todos los usuarios de un grupo. |
|
|
Title
|
title | string |
Título del mensaje que se va a publicar. |
|
|
Tema 1
|
topic1 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 2
|
topic2 | string |
Tema que se va a aplicar al mensaje |
|
|
Tema 3
|
topic3 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 4
|
topic4 | string |
Tema que se va a aplicar al mensaje |
|
|
Tema 5
|
topic5 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 6
|
topic6 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 7
|
topic7 | string |
Tema que se va a aplicar al mensaje |
|
|
Tema 8
|
topic8 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 9
|
topic9 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 10
|
topic10 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 11
|
topic11 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 12
|
topic12 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 13
|
topic13 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 14
|
topic14 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 15
|
topic15 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 16
|
topic16 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 17
|
topic17 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 18
|
topic18 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 19
|
topic19 | string |
Tema que se va a aplicar al mensaje. |
|
|
Tema 20
|
topic20 | string |
Tema que se va a aplicar al mensaje. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageList
Mensaje similar
Esta operación se usa para gustar al mensaje especificado.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de mensaje
|
message_id | True | string |
Identificador único del mensaje. |
Obtención de detalles del usuario
Esta operación devuelve los detalles del perfil de usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de usuario
|
user_id | True | integer |
Identificador único del usuario. |
Devoluciones
Propiedades del usuario Viva Engage.
- Usuario
- User
Obtener grupos
Obtiene todos los grupos. Si la mía es = 1, obtenga solo grupos a los que pertenece el usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador de red |
|
|
mina
|
mine | integer |
Se usa para obtener grupos de los que forma parte el usuario |
|
|
Mostrar todo el grupo de empresa
|
showAllCompanyGroup | integer |
Se usa para mostrar todo el grupo de empresa |
Devoluciones
- response
- array of YammmerEntity
Obtener los mensajes de mi fuente siguiente (V2) [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener los mensajes de mi fuente siguiente (V3) en su lugar.
Esta operación devuelve los mensajes de la fuente Siguiente, que son conversaciones que implican personas, grupos y temas que sigue el usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Anterior a
|
older_than | integer |
Devuelve mensajes anteriores al identificador de mensaje especificado como una cadena numérica. Esto es útil para paginar mensajes. Por ejemplo, si actualmente está viendo 20 mensajes y el más antiguo es el número 2912, podría anexar "?older_than=2912" a la solicitud para obtener los 20 mensajes antes de los que ve. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes más recientes que el identificador de mensaje especificado como una cadena numérica. Esto se debe usar al sondear mensajes nuevos. Si examina los mensajes y el mensaje más reciente devuelto es 3516, puede realizar una solicitud con el parámetro "?newer_than=3516" para asegurarse de que no obtiene copias duplicadas de mensajes ya en la página. |
|
|
Tipo de subproceso de mensajes
|
threaded | string |
Threaded=true solo devolverá el inicio del subproceso (primer mensaje) para cada subproceso. Este parámetro está pensado para aplicaciones que necesitan mostrar subprocesos de mensajes contraídos. threaded=extended devolverá los mensajes de inicio de subprocesos y los dos mensajes más recientes ordenados por actividad, ya que se ven en la vista predeterminada en la interfaz web Viva Engage. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- PageableMessageList
Obtener los mensajes de mi fuente siguiente (V3)
Esta operación devuelve los mensajes de la fuente Siguiente, que son conversaciones que implican personas, grupos y temas que sigue el usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Anterior a
|
older_than | integer |
Devuelve mensajes anteriores al identificador de mensaje especificado como una cadena numérica. Esto es útil para paginar mensajes. Por ejemplo, si actualmente está viendo 20 mensajes y el más antiguo es el número 2912, podría anexar "?older_than=2912" a la solicitud para obtener los 20 mensajes antes de los que ve. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes más recientes que el identificador de mensaje especificado como una cadena numérica. Esto se debe usar al sondear mensajes nuevos. Si examina los mensajes y el mensaje más reciente devuelto es 3516, puede realizar una solicitud con el parámetro "?newer_than=3516" para asegurarse de que no obtiene copias duplicadas de mensajes ya en la página. |
|
|
Tipo de subproceso de mensajes
|
threaded | string |
Threaded=true solo devolverá el inicio del subproceso (primer mensaje) para cada subproceso. Este parámetro está pensado para aplicaciones que necesitan mostrar subprocesos de mensajes contraídos. threaded=extended devolverá los mensajes de inicio de subprocesos y los dos mensajes más recientes ordenados por actividad, ya que se ven en la vista predeterminada en la interfaz web Viva Engage. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- PageableMessageListV2
Obtener los mensajes de mi fuente siguiente [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener los mensajes de mi fuente siguiente (V3) en su lugar.
Esta operación devuelve los mensajes de la fuente Siguiente, que son conversaciones que implican personas, grupos y temas que sigue el usuario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Anterior a
|
older_than | integer |
Devuelve mensajes anteriores al identificador de mensaje especificado como una cadena numérica. Esto es útil para paginar mensajes. Por ejemplo, si actualmente está viendo 20 mensajes y el más antiguo es el número 2912, podría anexar "?older_than=2912" a la solicitud para obtener los 20 mensajes antes de los que ve. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes más recientes que el identificador de mensaje especificado como una cadena numérica. Esto se debe usar al sondear mensajes nuevos. Si examina los mensajes y el mensaje más reciente devuelto es 3516, puede realizar una solicitud con el parámetro "?newer_than=3516" para asegurarse de que no obtiene copias duplicadas de mensajes ya en la página. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
|
|
Página
|
page | integer |
Obtiene la página especificada. Si los datos devueltos son mayores que el límite, puede usar este campo para acceder a las páginas posteriores. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageList
Obtener mensajes en un grupo (V2) [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener mensajes en un grupo (V3) en su lugar.
Esta operación devuelve los mensajes publicados en un grupo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Identificador de grupo
|
group_id | True | integer |
Identificador único del grupo. |
|
Anterior a
|
older_than | integer |
Devuelve mensajes anteriores al identificador de mensaje especificado como una cadena numérica. Esto es útil para paginar mensajes. Por ejemplo, si actualmente está viendo 20 mensajes y el más antiguo es el número 2912, podría anexar "?older_than=2912" a la solicitud para obtener los 20 mensajes antes de los que ve. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes más recientes que el identificador de mensaje especificado como una cadena numérica. Esto se debe usar al sondear mensajes nuevos. Si examina los mensajes y el mensaje más reciente devuelto es 3516, puede realizar una solicitud con el parámetro "?newer_than=3516" para asegurarse de que no obtiene copias duplicadas de mensajes ya en la página. |
|
|
Tipo de subproceso de mensajes
|
threaded | string |
Threaded=true solo devolverá el inicio del subproceso (primer mensaje) para cada subproceso. Este parámetro está pensado para aplicaciones que necesitan mostrar subprocesos de mensajes contraídos. threaded=extended devolverá los mensajes de inicio de subprocesos y los dos mensajes más recientes ordenados por actividad, ya que se ven en la vista predeterminada en la interfaz web Viva Engage. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- PageableMessageList
Obtener mensajes en un grupo (V3)
Esta operación devuelve los mensajes publicados en un grupo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Identificador de grupo
|
group_id | True | integer |
Identificador único del grupo. |
|
Anterior a
|
older_than | integer |
Devuelve mensajes en subprocesos donde el mensaje más reciente del subproceso es anterior al identificador de mensaje especificado. Cualquier subproceso con un identificador de mensaje más reciente que sea más reciente o igual que el identificador especificado no tendrá ninguno de sus mensajes devueltos por esta consulta. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes en subprocesos donde el mensaje más reciente del subproceso es más reciente que el identificador de mensaje especificado. Cualquier subproceso con un identificador de mensaje más reciente anterior o igual que el identificador especificado no tendrá ninguno de sus mensajes devueltos por esta consulta. |
|
|
Tipo de subproceso de mensajes
|
threaded | string |
Threaded=true solo devolverá el inicio del subproceso (primer mensaje) para cada subproceso. Este parámetro está pensado para aplicaciones que necesitan mostrar subprocesos de mensajes contraídos. threaded=extended devolverá los mensajes de inicio de subprocesos y los dos mensajes más recientes ordenados por actividad, ya que se ven en la vista predeterminada en la interfaz web Viva Engage. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- PageableMessageListV2
Obtener mensajes en un grupo [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener mensajes en un grupo (V3) en su lugar.
Esta operación devuelve los mensajes publicados en un grupo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Identificador de grupo
|
group_id | True | integer |
Identificador único del grupo. |
|
Anterior a
|
older_than | integer |
Devuelve mensajes anteriores al identificador de mensaje especificado como una cadena numérica. Esto es útil para paginar mensajes. Por ejemplo, si actualmente está viendo 20 mensajes y el más antiguo es el número 2912, podría anexar "?older_than=2912" a la solicitud para obtener los 20 mensajes antes de los que ve. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes más recientes que el identificador de mensaje especificado como una cadena numérica. Esto se debe usar al sondear mensajes nuevos. Si examina los mensajes y el mensaje más reciente devuelto es 3516, puede realizar una solicitud con el parámetro "?newer_than=3516" para asegurarse de que no obtiene copias duplicadas de mensajes ya en la página. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
|
|
Página
|
page | integer |
Obtiene la página especificada. Si los datos devueltos son mayores que el límite, puede usar este campo para acceder a las páginas posteriores. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageList
Obtener mensajes en un subproceso (V2) [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener mensajes en un subproceso (V3) en su lugar.
Esta operación devuelve los mensajes publicados en un subproceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de subproceso
|
thread_id | True | integer |
Identificador único del subproceso. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- PageableMessageList
Obtener mensajes en un subproceso (V3)
Esta operación devuelve los mensajes publicados en un subproceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de subproceso
|
thread_id | True | integer |
Identificador único del subproceso. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- PageableMessageListV2
Obtener mensajes en un subproceso [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener mensajes en un subproceso (V3) en su lugar.
Esta operación devuelve los mensajes publicados en un subproceso.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de subproceso
|
thread_id | True | integer |
Identificador único del subproceso. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageList
Obtener mis redes
Obtener todos los mensajes (V2) [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener todos los mensajes (V3) en su lugar.
Esta operación devuelve todos los mensajes públicos de la red Viva Engage del usuario que ha iniciado sesión. Corresponde a las conversaciones "All" en la interfaz web Viva Engage.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador único de la red
|
network_id | string |
Identificador de red |
|
|
Anterior a
|
older_than | integer |
Devuelve mensajes anteriores al identificador de mensaje especificado como una cadena numérica. Esto es útil para paginar mensajes. Por ejemplo, si actualmente está viendo 20 mensajes y el más antiguo es el número 2912, podría anexar "?older_than=2912" a la solicitud para obtener los 20 mensajes antes de los que ve. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes más recientes que el identificador de mensaje especificado como una cadena numérica. Esto se debe usar al sondear mensajes nuevos. Si examina los mensajes y el mensaje más reciente devuelto es 3516, puede realizar una solicitud con el parámetro "?newer_than=3516" para asegurarse de que no obtiene copias duplicadas de mensajes ya en la página. |
|
|
Tipo de subproceso de mensajes
|
threaded | string |
Threaded=true solo devolverá el inicio del subproceso (primer mensaje) para cada subproceso. Este parámetro está pensado para aplicaciones que necesitan mostrar subprocesos de mensajes contraídos. threaded=extended devolverá los mensajes de inicio de subprocesos y los dos mensajes más recientes ordenados por actividad, ya que se ven en la vista predeterminada en la interfaz web Viva Engage. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- PageableMessageList
Obtener todos los mensajes (V3)
Esta operación devuelve todos los mensajes públicos de la red Viva Engage del usuario que ha iniciado sesión. Corresponde a las conversaciones "All" en la interfaz web Viva Engage.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador único de la red
|
network_id | string |
Identificador de red |
|
|
Anterior a
|
older_than | integer |
Devuelve mensajes anteriores al identificador de mensaje especificado como una cadena numérica. Esto es útil para paginar mensajes. Por ejemplo, si actualmente está viendo 20 mensajes y el más antiguo es el número 2912, podría anexar "?older_than=2912" a la solicitud para obtener los 20 mensajes antes de los que ve. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes más recientes que el identificador de mensaje especificado como una cadena numérica. Esto se debe usar al sondear mensajes nuevos. Si examina los mensajes y el mensaje más reciente devuelto es 3516, puede realizar una solicitud con el parámetro "?newer_than=3516" para asegurarse de que no obtiene copias duplicadas de mensajes ya en la página. |
|
|
Tipo de subproceso de mensajes
|
threaded | string |
Threaded=true solo devolverá el inicio del subproceso (primer mensaje) para cada subproceso. Este parámetro está pensado para aplicaciones que necesitan mostrar subprocesos de mensajes contraídos. threaded=extended devolverá los mensajes de inicio de subprocesos y los dos mensajes más recientes ordenados por actividad, ya que se ven en la vista predeterminada en la interfaz web Viva Engage. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- PageableMessageListV2
Obtener todos los mensajes [EN DESUSO]
Esta acción ha quedado en desuso. Use Obtener todos los mensajes (V3) en su lugar.
Esta operación devuelve todos los mensajes públicos de la red Viva Engage del usuario que ha iniciado sesión. Corresponde a las conversaciones "All" en la interfaz web de Yammer.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador único de la red
|
network_id | string |
Identificador de red |
|
|
Anterior a
|
older_than | integer |
Devuelve mensajes anteriores al identificador de mensaje especificado como una cadena numérica. Esto es útil para paginar mensajes. Por ejemplo, si actualmente está viendo 20 mensajes y el más antiguo es el número 2912, podría anexar "?older_than=2912" a la solicitud para obtener los 20 mensajes antes de los que ve. |
|
|
Más reciente que
|
newer_than | integer |
Devuelve mensajes más recientes que el identificador de mensaje especificado como una cadena numérica. Esto se debe usar al sondear mensajes nuevos. Si examina los mensajes y el mensaje más reciente devuelto es 3516, puede realizar una solicitud con el parámetro "?newer_than=3516" para asegurarse de que no obtiene copias duplicadas de mensajes ya en la página. |
|
|
Limit
|
limit | integer |
Devuelve solo el número especificado de mensajes. |
|
|
Página
|
page | integer |
Obtiene la página especificada. Si los datos devueltos son mayores que el límite, puede usar este campo para acceder a las páginas posteriores. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageList
Desencadenadores
| Cuando hay un nuevo mensaje en mi fuente seguida (V2) |
Esta operación se desencadena cuando hay un nuevo mensaje en una red seguida de usted. |
| Cuando hay un nuevo mensaje en mi fuente seguida [EN DESUSO] |
Esta acción ha quedado en desuso. Use Cuando haya un nuevo mensaje en mi fuente seguida (V2) en su lugar.
|
| Cuando hay un nuevo mensaje en un grupo (V2) |
Esta operación se desencadena cuando se publica un nuevo mensaje en un grupo. |
| Cuando hay un nuevo mensaje en un grupo [EN DESUSO] |
Esta acción ha quedado en desuso. Use Cuando haya un nuevo mensaje en un grupo (V2) en su lugar.
|
Cuando hay un nuevo mensaje en mi fuente seguida (V2)
Esta operación se desencadena cuando hay un nuevo mensaje en una red seguida de usted.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Elija una red. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageListV2
Cuando hay un nuevo mensaje en mi fuente seguida [EN DESUSO]
Esta acción ha quedado en desuso. Use Cuando haya un nuevo mensaje en mi fuente seguida (V2) en su lugar.
Esta operación se desencadena cuando hay un nuevo mensaje en una red seguida de usted.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Elija una red. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageList
Cuando hay un nuevo mensaje en un grupo (V2)
Esta operación se desencadena cuando se publica un nuevo mensaje en un grupo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Id. de grupo
|
group_id | True | integer |
Identificador único del grupo. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageListV2
Cuando hay un nuevo mensaje en un grupo [EN DESUSO]
Esta acción ha quedado en desuso. Use Cuando haya un nuevo mensaje en un grupo (V2) en su lugar.
Esta operación se desencadena cuando se publica un nuevo mensaje en un grupo.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Identificador de red
|
network_id | string |
Identificador único de la red. |
|
|
Id. de grupo
|
group_id | True | integer |
Identificador único del grupo. |
Devoluciones
Lista de uno o varios mensajes.
- Lista de mensajes
- MessageList
Definiciones
Usuario
Propiedades del usuario Viva Engage.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Nombre de usuario
|
name | string |
Nombre de usuario. |
|
Puesto
|
job_title | string |
Puesto de usuario. |
|
Ubicación
|
location | string |
Ubicación del usuario. |
|
Nombre completo
|
full_name | string |
Nombre completo del usuario. |
|
Nombre
|
first_name | string |
Nombre de usuario. |
|
Apellido
|
last_name | string |
Apellidos del usuario. |
|
Dirección URL del perfil
|
web_url | string |
Dirección URL del perfil de usuario. |
|
Correo Electrónico
|
string |
Correo electrónico del usuario. |
|
|
Fecha de nacimiento
|
birth_date | string |
Fecha de nacimiento del usuario. |
|
Dirección URL de la foto
|
mugshot_url | string |
Dirección URL de la foto del usuario. |
Message
Propiedades de un único mensaje Viva Engage.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | integer |
Identificador asociado a la publicación. |
|
Mensaje de texto
|
content_excerpt | string |
Contenido de texto de la publicación. |
|
Remitente
|
sender_id | integer |
Identificador único del usuario que publicó el mensaje. |
|
Respondida a
|
replied_to_id | integer |
Identificador del mensaje al que este mensaje es una respuesta. |
|
Creado en
|
created_at | string |
Hora en la que se creó el mensaje. |
|
Network
|
network_id | integer |
El identificador del mensaje de red está asociado. |
|
Tipo
|
message_type | string |
Descripton del tipo de mensaje. |
|
Tipo de remitente
|
sender_type | string |
Descripción del tipo de remitente. |
|
URL
|
url | uri |
Dirección URL de la API de la publicación. |
|
Web Url
|
web_url | uri |
Dirección URL web de la publicación. |
|
Identificador de grupo
|
group_id | integer |
Identificador único del grupo que publicó el mensaje. |
|
Cuerpo del mensaje
|
body | MessageBody |
Contenido asociado a un único mensaje. |
|
Identificador de subproceso
|
thread_id | integer |
Identificador único del subproceso. |
|
Mensaje directo
|
direct_message | boolean |
Marca para especificar si la publicación es un mensaje directo. |
|
Identificador de cliente
|
client_type | string |
Tipo del cliente. |
|
URL de cliente
|
client_url | uri |
Vínculo web del cliente. |
|
Language
|
language | string |
Idioma usado en el mensaje. |
|
Usuario etiquetado
|
notified_user_ids | array of integer |
Detalles de los usuarios notificados. |
|
Privacidad
|
privacy | string |
Detalles de la privacidad asociada al mensaje. |
|
liked_by
|
liked_by | LikedBy |
Le gusta |
|
Mensaje del sistema
|
system_message | boolean |
Marca para especificar si la publicación es un mensaje generado por el sistema o no. |
|
Temas
|
topics | array of Topic |
Lista de temas. |
MessageV2
Propiedades de un único mensaje Viva Engage.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | integer |
Identificador asociado a la publicación. |
|
Mensaje de texto
|
content_excerpt | string |
Contenido de texto de la publicación. |
|
Remitente
|
sender_id | integer |
Identificador único del usuario que publicó el mensaje. |
|
Respondida a
|
replied_to_id | integer |
Identificador del mensaje al que este mensaje es una respuesta. |
|
Creado en
|
created_at | string |
Hora en la que se creó el mensaje. |
|
Network
|
network_id | integer |
El identificador del mensaje de red está asociado. |
|
Tipo
|
message_type | string |
Descripton del tipo de mensaje. |
|
Tipo de remitente
|
sender_type | string |
Descripción del tipo de remitente. |
|
URL
|
url | uri |
Dirección URL de la API de la publicación. |
|
Web Url
|
web_url | uri |
Dirección URL web de la publicación. |
|
Identificador de grupo
|
group_id | integer |
Identificador único del grupo que publicó el mensaje. |
|
Cuerpo del mensaje
|
body | MessageBody |
Contenido asociado a un único mensaje. |
|
Identificador de subproceso
|
thread_id | integer |
Identificador único del subproceso. |
|
Mensaje directo
|
direct_message | boolean |
Marca para especificar si la publicación es un mensaje directo. |
|
Identificador de cliente
|
client_type | string |
Tipo del cliente. |
|
URL de cliente
|
client_url | uri |
Vínculo web del cliente. |
|
Language
|
language | string |
Idioma usado en el mensaje. |
|
Usuario etiquetado
|
notified_user_ids | array of integer |
Detalles de los usuarios notificados. |
|
Privacidad
|
privacy | string |
Detalles de la privacidad asociada al mensaje. |
|
liked_by
|
liked_by | LikedBy |
Le gusta |
|
Mensaje del sistema
|
system_message | boolean |
Marca para especificar si la publicación es un mensaje generado por el sistema o no. |
Tema
Propiedades de un solo tema.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | integer |
Identificador único del tema. |
|
Nombre
|
name | string |
Nombre del tema. |
PageableMessageList
Lista de uno o varios mensajes.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Messages
|
value | array of Message |
PageableMessageListV2
Lista de uno o varios mensajes.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Messages
|
value | array of MessageV2 |
MessageList
Lista de uno o varios mensajes.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Messages
|
messages | array of Message |
messages |
MessageListV2
Lista de uno o varios mensajes.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Messages
|
messages | array of MessageV2 |
messages |
MessageBody
Contenido asociado a un único mensaje.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Mensaje de texto
|
parsed | string |
Formato de texto analizado. |
|
Normal
|
plain | string |
Formato de texto sin formato. |
|
Rico
|
rich | string |
Formato de texto enriquecido. |
LikedBy
Le gusta
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Contar
|
count | integer |
Número de likes distintos. |
|
Names
|
names | array of object |
Lista de personas que les gustó la publicación. |
|
Nombre completo
|
names.full_name | string |
Nombre completo de la persona que gustó la publicación. |
Network
Propiedades de una sola red.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificación
|
id | string |
Identificador único de la red. |
|
Nombre
|
name | string |
Resumen de la red. |
|
Link
|
permalink | string |
Vínculo web a la página de red. |
YammmerEntity
Propiedades de una sola entidad Viva Engage.
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Description
|
type | string |
Detalles de la entidad Viva Engage. |
|
Identificador de grupo
|
id | integer |
Identificador único del grupo. |
|
Nombre completo
|
full_name | string |
Nombre de la entidad Viva Engage. |