Compartilhar via

Viva Engage

O Viva Engage é uma rede social líder para que as empresas trabalhem de forma mais inteligente e rápida. Conecte-se ao Viva Engage para acessar conversas em sua rede corporativa.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Standard Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Standard Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Standard Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Microsoft
URL https://microsoft.com
Metadados do conector
Publicador Microsoft
Site https://products.office.com/yammer/yammer-overview
Política de privacidade https://privacy.microsoft.com
Categorias Communication

Importante

A autenticação OAuth2 para o Yammer (Viva Engage) será preterida em breve.

  • Novas conexões devem usar a autenticação de ID do Entra a partir de 1º de setembro.
  • As conexões OAuth2 existentes continuarão funcionando até 15 de novembro de 2025.

Alterne suas conexões para a autenticação de ID do Entra antes de 15 de novembro de 2025 para evitar interrupções.

Problemas e limitações conhecidos

As seguintes ações e gatilhos não garantem o retorno de todas as mensagens devido às limitações da API REST do Viva Engage:

  • Obter todas as mensagens
  • Obter mensagens em um grupo
  • Obter mensagens em um thread
  • Obter as mensagens do meu feed a seguir
  • Quando há uma nova mensagem em um grupo
  • Quando há uma nova mensagem no meu feed seguido

A ação a seguir pode retornar no máximo 100 grupos devido às limitações da API REST do Viva Engage:

  • Obter grupos

Observação

A API do Viva Engage pode restringir o número de mensagens retornadas. Se isso ocorrer, para solucionar esse limite, consulte Como obter todas as mensagens em um grupo do Yammer usando o Microsoft Flow. Para obter mais detalhes relacionados aos limites da API do Viva Engage, visite os limites de taxa de API do Yammer.

Além disso, as seguintes ações e gatilhos podem não funcionar com todos os grupos da empresa devido às limitações da API REST do Viva Engage:

  • Obter mensagens em um grupo
  • Obter mensagens em um grupo (V2)
  • Quando há uma nova mensagem em um grupo

O recurso Aplicativos de terceiros deve ser habilitado na configuração do Yammer. Uma resposta de ação como "A resposta não está em um formato JSON" normalmente significa que o recurso está desabilitado.

As ações a seguir permitem que você crie uma postagem "Comunicado" com um "Título" depois de definir os Parâmetros Avançados correspondentes, no entanto, essa postagem não poderá ser editada na interface do usuário do Viva Engage. O Viva Engage está ciente desse problema e resolverá esse problema em uma atualização futura.

  • PostMessage
  • PostMessageV2

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Fazer logon com a ID do Microsoft Entra Fazer logon com a ID do Microsoft Entra Todas as regiões Não compartilhável
Padrão [PRETERIDO] Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores. Todas as regiões Não compartilhável

Fazer logon com a ID do Microsoft Entra

ID de autenticação: entraIDUserLogin

Aplicável: todas as regiões

Fazer logon com a ID do Microsoft Entra

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [PRETERIDO]

Aplicável: todas as regiões

Essa opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos
Frequência das pesquisas de gatilho 1 15 s

Ações

Curtir mensagem

Essa operação é usada para gostar da mensagem especificada.
Obter as mensagens do meu feed a seguir (V2) [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter as mensagens do meu feed a seguir (V3 ).

Esta operação retorna as mensagens do feed a seguir, que são conversas envolvendo pessoas, grupos e tópicos que o usuário está seguindo.
Obter as mensagens do meu feed a seguir (V3)

Esta operação retorna as mensagens do feed a seguir, que são conversas envolvendo pessoas, grupos e tópicos que o usuário está seguindo.
Obter as mensagens do meu feed a seguir [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter as mensagens do meu feed a seguir (V3 ).

Esta operação retorna as mensagens do feed a seguir, que são conversas envolvendo pessoas, grupos e tópicos que o usuário está seguindo.
Obter detalhes do usuário

Esta operação retorna detalhes do perfil do usuário.
Obter grupos

Obtém todos os grupos. Se mine = 1, obtenha apenas grupos aos quais o usuário pertence
Obter mensagens em um grupo (V2) [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter mensagens em um grupo (V3 ).

Essa operação retorna as mensagens postadas em um grupo.
Obter mensagens em um grupo (V3)

Essa operação retorna as mensagens postadas em um grupo.
Obter mensagens em um grupo [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter mensagens em um grupo (V3 ).

Essa operação retorna as mensagens postadas em um grupo.
Obter mensagens em um thread (V2) [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter mensagens em um thread (V3 ).

Essa operação retorna as mensagens postadas em um thread.
Obter mensagens em um thread (V3)

Essa operação retorna as mensagens postadas em um thread.
Obter mensagens em um thread [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter mensagens em um thread (V3 ).

Essa operação retorna as mensagens postadas em um thread.
Obter minhas redes

Obtém todas as redes às quais o usuário pertence.
Obter todas as mensagens (V2) [PRETERIDO]

Esta ação foi preterida. Em vez disso, use Obter todas as mensagens (V3 ).

Essa operação retorna todas as mensagens públicas na rede viva engage do usuário conectada. Corresponde a "Todas" conversas na interface da Web do Viva Engage.
Obter todas as mensagens (V3)

Essa operação retorna todas as mensagens públicas na rede viva engage do usuário conectada. Corresponde a "Todas" conversas na interface da Web do Viva Engage.
Obter todas as mensagens [PRETERIDAS]

Esta ação foi preterida. Em vez disso, use Obter todas as mensagens (V3 ).

Essa operação retorna todas as mensagens públicas na rede viva engage do usuário conectada. Corresponde a "Todas" conversas na interface da Web do Yammer.
Postar mensagem (V2)

Essa operação é usada para postar uma mensagem em um grupo ou no Feed da Empresa. Se a ID do grupo for fornecida, a mensagem será postada no grupo especificado, caso contrário, ela será postada no Feed da Empresa.
Postar mensagem [PRETERIDO]

Essa operação é usada para postar uma mensagem em um grupo ou no Feed da Empresa. Se a ID do grupo for fornecida, a mensagem será postada no grupo especificado, caso contrário, ela será postada no Feed da Empresa.

Curtir mensagem

ID da operação:
LikeMessage

Essa operação é usada para gostar da mensagem especificada.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da mensagem
 message_id True string

ID exclusiva da mensagem.

Obter as mensagens do meu feed a seguir (V2) [PRETERIDO]

ID da operação:
GetMessagesFollowingV2

Esta ação foi preterida. Em vez disso, use Obter as mensagens do meu feed a seguir (V3 ).

Esta operação retorna as mensagens do feed a seguir, que são conversas envolvendo pessoas, grupos e tópicos que o usuário está seguindo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Identificador exclusivo da rede.
Com mais de
 older_than integer

Retorna mensagens mais antigas do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se você estiver exibindo 20 mensagens no momento e o mais antigo for o número 2912, você poderá acrescentar "?older_than=2912" à sua solicitação para obter as 20 mensagens antes das que você está vendo.
Mais recente que
 newer_than integer

Retorna mensagens mais recentes do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver examinando mensagens e a mensagem mais recente retornada for 3516, você poderá fazer uma solicitação com o parâmetro "?newer_than=3516" para garantir que você não obtenha cópias duplicadas de mensagens já em sua página.
Tipo de thread de mensagens
 threaded string

Threaded=true só retornará o início do thread (primeira mensagem) para cada thread. Esse parâmetro destina-se a aplicativos que precisam exibir threads de mensagem recolhidos. threaded=extended retornará as mensagens de início do thread e as duas mensagens mais recentes ordenadas pela atividade, pois elas são exibidas no modo de exibição padrão na interface da Web do Viva Engage.
Limit
 limit integer

Retornar somente o número especificado de mensagens.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageList

Obter as mensagens do meu feed a seguir (V3)

ID da operação:
GetMessagesFollowingV3

Esta operação retorna as mensagens do feed a seguir, que são conversas envolvendo pessoas, grupos e tópicos que o usuário está seguindo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Identificador exclusivo da rede.
Com mais de
 older_than integer

Retorna mensagens mais antigas do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se você estiver exibindo 20 mensagens no momento e o mais antigo for o número 2912, você poderá acrescentar "?older_than=2912" à sua solicitação para obter as 20 mensagens antes das que você está vendo.
Mais recente que
 newer_than integer

Retorna mensagens mais recentes do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver examinando mensagens e a mensagem mais recente retornada for 3516, você poderá fazer uma solicitação com o parâmetro "?newer_than=3516" para garantir que você não obtenha cópias duplicadas de mensagens já em sua página.
Tipo de thread de mensagens
 threaded string

Threaded=true só retornará o início do thread (primeira mensagem) para cada thread. Esse parâmetro destina-se a aplicativos que precisam exibir threads de mensagem recolhidos. threaded=extended retornará as mensagens de início do thread e as duas mensagens mais recentes ordenadas pela atividade, pois elas são exibidas no modo de exibição padrão na interface da Web do Viva Engage.
Limit
 limit integer

Retornar somente o número especificado de mensagens.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageListV2

Obter as mensagens do meu feed a seguir [PRETERIDO]

ID da operação:
GetMessagesFollowing

Esta ação foi preterida. Em vez disso, use Obter as mensagens do meu feed a seguir (V3 ).

Esta operação retorna as mensagens do feed a seguir, que são conversas envolvendo pessoas, grupos e tópicos que o usuário está seguindo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Identificador exclusivo da rede.
Com mais de
 older_than integer

Retorna mensagens mais antigas do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se você estiver exibindo 20 mensagens no momento e o mais antigo for o número 2912, você poderá acrescentar "?older_than=2912" à sua solicitação para obter as 20 mensagens antes das que você está vendo.
Mais recente que
 newer_than integer

Retorna mensagens mais recentes do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver examinando mensagens e a mensagem mais recente retornada for 3516, você poderá fazer uma solicitação com o parâmetro "?newer_than=3516" para garantir que você não obtenha cópias duplicadas de mensagens já em sua página.
Limit
 limit integer

Retornar somente o número especificado de mensagens.
Página
 page integer

Obtenha a página especificada. Se os dados retornados forem maiores que o limite, você poderá usar esse campo para acessar páginas subsequentes

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Obter detalhes do usuário

ID da operação:
GetUserDetailsById

Esta operação retorna detalhes do perfil do usuário.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do Usuário
 user_id True integer

Identificador exclusivo do usuário.

Retornos

Propriedades do usuário do Viva Engage.

Utilizador
User

Obter grupos

ID da operação:
GetGroups

Obtém todos os grupos. Se mine = 1, obtenha apenas grupos aos quais o usuário pertence

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

ID da rede
mina
 mine integer

Usado para obter grupos dos quais o usuário faz parte
Mostrar Todos os Grupos da Empresa
 showAllCompanyGroup integer

Usado para mostrar Todos os Grupos da Empresa

Retornos

response
array of YammmerEntity

Obter mensagens em um grupo (V2) [PRETERIDO]

ID da operação:
GetMessagesInGroupV2

Esta ação foi preterida. Em vez disso, use Obter mensagens em um grupo (V3 ).

Essa operação retorna as mensagens postadas em um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Identificador exclusivo da rede.
ID do grupo
 group_id True integer

Identificador exclusivo do grupo.
Com mais de
 older_than integer

Retorna mensagens mais antigas do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se você estiver exibindo 20 mensagens no momento e o mais antigo for o número 2912, você poderá acrescentar "?older_than=2912" à sua solicitação para obter as 20 mensagens antes das que você está vendo.
Mais recente que
 newer_than integer

Retorna mensagens mais recentes do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver examinando mensagens e a mensagem mais recente retornada for 3516, você poderá fazer uma solicitação com o parâmetro "?newer_than=3516" para garantir que você não obtenha cópias duplicadas de mensagens já em sua página.
Tipo de thread de mensagens
 threaded string

Threaded=true só retornará o início do thread (primeira mensagem) para cada thread. Esse parâmetro destina-se a aplicativos que precisam exibir threads de mensagem recolhidos. threaded=extended retornará as mensagens de início do thread e as duas mensagens mais recentes ordenadas pela atividade, pois elas são exibidas no modo de exibição padrão na interface da Web do Viva Engage.
Limit
 limit integer

Retornar somente o número especificado de mensagens.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageList

Obter mensagens em um grupo (V3)

ID da operação:
GetMessagesInGroupV3

Essa operação retorna as mensagens postadas em um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Identificador exclusivo da rede.
ID do grupo
 group_id True integer

Identificador exclusivo do grupo.
Com mais de
 older_than integer

Retorna mensagens em threads em que a mensagem mais recente do thread é mais antiga do que a ID da mensagem especificada. Qualquer thread com uma ID de mensagem mais recente que seja mais recente ou igual à ID especificada não terá nenhuma de suas mensagens retornadas por essa consulta.
Mais recente que
 newer_than integer

Retorna mensagens em threads em que a mensagem mais recente do thread é mais recente do que a ID da mensagem especificada. Qualquer thread com uma ID de mensagem mais recente que seja mais antiga ou igual à ID especificada não terá nenhuma de suas mensagens retornadas por essa consulta.
Tipo de thread de mensagens
 threaded string

Threaded=true só retornará o início do thread (primeira mensagem) para cada thread. Esse parâmetro destina-se a aplicativos que precisam exibir threads de mensagem recolhidos. threaded=extended retornará as mensagens de início do thread e as duas mensagens mais recentes ordenadas pela atividade, pois elas são exibidas no modo de exibição padrão na interface da Web do Viva Engage.
Limit
 limit integer

Retornar somente o número especificado de mensagens.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageListV2

Obter mensagens em um grupo [PRETERIDO]

ID da operação:
GetMessagesInGroup

Esta ação foi preterida. Em vez disso, use Obter mensagens em um grupo (V3 ).

Essa operação retorna as mensagens postadas em um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Identificador exclusivo da rede.
ID do grupo
 group_id True integer

Identificador exclusivo do grupo.
Com mais de
 older_than integer

Retorna mensagens mais antigas do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se você estiver exibindo 20 mensagens no momento e o mais antigo for o número 2912, você poderá acrescentar "?older_than=2912" à sua solicitação para obter as 20 mensagens antes das que você está vendo.
Mais recente que
 newer_than integer

Retorna mensagens mais recentes do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver examinando mensagens e a mensagem mais recente retornada for 3516, você poderá fazer uma solicitação com o parâmetro "?newer_than=3516" para garantir que você não obtenha cópias duplicadas de mensagens já em sua página.
Limit
 limit integer

Retornar somente o número especificado de mensagens.
Página
 page integer

Obtenha a página especificada. Se os dados retornados forem maiores que o limite, você poderá usar esse campo para acessar páginas subsequentes

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Obter mensagens em um thread (V2) [PRETERIDO]

ID da operação:
GetMessagesInThreadV2

Esta ação foi preterida. Em vez disso, use Obter mensagens em um thread (V3 ).

Essa operação retorna as mensagens postadas em um thread.

Parâmetros

Nome Chave Obrigatório Tipo Description
Thread ID
 thread_id True integer

Identificador exclusivo do thread.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageList

Obter mensagens em um thread (V3)

ID da operação:
GetMessagesInThreadV3

Essa operação retorna as mensagens postadas em um thread.

Parâmetros

Nome Chave Obrigatório Tipo Description
Thread ID
 thread_id True integer

Identificador exclusivo do thread.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageListV2

Obter mensagens em um thread [PRETERIDO]

ID da operação:
GetMessagesInThread

Esta ação foi preterida. Em vez disso, use Obter mensagens em um thread (V3 ).

Essa operação retorna as mensagens postadas em um thread.

Parâmetros

Nome Chave Obrigatório Tipo Description
Thread ID
 thread_id True integer

Identificador exclusivo do thread.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Obter minhas redes

ID da operação:
GetNetworks

Obtém todas as redes às quais o usuário pertence.

Retornos

response
array of Network

Obter todas as mensagens (V2) [PRETERIDO]

ID da operação:
GetAllMessagesV2

Esta ação foi preterida. Em vez disso, use Obter todas as mensagens (V3 ).

Essa operação retorna todas as mensagens públicas na rede viva engage do usuário conectada. Corresponde a "Todas" conversas na interface da Web do Viva Engage.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador exclusivo da rede
 network_id string

ID da rede
Com mais de
 older_than integer

Retorna mensagens mais antigas do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se você estiver exibindo 20 mensagens no momento e o mais antigo for o número 2912, você poderá acrescentar "?older_than=2912" à sua solicitação para obter as 20 mensagens antes das que você está vendo.
Mais recente que
 newer_than integer

Retorna mensagens mais recentes do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver examinando mensagens e a mensagem mais recente retornada for 3516, você poderá fazer uma solicitação com o parâmetro "?newer_than=3516" para garantir que você não obtenha cópias duplicadas de mensagens já em sua página.
Tipo de thread de mensagens
 threaded string

Threaded=true só retornará o início do thread (primeira mensagem) para cada thread. Esse parâmetro destina-se a aplicativos que precisam exibir threads de mensagem recolhidos. threaded=extended retornará as mensagens de início do thread e as duas mensagens mais recentes ordenadas pela atividade, pois elas são exibidas no modo de exibição padrão na interface da Web do Viva Engage.
Limit
 limit integer

Retornar somente o número especificado de mensagens.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageList

Obter todas as mensagens (V3)

ID da operação:
GetAllMessagesV3

Essa operação retorna todas as mensagens públicas na rede viva engage do usuário conectada. Corresponde a "Todas" conversas na interface da Web do Viva Engage.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador exclusivo da rede
 network_id string

ID da rede
Com mais de
 older_than integer

Retorna mensagens mais antigas do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se você estiver exibindo 20 mensagens no momento e o mais antigo for o número 2912, você poderá acrescentar "?older_than=2912" à sua solicitação para obter as 20 mensagens antes das que você está vendo.
Mais recente que
 newer_than integer

Retorna mensagens mais recentes do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver examinando mensagens e a mensagem mais recente retornada for 3516, você poderá fazer uma solicitação com o parâmetro "?newer_than=3516" para garantir que você não obtenha cópias duplicadas de mensagens já em sua página.
Tipo de thread de mensagens
 threaded string

Threaded=true só retornará o início do thread (primeira mensagem) para cada thread. Esse parâmetro destina-se a aplicativos que precisam exibir threads de mensagem recolhidos. threaded=extended retornará as mensagens de início do thread e as duas mensagens mais recentes ordenadas pela atividade, pois elas são exibidas no modo de exibição padrão na interface da Web do Viva Engage.
Limit
 limit integer

Retornar somente o número especificado de mensagens.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageListV2

Obter todas as mensagens [PRETERIDAS]

ID da operação:
GetAllMessages

Esta ação foi preterida. Em vez disso, use Obter todas as mensagens (V3 ).

Essa operação retorna todas as mensagens públicas na rede viva engage do usuário conectada. Corresponde a "Todas" conversas na interface da Web do Yammer.

Parâmetros

Nome Chave Obrigatório Tipo Description
Identificador exclusivo da rede
 network_id string

ID da rede
Com mais de
 older_than integer

Retorna mensagens mais antigas do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se você estiver exibindo 20 mensagens no momento e o mais antigo for o número 2912, você poderá acrescentar "?older_than=2912" à sua solicitação para obter as 20 mensagens antes das que você está vendo.
Mais recente que
 newer_than integer

Retorna mensagens mais recentes do que a ID da mensagem especificada como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver examinando mensagens e a mensagem mais recente retornada for 3516, você poderá fazer uma solicitação com o parâmetro "?newer_than=3516" para garantir que você não obtenha cópias duplicadas de mensagens já em sua página.
Limit
 limit integer

Retornar somente o número especificado de mensagens.
Página
 page integer

Obtenha a página especificada. Se os dados retornados forem maiores que o limite, você poderá usar esse campo para acessar páginas subsequentes

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Postar mensagem (V2)

ID da operação:
PostMessageV2

Essa operação é usada para postar uma mensagem em um grupo ou no Feed da Empresa. Se a ID do grupo for fornecida, a mensagem será postada no grupo especificado, caso contrário, ela será postada no Feed da Empresa.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

ID exclusiva da rede.
ID do grupo
 group_id True integer

O grupo para o qual postar uma mensagem (0 = Todas as Empresas/Rede).
Texto da mensagem
 body True string

Sua mensagem a ser postada em sua rede.
ID de resposta
 replied_to_id integer

A ID da mensagem à qual esta mensagem está em resposta.
Direct To Id
 direct_to_id integer

Se definido, uma mensagem privada será enviada diretamente ao usuário com a ID indicada.
Difusão
 broadcast boolean

Postar mensagem como um comunicado para todos os usuários em um grupo.
Title
 title string

Título da mensagem a ser postada.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageListV2

Postar mensagem [PRETERIDO]

ID da operação:
PostMessage

Essa operação é usada para postar uma mensagem em um grupo ou no Feed da Empresa. Se a ID do grupo for fornecida, a mensagem será postada no grupo especificado, caso contrário, ela será postada no Feed da Empresa.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

ID exclusiva da rede.
ID do grupo
 group_id True integer

O grupo para o qual postar uma mensagem (0 = Todas as Empresas/Rede).
Texto da mensagem
 body True string

Sua mensagem a ser postada em sua rede.
ID de resposta
 replied_to_id integer

A ID da mensagem à qual esta mensagem está em resposta.
Direct To Id
 direct_to_id integer

Se definido, uma mensagem privada será enviada diretamente ao usuário com a ID indicada.
Difusão
 broadcast boolean

Postar mensagem como um comunicado para todos os usuários em um grupo.
Title
 title string

Título da mensagem a ser postada.
Tópico 1
 topic1 string

Tópico a ser aplicado à mensagem.
Tópico 2
 topic2 string

Tópico a ser aplicado à mensagem
Tópico 3
 topic3 string

Tópico a ser aplicado à mensagem.
Tópico 4
 topic4 string

Tópico a ser aplicado à mensagem
Tópico 5
 topic5 string

Tópico a ser aplicado à mensagem.
Tópico 6
 topic6 string

Tópico a ser aplicado à mensagem.
Tópico 7
 topic7 string

Tópico a ser aplicado à mensagem
Tópico 8
 topic8 string

Tópico a ser aplicado à mensagem.
Tópico 9
 topic9 string

Tópico a ser aplicado à mensagem.
Tópico 10
 topic10 string

Tópico a ser aplicado à mensagem.
Tópico 11
 topic11 string

Tópico a ser aplicado à mensagem.
Tópico 12
 topic12 string

Tópico a ser aplicado à mensagem.
Tópico 13
 topic13 string

Tópico a ser aplicado à mensagem.
Tópico 14
 topic14 string

Tópico a ser aplicado à mensagem.
Tópico 15
 topic15 string

Tópico a ser aplicado à mensagem.
Tópico 16
 topic16 string

Tópico a ser aplicado à mensagem.
Tópico 17
 topic17 string

Tópico a ser aplicado à mensagem.
Tópico 18
 topic18 string

Tópico a ser aplicado à mensagem.
Tópico 19
 topic19 string

Tópico a ser aplicado à mensagem.
Tópico 20
 topic20 string

Tópico a ser aplicado à mensagem.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Gatilhos

Quando há uma nova mensagem em um grupo (V2)

Essa operação é disparada quando uma nova mensagem é postada em um grupo.
Quando há uma nova mensagem em um grupo [PRETERIDO]

Esta ação foi preterida. Use quando houver uma nova mensagem em um grupo (V2).

Essa operação é disparada quando uma nova mensagem é postada em um grupo.
Quando há uma nova mensagem no meu feed seguido (V2)

Essa operação é disparada quando há uma nova mensagem em uma rede seguida por você.
Quando há uma nova mensagem no meu feed seguido [PRETERIDO]

Esta ação foi preterida. Use quando houver uma nova mensagem no meu feed seguido (V2).

Essa operação é disparada quando há uma nova mensagem em uma rede seguida por você.

Quando há uma nova mensagem em um grupo (V2)

ID da operação:
OnNewMessagesInGroupV2

Essa operação é disparada quando uma nova mensagem é postada em um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Identifer exclusivo da rede.
ID do grupo
 group_id True integer

Identificador exclusivo do grupo.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageListV2

Quando há uma nova mensagem em um grupo [PRETERIDO]

ID da operação:
OnNewMessagesInGroup

Esta ação foi preterida. Use quando houver uma nova mensagem em um grupo (V2).

Essa operação é disparada quando uma nova mensagem é postada em um grupo.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Identifer exclusivo da rede.
ID do grupo
 group_id True integer

Identificador exclusivo do grupo.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Quando há uma nova mensagem no meu feed seguido (V2)

ID da operação:
OnNewMessagesFollowingV2

Essa operação é disparada quando há uma nova mensagem em uma rede seguida por você.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Escolha uma rede.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageListV2

Quando há uma nova mensagem no meu feed seguido [PRETERIDO]

ID da operação:
OnNewMessagesFollowing

Esta ação foi preterida. Use quando houver uma nova mensagem no meu feed seguido (V2).

Essa operação é disparada quando há uma nova mensagem em uma rede seguida por você.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da rede
 network_id string

Escolha uma rede.

Retornos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Definições

Utilizador

Propriedades do usuário do Viva Engage.

Nome Caminho Tipo Description
Nome de usuário
 name string

Nome de usuário.
Cargo
 job_title string

Título do trabalho do usuário.
Localização
 location string

Localização do usuário.
Nome completo
 full_name string

Nome completo do usuário.
Nome
 first_name string

Nome do usuário.
Sobrenome
 last_name string

Sobrenome do usuário.
URL do perfil
 web_url string

URL do perfil do usuário.
Email
 email string

Email do usuário.
Data de nascimento
 birth_date string

Data de nascimento do usuário.
URL da foto
 mugshot_url string

URL de fotos do usuário.

Message

Propriedades de uma única mensagem do Viva Engage.

Nome Caminho Tipo Description
ID
 id integer

ID associada à postagem.
Texto
 content_excerpt string

Conteúdo de texto da postagem.
Remetente
 sender_id integer

ID exclusiva do usuário que postou a mensagem.
Respondeu a
 replied_to_id integer

ID da mensagem à qual essa mensagem é uma resposta.
Criado em
 created_at string

Hora em que a mensagem foi criada.
Rede
 network_id integer

A ID da mensagem de rede está associada.
Tipo
 message_type string

Descritor do tipo de mensagem.
Tipo de remetente
 sender_type string

Descrição do tipo de remetente.
URL
 url uri

URL da API da postagem.
Web Url
 web_url uri

URL da Web da postagem.
ID do grupo
 group_id integer

ID exclusiva do grupo que postou a mensagem.
Corpo da Mensagem
 body MessageBody

Conteúdo associado a uma única mensagem.
Thread ID
 thread_id integer

ID exclusiva do thread.
Mensagem direta
 direct_message boolean

Sinalizar para especificar se a postagem é uma mensagem direta.
ID do cliente
 client_type string

Tipo do cliente.
URL de cliente
 client_url uri

Link da Web do cliente.
Linguagem
 language string

Idioma usado na mensagem.
Usuário marcado
 notified_user_ids array of integer

Detalhes dos usuários notificados.
Privacidade
 privacy string

Detalhes da privacidade associada à mensagem.
liked_by
 liked_by LikedBy

Curtido por
É mensagem do sistema
 system_message boolean

Sinalizar para especificar se a postagem é uma mensagem gerada pelo sistema ou não.
Tópicos
 topics array of Topic

Lista de tópicos.

MessageV2

Propriedades de uma única mensagem do Viva Engage.

Nome Caminho Tipo Description
ID
 id integer

ID associada à postagem.
Texto
 content_excerpt string

Conteúdo de texto da postagem.
Remetente
 sender_id integer

ID exclusiva do usuário que postou a mensagem.
Respondeu a
 replied_to_id integer

ID da mensagem à qual essa mensagem é uma resposta.
Criado em
 created_at string

Hora em que a mensagem foi criada.
Rede
 network_id integer

A ID da mensagem de rede está associada.
Tipo
 message_type string

Descritor do tipo de mensagem.
Tipo de remetente
 sender_type string

Descrição do tipo de remetente.
URL
 url uri

URL da API da postagem.
Web Url
 web_url uri

URL da Web da postagem.
ID do grupo
 group_id integer

ID exclusiva do grupo que postou a mensagem.
Corpo da Mensagem
 body MessageBody

Conteúdo associado a uma única mensagem.
Thread ID
 thread_id integer

ID exclusiva do thread.
Mensagem direta
 direct_message boolean

Sinalizar para especificar se a postagem é uma mensagem direta.
ID do cliente
 client_type string

Tipo do cliente.
URL de cliente
 client_url uri

Link da Web do cliente.
Linguagem
 language string

Idioma usado na mensagem.
Usuário marcado
 notified_user_ids array of integer

Detalhes dos usuários notificados.
Privacidade
 privacy string

Detalhes da privacidade associada à mensagem.
liked_by
 liked_by LikedBy

Curtido por
É mensagem do sistema
 system_message boolean

Sinalizar para especificar se a postagem é uma mensagem gerada pelo sistema ou não.

Tópico

Propriedades de um único tópico.

Nome Caminho Tipo Description
ID
 id integer

Identificador exclusivo do tópico.
Nome
 name string

Nome do tópico.

PageableMessageList

Lista de uma ou várias mensagens.

Nome Caminho Tipo Description
Messages
 value array of Message

PageableMessageListV2

Lista de uma ou várias mensagens.

Nome Caminho Tipo Description
Messages
 value array of MessageV2

MessageList

Lista de uma ou várias mensagens.

Nome Caminho Tipo Description
Messages
 messages array of Message

messages

MessageListV2

Lista de uma ou várias mensagens.

Nome Caminho Tipo Description
Messages
 messages array of MessageV2

messages

MessageBody

Conteúdo associado a uma única mensagem.

Nome Caminho Tipo Description
Texto
 parsed string

Formato de texto analisado.
Sem formatação
 plain string

Formato de texto sem formatação.
Rico
 rich string

Formato rich text.

LikedBy

Curtido por

Nome Caminho Tipo Description
Contagem
 count integer

Número de curtidas distintas.
Names
 names array of object

Lista de pessoas que gostaram do post.
Nome Completo
 names.full_name string

O nome completo da pessoa que gostou da postagem.

Rede

Propriedades de uma única rede.

Nome Caminho Tipo Description
ID
 id string

Identificador exclusivo da rede.
Nome
 name string

Resumo da rede.
Link
 permalink string

Link da Web para a página da rede.

Entidade do Yammmer

Propriedades de uma única entidade do Viva Engage.

Nome Caminho Tipo Description
Description
 type string

Detalhes da entidade Viva Engage.
ID do grupo
 id integer

Identificador exclusivo do grupo.
Nome Completo
 full_name string

Nome da entidade Viva Engage.