Retransmissão de Alerta (versão prévia)
A Retransmissão de Alertas ajuda a substituir a desativação de alertas do SharePoint por notificações mais avançadas e modernas. Ele retorna alterações detalhadas no nível do campo e HTML de alerta pronto para uso para que você possa mostrar exatamente o que foi alterado em vez de notificações modificadas genéricas.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões 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: – Azure Governamental regiões - Azure regiões da China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões 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 | Premium | Todas as regiões 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 | |
|---|---|
| Name | Suporte independNET |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| Metadados do conector | |
|---|---|
| Publicador | Produtos independNET |
| Site da Web | https://independnet.com.au/alert-relay/ |
| Política de privacidade | https://independnet.com.au/alert-relay/privacy |
| Categorias | Colaboração; Produtividade |
Retransmissão de
Retransmissão de Alerta para Power Platform e Microsoft 365 Copilot
A Retransmissão de Alertas ajuda as organizações a substituir alertas clássicos de SharePoint por soluções modernas de Power Automate e Copilot Studio. Ele compara SharePoint itens, arquivos e páginas com versões anteriores e retorna informações de alteração estruturadas, histórico de versão e conteúdo de notificação pronto para uso sem exigir que os criadores criem lógica de comparação de versão SharePoint complexa.
Visão geral
SharePoint gatilhos podem identificar que um item, arquivo ou página foi alterado, mas eles não fornecem uma comparação completa dos valores anteriores e atuais.
Criar essa comparação geralmente exige que os criadores recuperem versões, interpretem tokens de alteração, comparem campos e formatem resultados para notificações ou processamento downstream.
A Retransmissão de Alerta centraliza que funcionam por meio de ações reutilizáveis para Power Automate e Copilot Studio.
Principais características
A Retransmissão de Alerta centraliza que funcionam por meio de ações reutilizáveis que podem:
- identificar alterações detalhadas no nível do campo
- retornar valores de campo anteriores e atuais
- gerar HTML pronto para uso para emails de alerta SharePoint
- recuperar histórico de versões de item, arquivo e página
- comparar de um token de gatilho, token de alteração, rótulo de versão ou data
- formatar tipos de campo SharePoint complexos com suporte
- retornar informações estruturadas para Power Automate e Microsoft 365 Copilot
A Retransmissão de Alertas dá suporte a listas de SharePoint, bibliotecas de documentos e bibliotecas de Páginas do Site.
Introdução
Um fluxo de alerta de SharePoint típico inclui:
- Um gatilho SharePoint, como quando um item é criado ou modificado.
- Uma ação de Retransmissão de Alerta, como Obter Item ou Alterações de Arquivo como HTML de Alerta.
- Um email ou outra ação de notificação que usa o assunto retornado e o corpo HTML.
Para condições, formatação personalizada ou cenários de agente Microsoft Copilot Studio, use Get Detailed Item or File Changes e trabalhe com as informações de alteração estruturadas retornadas.
Para versões de SharePoint históricas, use Obter Histórico de Versões de Item ou Arquivo.
Documentation
Documentação, informações de referência de ação, exemplos e diretrizes de introdução estão disponíveis em:
Documentação da Retransmissão de
Tutoriais de vídeo
Instruções passo a passo, exemplos e vídeos de instruções estão disponíveis no canal da Retransmissão de Alertas no YouTube:
Retransmissão de Alertas no YouTube
Licenciamento e avaliação
O licenciamento da Retransmissão de Alertas é em todo o locatário. Uma única avaliação ou assinatura se aplica ao locatário Microsoft Entra e suas unidades de uso são compartilhadas por fluxos de Retransmissão de Alertas e usuários nesse locatário.
A avaliação de 90 dias é iniciada automaticamente quando qualquer ação de Retransmissão de Alerta é executada pela primeira vez no locatário e inclui 300 unidades de uso compartilhadas na avaliação. Para obter planos atuais e mais detalhes, consulte preços e licenciamento da Retransmissão de Alertas.
Ações
Obter alterações detalhadas de item ou arquivo
Retorna alterações detalhadas no nível do campo entre a versão atual de um item, arquivo ou página SharePoint e uma versão anterior.
A ação retorna informações estruturadas, incluindo valores anteriores e atuais, valores formatados e metadados de comparação. Use-o quando um fluxo ou Microsoft Copilot Studio agente precisar inspecionar, resumir ou agir sobre alterações individuais.
Obter alterações de item ou arquivo como HTML de alerta
Gera HTML pronto para uso mostrando o que foi alterado em um item SharePoint, arquivo ou página.
A ação também retorna um assunto de email sugerido, título do item e link do item. Use-o para criar emails de alerta mais avançados SharePoint sem criar expressões de comparação de html e de versão complexas em todos os fluxos.
Obter histórico de versões de item ou arquivo
Retorna o histórico de versão delimitado e paginável para um item, arquivo ou página SharePoint.
A ação pode retornar campos SharePoint selecionados e dá suporte a limites de versão, data e SharePoint token de gatilho. Use-o para cenários históricos de revisão, auditoria, relatório, aprovação e fluxo de trabalho com reconhecimento de versão.
Analisar informações de versão do SharePoint
Decodifica SharePoint informações de janela de gatilho e token de alteração.
Use essa ação para recuperar o carimbo de data/hora do token, aplicar decisões baseadas em data ou versão e filtrar gatilhos de versão secundária ou de rascunho indesejados antes de chamar uma ação de alteração detalhada.
Usos Típicos
A Retransmissão de Alertas pode ajudá-lo a:
- substituir alertas de SharePoint clássicos por fluxos de Power Automate
- enviar notificações formatadas mostrando exatamente o que foi alterado
- comparar valores anteriores e atuais para campos de negócios importantes
- controlar alterações em metadados de documentos e páginas de SharePoint
- recuperar SharePoint histórico de versões do arquivo e do item
- criar fluxos de trabalho de aprovação, revisão, governança e auditoria
- fornecer informações de alteração de SharePoint estruturadas para Microsoft 365 Copilot
Autenticação e acesso
A Retransmissão de Alerta usa Microsoft Entra ID autenticação delegada.
SharePoint acesso é executado no contexto do usuário conectado. A Retransmissão de Alertas não concede aos usuários permissões adicionais de SharePoint, portanto, os usuários já devem ter acesso ao site, lista, biblioteca, item ou arquivo relevantes do SharePoint.
Requisitos e escopo com suporte
- A Retransmissão de Alerta dá suporte ao SharePoint Online. Servidor do SharePoint local não tem suporte.
- As ações são executadas quando chamadas por Power Automate ou outro cliente com suporte. Para notificações de alteração, use um gatilho de SharePoint apropriado para iniciar o fluxo.
- Comparações usando tokens de gatilho SharePoint são baseadas na janela de gatilho SharePoint. A linha de base resultante pode ser diferente de um limite de versão específico do item.
- A formatação detalhada está disponível para tipos de campo de SharePoint com suporte. Consulte a documentação da Retransmissão de Alerta para a referência do tipo de campo atual.
Suporte
Site: https://independnet.com.au/alert-relay/
Suporte: https://independnet.com.au/alert-relay/support
E-mail: support@alertrelay.com.au
Política de privacidade: https://independnet.com.au/alert-relay/privacy
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
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 |
Ações
| Analisar Comparação de |
Decodifica um token de alteração TriggerWindowStartToken ou bruto do SharePoint e retorna o carimbo de data/hora inserido para condições de fluxo e decisões de linha de base. Essa ação não chama o SharePoint. |
| Obter alterações detalhadas de item |
Recupera alterações detalhadas no nível do campo formatadas para um item ou documento de lista do SharePoint, comparando a versão atual com a versão anterior. Use isso quando quiser dados de alteração avançada em vez dos sinalizadores de campo true/false no estilo interno do SharePoint. |
| Obter HTML de alerta de item detalhado |
Retorna HTML de Retransmissão de Alerta pronto para uso para alterações de item do SharePoint, projetado principalmente para emails de alerta no estilo do SharePoint, mas também utilizável em documentos ou outros destinos compatíveis com HTML. |
Analisar Comparação de
Decodifica um token de alteração TriggerWindowStartToken ou bruto do SharePoint e retorna o carimbo de data/hora inserido para condições de fluxo e decisões de linha de base. Essa ação não chama o SharePoint.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Comparar de
|
compareFrom | True | string |
TriggerWindowStartToken ou token de alteração bruto do SharePoint para decodificar. Os rótulos de versão e os valores de data/data e hora iso não são compatíveis com essa ação. |
|
Timezone
|
timezone | string |
ID de fuso horário IANA opcional para um valor de comparação local (por exemplo, 'América/New_York', 'Europa/Londres', 'Austrália/Sydney'). Se omitido, somente o valor UTC será retornado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean | |
|
Message
|
message | string | |
|
Hora da data do token UTC
|
tokenDateTimeUTC | date-time |
Carimbo de data/hora do token em UTC. |
|
Hora da Data do Token Local
|
tokenDateTimeLocal | date-time |
Carimbo de data/hora do token convertido no fuso horário solicitado. |
|
Token decodificado
|
decodedToken | string |
Texto de token bruto decodificado. Para entrada de token bruto, isso corresponde ao valor original. |
|
É o token Base64
|
isBase64Token | boolean |
True quando o token de entrada foi codificado em base64. |
|
Sequence
|
sequence | integer |
Valor da sequência de alterações do SharePoint inserido no token. |
|
Guid de lista
|
listGuid | uuid |
Guid de lista ou biblioteca inserido no token. |
|
Versão do token
|
tokenVersion | integer |
Número da versão do token. |
|
Tipo de token
|
tokenType | integer |
Número do tipo de token do SharePoint. |
|
Erro
|
error | string |
Detalhes do erro ao analisar falha. |
Obter alterações detalhadas de item
Recupera alterações detalhadas no nível do campo formatadas para um item ou documento de lista do SharePoint, comparando a versão atual com a versão anterior. Use isso quando quiser dados de alteração avançada em vez dos sinalizadores de campo true/false no estilo interno do SharePoint.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do site
|
siteUrl | True | string |
URL completa do site do SharePoint que contém a lista ou biblioteca (por exemplo, |
|
Lista ou biblioteca
|
listId | True | string |
GUID ou o título exato da lista ou biblioteca do SharePoint. A lista suspensa retorna valores GUID, mas a entrada manual pode usar um GUID ou o título exato da lista. |
|
ID do Item
|
itemId | True | integer |
ID do item ou arquivo do SharePoint para analisar as alterações (disponíveis em saídas de gatilho como ID). |
|
Comparar de
|
triggerWindowStartToken | string |
Define o ponto de partida para a comparação de alterações. Aceita {TriggerWindowStartToken} do gatilho do SharePoint (recomendado), um rótulo de versão como '5.0', um token de alteração bruto do SharePoint ou uma data de linha de base ISO 8601/date-time, como '2026-03-30' ou '2026-03-30T14:15:00Z'. Os valores somente data são interpretados como meia-noite no Fuso Horário selecionado ou UTC se o Fuso Horário estiver em branco. Omita para comparar com a versão imediatamente anterior. |
|
|
Incluir versões secundárias
|
includeMinorVersions | boolean |
Se as versões secundárias ou de rascunho devem participar da comparação. O padrão é false, o que significa que apenas as versões principais são usadas. |
|
|
Incluir campos inalterados
|
includeUnchangedFields | boolean |
Se os campos inalterados devem ser incluídos na resposta. O padrão é true. |
|
|
Formato de data
|
dateFormat | string |
Formato de data personalizado para campos DateTime (por exemplo, 'yyy-MM-dd', 'dd/MM/yyyyy', 'MM/dd/yyyy'). O padrão será 'yyy-MM-dd' se não for especificado. |
|
|
Formato de hora
|
timeFormat | string |
Formato de hora acrescentado à data para campos DateTime com hora (por exemplo, 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). O padrão será 'HH:mm:ss' se não for especificado. |
|
|
Timezone
|
timezone | string |
ID de fuso horário IANA para conversão de data/hora (por exemplo, 'América/New_York', 'Europa/Londres', 'Austrália/Sydney'). O padrão será UTC se não for especificado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean |
Indica se a operação foi concluída com êxito |
|
Message
|
message | string |
Mensagem legível por humanos que descreve o resultado |
|
Campos alterados
|
changedFields | array of object |
Campos rastreados como uma matriz. |
|
O valor da coluna foi alterado
|
changedFields.hasChanged | boolean |
True se o valor desse campo foi alterado entre a versão anterior e a atual |
|
Valor da coluna anterior (texto)
|
changedFields.previousAsString | string |
Valor anterior formatado como uma cadeia de caracteres legível por humanos |
|
Nome interno do campo
|
changedFields.internalName | string |
Nome do campo interno do SharePoint |
|
Nome do campo
|
changedFields.displayName | string |
Nome de exibição amigável para o campo |
|
Valor da coluna anterior (detalhado)
|
changedFields.previous |
Valor anterior bruto. Essa propriedade é dinâmica e pode ser uma cadeia de caracteres, número, booliano, objeto, matriz ou nulo, dependendo do tipo de campo do SharePoint. |
|
|
Valor da coluna atual (texto)
|
changedFields.currentAsString | string |
Valor atual formatado como uma cadeia de caracteres legível por humanos |
|
Valor da coluna atual (detalhado)
|
changedFields.current |
Valor atual bruto. Essa propriedade é dinâmica e pode ser uma cadeia de caracteres, número, booliano, objeto, matriz ou nulo, dependendo do tipo de campo do SharePoint. |
|
|
Tem linha de base de comparação
|
hasComparisonBaseline | boolean |
True se uma versão de linha de base distinta foi resolvida para comparação com a versão atual. |
|
É a primeira versão da linha de base
|
isBaselineFirstVersion | boolean |
True se a versão de linha de base resolvida for a primeira versão já registrada para o item ou arquivo. |
|
Rótulo de versão atual
|
currentVersionLabel | string |
Rótulo de versão da versão atual (por exemplo, '2.0', '5.0') |
|
Rótulo de versão anterior
|
previousVersionLabel | string |
Rótulo de versão usado para comparação (por exemplo, '1.0', '4.0') |
|
Título do Item
|
itemTitle | string |
Título do item alterado |
|
Item URL
|
itemUrl | string |
Link direto para o item do SharePoint alterado |
|
Data de Modificação
|
modifiedDate | date-time |
Carimbo de data/hora da última modificação |
|
Modificado por
|
modifiedBy | string |
Nome de exibição do usuário que modificou o item pela última vez |
|
Erro
|
error | string |
Detalhes do erro se o êxito for falso |
Obter HTML de alerta de item detalhado
Retorna HTML de Retransmissão de Alerta pronto para uso para alterações de item do SharePoint, projetado principalmente para emails de alerta no estilo do SharePoint, mas também utilizável em documentos ou outros destinos compatíveis com HTML.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do site
|
siteUrl | True | string |
URL completa do site do SharePoint que contém a lista ou biblioteca. |
|
Lista ou biblioteca
|
listId | True | string |
GUID ou o título exato da lista ou biblioteca do SharePoint. A lista suspensa retorna valores GUID, mas a entrada manual pode usar um GUID ou o título exato da lista. |
|
ID do Item
|
itemId | True | integer |
ID do item ou arquivo do SharePoint a ser analisado para obter alterações. |
|
Comparar de
|
triggerWindowStartToken | string |
Define o ponto de partida para a comparação de alterações. Aceita {TriggerWindowStartToken} do gatilho do SharePoint (recomendado), um rótulo de versão como '5.0', um token de alteração bruto do SharePoint ou uma data de linha de base ISO 8601/date-time, como '2026-03-30' ou '2026-03-30T14:15:00Z'. Os valores somente data são interpretados como meia-noite no Fuso Horário selecionado ou UTC se o Fuso Horário estiver em branco. Omita para comparar com a versão imediatamente anterior. |
|
|
Incluir versões secundárias
|
includeMinorVersions | boolean |
Se as versões secundárias ou de rascunho devem participar da comparação. O padrão é false, o que significa que apenas as versões principais são usadas. |
|
|
Incluir campos inalterados
|
includeUnchangedFields | boolean |
Se os campos inalterados devem ser incluídos no HTML gerado. O padrão é true. |
|
|
Formato de data
|
dateFormat | string |
Formato de data personalizado para campos DateTime (por exemplo, 'yyy-MM-dd', 'dd/MM/yyyyy'). O padrão será 'yyy-MM-dd' se não for especificado. |
|
|
Formato de hora
|
timeFormat | string |
Formato de hora acrescentado à data para campos DateTime com hora (por exemplo, 'HH:mm:ss', 'HH:mm', 'hh:mm tt'). |
|
|
Timezone
|
timezone | string |
ID de fuso horário IANA para conversão de data/hora (por exemplo, 'América/New_York', 'Europa/Londres', 'Austrália/Sydney'). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean |
Indica se a operação foi concluída com êxito |
|
Message
|
message | string |
Mensagem legível por humanos que descreve o resultado |
|
Corpo HTML
|
htmlBody | string |
Corpo HTML completo pronto para uso em emails de alerta ou em outros destinos compatíveis com HTML |
|
Assunto Sugerido
|
subject | string |
Linha de assunto sugerida para o alerta |
|
Título do Item
|
itemTitle | string |
Título do item alterado |
|
Item URL
|
itemUrl | string |
Link direto para o item do SharePoint alterado |
|
É Novo Item
|
isNewItem | boolean |
True se o alerta for para um novo item ou arquivo do SharePoint em vez de uma atualização para um existente. |
|
Erro
|
error | string |
Detalhes do erro se o êxito for falso |