Partilhar via

Viva Engage

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

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

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Standard Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - 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
Editora Microsoft
Sítio Web https://products.office.com/yammer/yammer-overview
Política de privacidade https://privacy.microsoft.com
Categorias Communication

Importante

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

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

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

Problemas conhecidos e limitações

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:

  • Receber todas as mensagens
  • Obter mensagens num grupo
  • Obter mensagens em um thread
  • Receber as mensagens do meu feed 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 um máximo de 100 grupos, devido às limitações da API REST do Viva Engagement:

  • Obter grupos

Observação

A API Viva Engage pode restringir o número de mensagens retornadas. Se isso ocorrer, para contornar 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 Viva Engage, visite Limites de taxa da API do Yammer.

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

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

O recurso Aplicativos de 3ª Parte 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á desativado.

As ações a seguir permitem que você crie uma postagem de "Anúncio" 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 abordará esse problema em uma atualização futura.

  • Mensagem Postal
  • PostMessageV2

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:
Iniciar sessão com o Microsoft Entra ID Iniciar sessão com o Microsoft Entra ID Todas as regiões Não compartilhável
Padrão [DEPRECATED] Esta 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

Iniciar sessão com o Microsoft Entra ID

ID de autenticação: entraIDUserLogin

Aplicável: Todas as regiões

Iniciar sessão com o Microsoft Entra ID

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta 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.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Nome Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos
Frequência das sondagens de desencadeamento 1 15 segundos

Ações

Curtir mensagem

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

Esta ação foi preterida. Por favor, use Obter as mensagens do meu feed de Seguir (V3) em vez disso.

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

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

Esta ação foi preterida. Por favor, use Obter as mensagens do meu feed de Seguir (V3) em vez disso.

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

Obtém todas as redes às quais o usuário pertence.
Obter detalhes do utilizador

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

Obtém todos os grupos. Se o meu = 1, obtenha apenas os 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).

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

Esta operação retorna as mensagens postadas em um grupo.
Obter mensagens em um grupo [DEPRECATED]

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

Esta 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).

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

Esta operação retorna as mensagens postadas em um thread.
Obter mensagens em um thread [DEPRECATED]

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

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

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

Esta operação retorna todas as mensagens públicas na rede Viva Engage do usuário conectado. Corresponde a "Todos" as conversas na interface web do Viva Engage.
Obter todas as mensagens (V3)

Esta operação retorna todas as mensagens públicas na rede Viva Engage do usuário conectado. Corresponde a "Todos" as conversas na interface web do Viva Engage.
Obter todas as mensagens [DEPRECATED]

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

Esta operação retorna todas as mensagens públicas na rede Viva Engage do usuário conectado. Corresponde a "Todos" as conversas na interface Web do Yammer.
Postar mensagem (V2)

Esta operação é usada para postar uma mensagem em um grupo ou no feed de todas as empresas. Se o ID do grupo for fornecido, a mensagem será postada no grupo especificado, caso contrário, será publicada no Feed de Todas as Empresas.
Postar mensagem [DEPRECATED]

Esta operação é usada para postar uma mensagem em um grupo ou no feed de todas as empresas. Se o ID do grupo for fornecido, a mensagem será postada no grupo especificado, caso contrário, será publicada no Feed de Todas as Empresas.

Curtir mensagem

ID da Operação:
LikeMessage

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da mensagem
 message_id True string

ID exclusivo da mensagem.

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

ID da Operação:
GetMessagesFollowingV2

Esta ação foi preterida. Por favor, use Obter as mensagens do meu feed de Seguir (V3) em vez disso.

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Identificador único da rede.
Mais velhos do que
 older_than integer

Retorna mensagens anteriores ao ID da mensagem especificado como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se estiver a visualizar 20 mensagens e a mais antiga for o número 2912, pode acrescentar "?older_than=2912" ao seu pedido para obter as 20 mensagens anteriores às que está a ver.
Mais recente do que
 newer_than integer

Retorna mensagens mais recentes do que o ID da mensagem especificado como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver vendo mensagens e a mensagem mais recente retornada for 3516, você pode 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 retornará apenas o início do thread (primeira mensagem) para cada thread. Este parâmetro destina-se a aplicativos que precisam exibir históricos de mensagens recolhidos. threaded=extended retornará as mensagens iniciais do thread e as duas mensagens mais recentes, todas ordenadas por atividade, pois são visualizadas na visualização padrão na interface da Web do Viva Engage.
Limite
 limit integer

Retorne apenas o número especificado de mensagens.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageList

Obter as mensagens do meu feed Seguir (V3)

ID da Operação:
GetMessagesFollowingV3

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Identificador único da rede.
Mais velhos do que
 older_than integer

Retorna mensagens anteriores ao ID da mensagem especificado como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se estiver a visualizar 20 mensagens e a mais antiga for o número 2912, pode acrescentar "?older_than=2912" ao seu pedido para obter as 20 mensagens anteriores às que está a ver.
Mais recente do que
 newer_than integer

Retorna mensagens mais recentes do que o ID da mensagem especificado como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver vendo mensagens e a mensagem mais recente retornada for 3516, você pode 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 retornará apenas o início do thread (primeira mensagem) para cada thread. Este parâmetro destina-se a aplicativos que precisam exibir históricos de mensagens recolhidos. threaded=extended retornará as mensagens iniciais do thread e as duas mensagens mais recentes, todas ordenadas por atividade, pois são visualizadas na visualização padrão na interface da Web do Viva Engage.
Limite
 limit integer

Retorne apenas o número especificado de mensagens.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageListV2

Obter as mensagens do meu feed Seguir [DEPRECATED]

ID da Operação:
GetMessagesFollowing

Esta ação foi preterida. Por favor, use Obter as mensagens do meu feed de Seguir (V3) em vez disso.

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Identificador único da rede.
Mais velhos do que
 older_than integer

Retorna mensagens anteriores ao ID da mensagem especificado como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se estiver a visualizar 20 mensagens e a mais antiga for o número 2912, pode acrescentar "?older_than=2912" ao seu pedido para obter as 20 mensagens anteriores às que está a ver.
Mais recente do que
 newer_than integer

Retorna mensagens mais recentes do que o ID da mensagem especificado como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver vendo mensagens e a mensagem mais recente retornada for 3516, você pode 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.
Limite
 limit integer

Retorne apenas 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 as páginas subsequentes

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Obter as minhas redes

ID da Operação:
GetNetworks

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

Regressos

response
array of Network

Obter detalhes do utilizador

ID da Operação:
GetUserDetailsById

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID de utilizador
 user_id True integer

Identificador exclusivo do usuário.

Regressos

Propriedades do usuário Viva Engage.

User
User

Obter grupos

ID da Operação:
GetGroups

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

ID da rede
o meu
 mine integer

Usado para obter grupos dos quais o usuário faz parte
Mostrar todos os grupos de empresas
 showAllCompanyGroup integer

Usado para mostrar Todos os grupos de empresas

Regressos

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).

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Identificador único da rede.
ID do grupo
 group_id True integer

Identificador exclusivo do grupo.
Mais velhos do que
 older_than integer

Retorna mensagens anteriores ao ID da mensagem especificado como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se estiver a visualizar 20 mensagens e a mais antiga for o número 2912, pode acrescentar "?older_than=2912" ao seu pedido para obter as 20 mensagens anteriores às que está a ver.
Mais recente do que
 newer_than integer

Retorna mensagens mais recentes do que o ID da mensagem especificado como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver vendo mensagens e a mensagem mais recente retornada for 3516, você pode 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 retornará apenas o início do thread (primeira mensagem) para cada thread. Este parâmetro destina-se a aplicativos que precisam exibir históricos de mensagens recolhidos. threaded=extended retornará as mensagens iniciais do thread e as duas mensagens mais recentes, todas ordenadas por atividade, pois são visualizadas na visualização padrão na interface da Web do Viva Engage.
Limite
 limit integer

Retorne apenas o número especificado de mensagens.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageList

Obter mensagens em um grupo (V3)

ID da Operação:
GetMessagesInGroupV3

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Identificador único da rede.
ID do grupo
 group_id True integer

Identificador exclusivo do grupo.
Mais velhos do que
 older_than integer

Retorna mensagens em threads em que a mensagem mais recente do thread é mais antiga do que o ID de mensagem especificado. Qualquer thread com um ID de mensagem mais recente que seja mais recente ou igual ao ID especificado não terá nenhuma de suas mensagens retornadas por esta consulta.
Mais recente do que
 newer_than integer

Retorna mensagens em threads em que a mensagem mais recente do thread é mais recente do que o ID de mensagem especificado. Qualquer thread com um ID de mensagem mais recente que seja mais antigo ou igual ao ID especificado não terá nenhuma de suas mensagens retornadas por esta consulta.
Tipo de thread de mensagens
 threaded string

Threaded=true retornará apenas o início do thread (primeira mensagem) para cada thread. Este parâmetro destina-se a aplicativos que precisam exibir históricos de mensagens recolhidos. threaded=extended retornará as mensagens iniciais do thread e as duas mensagens mais recentes, todas ordenadas por atividade, pois são visualizadas na visualização padrão na interface da Web do Viva Engage.
Limite
 limit integer

Retorne apenas o número especificado de mensagens.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageListV2

Obter mensagens em um grupo [DEPRECATED]

ID da Operação:
GetMessagesInGroup

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

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Identificador único da rede.
ID do grupo
 group_id True integer

Identificador exclusivo do grupo.
Mais velhos do que
 older_than integer

Retorna mensagens anteriores ao ID da mensagem especificado como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se estiver a visualizar 20 mensagens e a mais antiga for o número 2912, pode acrescentar "?older_than=2912" ao seu pedido para obter as 20 mensagens anteriores às que está a ver.
Mais recente do que
 newer_than integer

Retorna mensagens mais recentes do que o ID da mensagem especificado como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver vendo mensagens e a mensagem mais recente retornada for 3516, você pode 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.
Limite
 limit integer

Retorne apenas 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 as páginas subsequentes

Regressos

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).

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Thread ID
 thread_id True integer

Identificador exclusivo do thread.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageList

Obter mensagens em um thread (V3)

ID da Operação:
GetMessagesInThreadV3

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Thread ID
 thread_id True integer

Identificador exclusivo do thread.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageListV2

Obter mensagens em um thread [DEPRECATED]

ID da Operação:
GetMessagesInThread

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

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

Parâmetros

Nome Chave Necessário Tipo Descrição
Thread ID
 thread_id True integer

Identificador exclusivo do thread.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

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).

Esta operação retorna todas as mensagens públicas na rede Viva Engage do usuário conectado. Corresponde a "Todos" as conversas na interface web do Viva Engage.

Parâmetros

Nome Chave Necessário Tipo Descrição
Identificador único da rede
 network_id string

ID da rede
Mais velhos do que
 older_than integer

Retorna mensagens anteriores ao ID da mensagem especificado como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se estiver a visualizar 20 mensagens e a mais antiga for o número 2912, pode acrescentar "?older_than=2912" ao seu pedido para obter as 20 mensagens anteriores às que está a ver.
Mais recente do que
 newer_than integer

Retorna mensagens mais recentes do que o ID da mensagem especificado como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver vendo mensagens e a mensagem mais recente retornada for 3516, você pode 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 retornará apenas o início do thread (primeira mensagem) para cada thread. Este parâmetro destina-se a aplicativos que precisam exibir históricos de mensagens recolhidos. threaded=extended retornará as mensagens iniciais do thread e as duas mensagens mais recentes, todas ordenadas por atividade, pois são visualizadas na visualização padrão na interface da Web do Viva Engage.
Limite
 limit integer

Retorne apenas o número especificado de mensagens.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageList

Obter todas as mensagens (V3)

ID da Operação:
GetAllMessagesV3

Esta operação retorna todas as mensagens públicas na rede Viva Engage do usuário conectado. Corresponde a "Todos" as conversas na interface web do Viva Engage.

Parâmetros

Nome Chave Necessário Tipo Descrição
Identificador único da rede
 network_id string

ID da rede
Mais velhos do que
 older_than integer

Retorna mensagens anteriores ao ID da mensagem especificado como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se estiver a visualizar 20 mensagens e a mais antiga for o número 2912, pode acrescentar "?older_than=2912" ao seu pedido para obter as 20 mensagens anteriores às que está a ver.
Mais recente do que
 newer_than integer

Retorna mensagens mais recentes do que o ID da mensagem especificado como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver vendo mensagens e a mensagem mais recente retornada for 3516, você pode 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 retornará apenas o início do thread (primeira mensagem) para cada thread. Este parâmetro destina-se a aplicativos que precisam exibir históricos de mensagens recolhidos. threaded=extended retornará as mensagens iniciais do thread e as duas mensagens mais recentes, todas ordenadas por atividade, pois são visualizadas na visualização padrão na interface da Web do Viva Engage.
Limite
 limit integer

Retorne apenas o número especificado de mensagens.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
PageableMessageListV2

Obter todas as mensagens [DEPRECATED]

ID da Operação:
GetAllMessages

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

Esta operação retorna todas as mensagens públicas na rede Viva Engage do usuário conectado. Corresponde a "Todos" as conversas na interface Web do Yammer.

Parâmetros

Nome Chave Necessário Tipo Descrição
Identificador único da rede
 network_id string

ID da rede
Mais velhos do que
 older_than integer

Retorna mensagens anteriores ao ID da mensagem especificado como uma cadeia de caracteres numérica. Isso é útil para paginar mensagens. Por exemplo, se estiver a visualizar 20 mensagens e a mais antiga for o número 2912, pode acrescentar "?older_than=2912" ao seu pedido para obter as 20 mensagens anteriores às que está a ver.
Mais recente do que
 newer_than integer

Retorna mensagens mais recentes do que o ID da mensagem especificado como uma cadeia de caracteres numérica. Isso deve ser usado ao sondar novas mensagens. Se você estiver vendo mensagens e a mensagem mais recente retornada for 3516, você pode 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.
Limite
 limit integer

Retorne apenas 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 as páginas subsequentes

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Postar mensagem (V2)

ID da Operação:
PostMessageV2

Esta operação é usada para postar uma mensagem em um grupo ou no feed de todas as empresas. Se o ID do grupo for fornecido, a mensagem será postada no grupo especificado, caso contrário, será publicada no Feed de Todas as Empresas.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

ID único da rede.
ID do grupo
 group_id True integer

O grupo para o qual postar uma mensagem (0 = Toda a Empresa/Rede).
Texto da mensagem
 body True string

A sua mensagem para ser publicada na sua rede.
Respondeu a Id
 replied_to_id integer

O ID da mensagem a que esta mensagem está em resposta.
Direto para Id
 direct_to_id integer

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

Postar mensagem como um anúncio para todos os usuários de um grupo.
Title
 title string

Título da mensagem a ser publicada.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageListV2

Postar mensagem [DEPRECATED]

ID da Operação:
PostMessage

Esta operação é usada para postar uma mensagem em um grupo ou no feed de todas as empresas. Se o ID do grupo for fornecido, a mensagem será postada no grupo especificado, caso contrário, será publicada no Feed de Todas as Empresas.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

ID único da rede.
ID do grupo
 group_id True integer

O grupo para o qual postar uma mensagem (0 = Toda a Empresa/Rede).
Texto da mensagem
 body True string

A sua mensagem para ser publicada na sua rede.
Respondeu a Id
 replied_to_id integer

O ID da mensagem a que esta mensagem está em resposta.
Direto para Id
 direct_to_id integer

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

Postar mensagem como um anúncio para todos os usuários de um grupo.
Title
 title string

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

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

Tópico a aplicar à mensagem
Tópico 3
 topic3 string

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

Tópico a aplicar à 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 aplicar à 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.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Gatilhos

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

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

Esta ação foi preterida. Em vez disso, use Quando houver uma nova mensagem em um grupo (V2).

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

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

Esta ação foi preterida. Por favor, use Quando houver uma nova mensagem no meu feed seguido (V2) em vez disso.

Esta operação é acionada 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 é acionada quando uma nova mensagem é postada em um grupo.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Identificador único da rede.
ID do Grupo
 group_id True integer

Identificador exclusivo do grupo.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageListV2

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

ID da Operação:
OnNewMessagesInGroup

Esta ação foi preterida. Em vez disso, use Quando houver uma nova mensagem em um grupo (V2).

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Identificador único da rede.
ID do Grupo
 group_id True integer

Identificador exclusivo do grupo.

Regressos

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

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Escolha uma rede.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageListV2

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

ID da Operação:
OnNewMessagesFollowing

Esta ação foi preterida. Por favor, use Quando houver uma nova mensagem no meu feed seguido (V2) em vez disso.

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

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da rede
 network_id string

Escolha uma rede.

Regressos

Lista de uma ou várias mensagens.

Lista de Mensagens
MessageList

Definições

User

Propriedades do usuário Viva Engage.

Nome Percurso Tipo Descrição
Nome de utilizador
 name string

Nome de Utilizador.
Cargo
 job_title string

Cargo de utilizador.
Localização
 location string

Localização do utilizador.
Nome completo
 full_name string

Nome completo do usuário.
Nome próprio
 first_name string

Nome do usuário.
Apelido
 last_name string

Apelido do utilizador.
URL do perfil
 web_url string

URL do perfil de usuário.
Email
 email string

E-mail do usuário.
Data de nascimento
 birth_date string

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

URL da foto do usuário.

Message

Propriedades de uma única mensagem do Viva Engage.

Nome Percurso Tipo Descrição
ID
 id integer

ID associado à postagem.
Texto
 content_excerpt string

Conteúdo de texto da postagem.
Remetente
 sender_id integer

ID exclusivo do usuário que publicou a mensagem.
Respondeu a
 replied_to_id integer

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

Hora em que a mensagem foi criada.
Rede
 network_id integer

O ID da mensagem de rede está associado.
Tipo
 message_type string

Descrição do tipo de mensagem.
Tipo de remetente
 sender_type string

Descrição do tipo de remetente.
Endereço 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 exclusivo do grupo que publicou a mensagem.
Corpo da Mensagem
 body MessageBody

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

ID exclusivo do thread.
Mensagem direta
 direct_message boolean

Sinalize para especificar se a postagem é uma mensagem direta.
ID de Cliente
 client_type string

Tipo de cliente.
URL do Cliente
 client_url uri

Link web do cliente.
Linguagem
 language string

Idioma usado na mensagem.
Usuário com tags
 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

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

Lista de tópicos.

MensagemV2

Propriedades de uma única mensagem do Viva Engage.

Nome Percurso Tipo Descrição
ID
 id integer

ID associado à postagem.
Texto
 content_excerpt string

Conteúdo de texto da postagem.
Remetente
 sender_id integer

ID exclusivo do usuário que publicou a mensagem.
Respondeu a
 replied_to_id integer

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

Hora em que a mensagem foi criada.
Rede
 network_id integer

O ID da mensagem de rede está associado.
Tipo
 message_type string

Descrição do tipo de mensagem.
Tipo de remetente
 sender_type string

Descrição do tipo de remetente.
Endereço 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 exclusivo do grupo que publicou a mensagem.
Corpo da Mensagem
 body MessageBody

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

ID exclusivo do thread.
Mensagem direta
 direct_message boolean

Sinalize para especificar se a postagem é uma mensagem direta.
ID de Cliente
 client_type string

Tipo de cliente.
URL do Cliente
 client_url uri

Link web do cliente.
Linguagem
 language string

Idioma usado na mensagem.
Usuário com tags
 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

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

Tópico

Propriedades de um único tópico.

Nome Percurso Tipo Descrição
ID
 id integer

Identificador exclusivo do tópico.
Nome
 name string

Nome do tópico.

PageableMessageList

Lista de uma ou várias mensagens.

Nome Percurso Tipo Descrição
Messages
 value array of Message

PageableMessageListV2

Lista de uma ou várias mensagens.

Nome Percurso Tipo Descrição
Messages
 value array of MessageV2

Lista de mensagens

Lista de uma ou várias mensagens.

Nome Percurso Tipo Descrição
Messages
 messages array of Message

messages

MessageListV2

Lista de uma ou várias mensagens.

Nome Percurso Tipo Descrição
Messages
 messages array of MessageV2

messages

Corpo da mensagem

Conteúdo associado a uma única mensagem.

Nome Percurso Tipo Descrição
Texto
 parsed string

Formato de texto analisado.
Simples
 plain string

Formato de texto simples.
Rico
 rich string

Formato rich text.

GosteiPor

Curtido por

Nome Percurso Tipo Descrição
Contar
 count integer

Número de gostos distintos.
Names
 names array of object

Lista de pessoas que curtiram o post.
Nome Completo
 names.full_name string

O nome completo da pessoa que curtiu a postagem.

Rede

Propriedades de uma única rede.

Nome Percurso Tipo Descrição
ID
 id string

Identificador único da rede.
Nome
 name string

Resumo da rede.
Link
 permalink string

Link da Web para a página da rede.

YammmerEntity

Propriedades de uma única entidade Viva Engage.

Nome Percurso Tipo Descrição
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.