Alert Relay (versión preliminar)
Alert Relay ayuda a reemplazar la retirada de alertas de SharePoint con notificaciones modernas más enriquecidas. Devuelve cambios detallados de nivel de campo y HTML de alerta listo para usar para que pueda mostrar exactamente lo que cambió en lugar de las notificaciones modificadas genéricas.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - regiones de Azure Government - Azure regiones de China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Name | compatibilidad con independNET |
| URL | https://independnet.com.au/alert-relay/support |
| Correo Electrónico | support@alertbridge.com.au |
| Metadatos del conector | |
|---|---|
| Publicador | productos independNET |
| Sitio web | https://independnet.com.au/alert-relay/ |
| Directiva de privacidad | https://independnet.com.au/alert-relay/privacy |
| Categorías | Colaboración; Productividad |
Retransmisión de alertas
Alert Relay para Power Platform y Microsoft 365 Copilot
Alert Relay ayuda a las organizaciones a reemplazar las alertas clásicas de SharePoint por soluciones modernas de Power Automate y Copilot Studio. Compara SharePoint elementos, archivos y páginas con versiones anteriores y devuelve información de cambio estructurada, historial de versiones y contenido de notificación listo para usar sin necesidad de que los creadores compilen una lógica compleja de comparación de versiones SharePoint.
Overview
SharePoint desencadenadores pueden identificar que un elemento, archivo o página ha cambiado, pero no proporcionan una comparación completa de los valores anteriores y actuales.
La creación de esa comparación a menudo requiere que los creadores recuperen versiones, interpreten tokens de cambio, comparen campos y dar formato a los resultados para las notificaciones o el procesamiento de bajada.
Alert Relay centraliza que funcionan mediante acciones reutilizables para Power Automate y Copilot Studio.
Características clave
Alert Relay centraliza que funcionan mediante acciones reutilizables que pueden:
- identificar cambios detallados en el nivel de campo
- devolver valores de campo anteriores y actuales
- generar HTML listo para usar para SharePoint correos electrónicos de alerta
- recuperar historial de versiones de elementos, archivos y páginas
- comparar desde un token de desencadenador, cambiar token, etiqueta de versión o fecha
- dar formato a tipos de campo de SharePoint complejos admitidos
- devolver información estructurada para Power Automate y Microsoft 365 Copilot
Alert Relay admite listas de SharePoint, bibliotecas de documentos y bibliotecas de páginas de sitio.
Introducción
Un flujo de alertas de SharePoint típico incluye:
- Un desencadenador SharePoint, como Cuando se crea o modifica un elemento.
- Una acción de Retransmisión de alertas, como Obtener cambios de elemento o archivo como HTML de alerta.
- Un correo electrónico u otra acción de notificación que usa el asunto devuelto y el cuerpo HTML.
Para las condiciones, el formato personalizado o los escenarios del agente de Microsoft Copilot Studio, use Obtener cambios detallados de elementos o archivos y trabaje con la información de cambio estructurada que devuelve.
Para las versiones de SharePoint históricas, use Obtener historial de versiones de archivo o elemento.
Documentation
La documentación, la información de referencia de acciones, los ejemplos y las instrucciones de introducción están disponibles en:
Tutoriales en vídeo
Los tutoriales, ejemplos y vídeos de procedimientos paso a paso están disponibles en el canal de YouTube de Alert Relay:
Licencias y evaluación
Las licencias de Alert Relay son en todo el inquilino. Una sola versión de prueba o suscripción se aplica en el inquilino de Microsoft Entra, y sus unidades de uso se comparten mediante flujos y usuarios de Alert Relay en ese inquilino.
La prueba de 90 días se inicia automáticamente cuando cualquier acción de Alert Relay se ejecuta por primera vez en el inquilino e incluye 300 unidades de uso compartidas en la prueba. Para obtener más detalles y planes actuales, consulte Precios y licencias de Alert Relay.
Acciones
Obtener cambios detallados de elementos o archivos
Devuelve cambios detallados de nivel de campo entre la versión actual de un elemento, archivo o página de SharePoint y una versión anterior.
La acción devuelve información estructurada, incluidos los valores anteriores y actuales, los valores con formato y los metadatos de comparación. Úselo cuando un flujo o Microsoft Copilot Studio agente necesite inspeccionar, resumir o actuar sobre cambios individuales.
Obtener cambios de elemento o archivo como HTML de alerta
Genera HTML listo para usar que muestra lo que cambió en un elemento, archivo o página de SharePoint.
La acción también devuelve un asunto de correo electrónico sugerido, el título del elemento y el vínculo del elemento. Úselo para crear correos electrónicos de alertas SharePoint más enriquecidos sin crear expresiones complejas de comparación de HTML y versiones en cada flujo.
Obtener historial de versiones de elemento o archivo
Devuelve el historial de versiones enlazadas y paginables para un elemento, archivo o página de SharePoint.
La acción puede devolver campos SharePoint seleccionados y admite límites de versión, fecha y SharePoint desencadenador-token. Úselo para escenarios históricos de revisión, auditoría, informes, aprobación y flujo de trabajo compatible con versiones.
Análisis de la información de versión de SharePoint
Descodifica SharePoint información de la ventana del desencadenador y del token de cambio.
Use esta acción para recuperar la marca de tiempo del token, aplicar decisiones basadas en la fecha o la versión, y filtrar desencadenadores secundarios o borradores no deseados antes de llamar a una acción de cambio detallada.
Usos típicos
Alert Relay puede ayudarle a:
- reemplazar alertas de SharePoint clásicas por flujos de Power Automate
- enviar notificaciones con formato que muestran exactamente lo que cambió
- comparar valores anteriores y actuales para campos empresariales importantes
- realizar un seguimiento de los cambios en los metadatos del documento y las páginas de SharePoint
- recuperar SharePoint historial de versiones de archivo y elemento
- compilar flujos de trabajo de aprobación, revisión, gobernanza y auditoría
- proporcionar información de cambio SharePoint estructurada a Microsoft 365 Copilot
Autenticación y acceso
Alert Relay usa Microsoft Entra ID autenticación delegada.
SharePoint acceso se realiza en el contexto del usuario que ha iniciado sesión. Alert Relay no concede a los usuarios permisos adicionales de SharePoint, por lo que los usuarios ya deben tener acceso al sitio, lista, biblioteca, elemento o archivo pertinentes de SharePoint.
Requisitos y ámbito admitido
- Alert Relay admite SharePoint Online. no se admite SharePoint Server local.
- Las acciones se ejecutan cuando Power Automate u otro cliente compatible. Para las notificaciones de cambio, use un desencadenador de SharePoint adecuado para iniciar el flujo.
- Las comparaciones que usan tokens de desencadenador de SharePoint se basan en la ventana de desencadenador de SharePoint. La línea base resultante puede diferir de un límite de versión específico del elemento.
- El formato detallado está disponible para los tipos de campo de SharePoint admitidos. Consulte la documentación de Alert Relay para obtener la referencia de tipo de campo actual.
Support
Sitio web: https://independnet.com.au/alert-relay/
Soporte técnico: https://independnet.com.au/alert-relay/support
Correo electrónico: support@alertrelay.com.au
Directiva de privacidad: https://independnet.com.au/alert-relay/privacy
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Análisis de comparación desde |
Descodifica un token de cambio triggerWindowStartToken o SharePoint sin procesar y devuelve la marca de tiempo incrustada para las condiciones de flujo y las decisiones de línea de base. Esta acción no llama a SharePoint. |
| Obtener cambios detallados de elementos |
Recupera cambios detallados y con formato de nivel de campo para un documento o elemento de lista de SharePoint, comparando la versión actual con la versión anterior. Úselo cuando desee datos de cambios enriquecidos en lugar de las marcas de campo true/false integradas de estilo sharePoint. |
| Obtener HTML de alerta de elemento detallado |
Devuelve html de Retransmisión de alertas listo para usar para los cambios de elementos de SharePoint, diseñados principalmente para correos electrónicos de alerta de estilo SharePoint, pero también se pueden usar en documentos u otros destinos compatibles con HTML. |
Análisis de comparación desde
Descodifica un token de cambio triggerWindowStartToken o SharePoint sin procesar y devuelve la marca de tiempo incrustada para las condiciones de flujo y las decisiones de línea de base. Esta acción no llama a SharePoint.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Comparar desde
|
compareFrom | True | string |
TriggerWindowStartToken o token de cambio de SharePoint sin procesar para descodificar. Esta acción no admite etiquetas de versión ni valores de fecha y hora ISO. |
|
Timezone
|
timezone | string |
Identificador opcional de zona horaria de IANA para un valor de comparación local (por ejemplo, "America/New_York", "Europe/London", "Australia/Sydney"). Si se omite, solo se devuelve el valor UTC. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Success
|
success | boolean | |
|
Message
|
message | string | |
|
Hora UTC de fecha y hora del token
|
tokenDateTimeUTC | date-time |
Marca de tiempo del token en UTC. |
|
Fecha y hora del token local
|
tokenDateTimeLocal | date-time |
Marca de tiempo del token convertida en la zona horaria solicitada. |
|
Token descodificado
|
decodedToken | string |
Texto de token sin formato descodificado. Para la entrada de token sin procesar, coincide con el valor original. |
|
Is Base64 Token
|
isBase64Token | boolean |
True cuando el token entrante estaba codificado en base64. |
|
Sequence
|
sequence | integer |
Valor de secuencia de cambios de SharePoint incrustado en el token. |
|
GUID de lista
|
listGuid | uuid |
GUID de lista o biblioteca insertado en el token. |
|
Versión del token
|
tokenVersion | integer |
Número de versión del token. |
|
Tipo de token
|
tokenType | integer |
Número de tipo de token de SharePoint. |
|
Error
|
error | string |
Detalles del error cuando se produce un error en el análisis. |
Obtener cambios detallados de elementos
Recupera cambios detallados y con formato de nivel de campo para un documento o elemento de lista de SharePoint, comparando la versión actual con la versión anterior. Úselo cuando desee datos de cambios enriquecidos en lugar de las marcas de campo true/false integradas de estilo sharePoint.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección URL del sitio
|
siteUrl | True | string |
Dirección URL completa del sitio de SharePoint que contiene la lista o biblioteca (por ejemplo, |
|
Lista o biblioteca
|
listId | True | string |
GUID o título exacto de la lista o biblioteca de SharePoint. La lista desplegable devuelve valores GUID, pero la entrada manual puede usar un GUID o el título exacto de la lista. |
|
Id. de elemento
|
itemId | True | integer |
Id. del elemento o archivo de SharePoint para analizar los cambios (disponibles en las salidas del desencadenador como identificador). |
|
Comparar desde
|
triggerWindowStartToken | string |
Define el punto de partida para la comparación de cambios. Acepta el desencadenador de SharePoint {TriggerWindowStartToken} (recomendado), una etiqueta de versión como "5.0", un token de cambio de SharePoint sin procesar o una fecha y hora de línea base ISO 8601, como "2026-03-30" o "2026-03-30T14:15:00Z". Los valores de solo fecha se interpretan como medianoche en la zona horaria seleccionada o UTC si timezone está en blanco. Omita comparar con la versión anterior inmediatamente. |
|
|
Incluir versiones secundarias
|
includeMinorVersions | boolean |
Si las versiones secundarias o de borrador deben participar en la comparación. El valor predeterminado es false, lo que significa que solo se usan las versiones principales. |
|
|
Incluir campos sin cambios
|
includeUnchangedFields | boolean |
Si los campos no modificados deben incluirse en la respuesta. El valor predeterminado es true. |
|
|
Formato de fecha
|
dateFormat | string |
Formato de fecha personalizado para los campos DateTime (por ejemplo, "aaaa-MM-dd", "dd/MM/aaaa", "MM/dd/aaaa"). El valor predeterminado es "aaaa-MM-dd" si no se especifica. |
|
|
Formato de hora
|
timeFormat | string |
Formato de hora anexado a la fecha de los campos DateTime con hora (por ejemplo, "HH:mm:ss", "HH:mm", "hh:mm tt"). El valor predeterminado es "HH:mm:ss" si no se especifica. |
|
|
Timezone
|
timezone | string |
Identificador de zona horaria de IANA para la conversión de fecha y hora (por ejemplo, "America/New_York", "Europa/Londres", "Australia/Sídney"). El valor predeterminado es UTC si no se especifica. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Indica si la operación se completó correctamente. |
|
Message
|
message | string |
Mensaje legible que describe el resultado |
|
Campos modificados
|
changedFields | array of object |
Campos con seguimiento como una matriz. |
|
El valor de columna ha cambiado
|
changedFields.hasChanged | boolean |
True si el valor de este campo ha cambiado entre la versión anterior y la actual |
|
Valor de columna anterior (texto)
|
changedFields.previousAsString | string |
Valor anterior con formato como una cadena legible |
|
Nombre interno del campo
|
changedFields.internalName | string |
Nombre interno del campo de SharePoint |
|
Nombre del campo
|
changedFields.displayName | string |
Nombre para mostrar descriptivo para el campo |
|
Valor de columna anterior (detallado)
|
changedFields.previous |
Valor anterior sin formato. Esta propiedad es dinámica y puede ser una cadena, un número, un valor booleano, un objeto, una matriz o un valor NULL según el tipo de campo de SharePoint. |
|
|
Valor de columna actual (texto)
|
changedFields.currentAsString | string |
Valor actual con formato como una cadena legible |
|
Valor de columna actual (detallado)
|
changedFields.current |
Valor actual sin formato. Esta propiedad es dinámica y puede ser una cadena, un número, un valor booleano, un objeto, una matriz o un valor NULL según el tipo de campo de SharePoint. |
|
|
Tiene línea base de comparación
|
hasComparisonBaseline | boolean |
True si se resolvió una versión de línea base distinta para la comparación con la versión actual. |
|
Es la primera versión de línea base
|
isBaselineFirstVersion | boolean |
True si la versión de línea base resuelta es la primera versión registrada para el elemento o archivo. |
|
Etiqueta de versión actual
|
currentVersionLabel | string |
Etiqueta de versión de la versión actual (por ejemplo, "2.0", "5.0") |
|
Etiqueta de versión anterior
|
previousVersionLabel | string |
Etiqueta de versión usada para la comparación (por ejemplo, "1.0", "4.0") |
|
Título del elemento
|
itemTitle | string |
Título del elemento modificado |
|
Dirección URL del elemento
|
itemUrl | string |
Vínculo directo al elemento de SharePoint modificado |
|
Fecha de modificación
|
modifiedDate | date-time |
Marca de tiempo de la última modificación |
|
Modificado por
|
modifiedBy | string |
Nombre para mostrar del usuario que modificó por última vez el elemento |
|
Error
|
error | string |
Detalles del error si el valor correcto es false |
Obtener HTML de alerta de elemento detallado
Devuelve html de Retransmisión de alertas listo para usar para los cambios de elementos de SharePoint, diseñados principalmente para correos electrónicos de alerta de estilo SharePoint, pero también se pueden usar en documentos u otros destinos compatibles con HTML.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Dirección URL del sitio
|
siteUrl | True | string |
Dirección URL completa del sitio de SharePoint que contiene la lista o biblioteca. |
|
Lista o biblioteca
|
listId | True | string |
GUID o título exacto de la lista o biblioteca de SharePoint. La lista desplegable devuelve valores GUID, pero la entrada manual puede usar un GUID o el título exacto de la lista. |
|
Id. de elemento
|
itemId | True | integer |
Id. del elemento o archivo de SharePoint para analizar los cambios. |
|
Comparar desde
|
triggerWindowStartToken | string |
Define el punto de partida para la comparación de cambios. Acepta el desencadenador de SharePoint {TriggerWindowStartToken} (recomendado), una etiqueta de versión como "5.0", un token de cambio de SharePoint sin procesar o una fecha y hora de línea base ISO 8601, como "2026-03-30" o "2026-03-30T14:15:00Z". Los valores de solo fecha se interpretan como medianoche en la zona horaria seleccionada o UTC si timezone está en blanco. Omita comparar con la versión anterior inmediatamente. |
|
|
Incluir versiones secundarias
|
includeMinorVersions | boolean |
Si las versiones secundarias o de borrador deben participar en la comparación. El valor predeterminado es false, lo que significa que solo se usan las versiones principales. |
|
|
Incluir campos sin cambios
|
includeUnchangedFields | boolean |
Si los campos no modificados deben incluirse en el CÓDIGO HTML generado. El valor predeterminado es true. |
|
|
Formato de fecha
|
dateFormat | string |
Formato de fecha personalizado para los campos DateTime (por ejemplo, "aaaa-MM-dd", "dd/MM/aaaa"). El valor predeterminado es "aaaa-MM-dd" si no se especifica. |
|
|
Formato de hora
|
timeFormat | string |
Formato de hora anexado a la fecha de los campos DateTime con hora (por ejemplo, "HH:mm:ss", "HH:mm", "hh:mm tt"). |
|
|
Timezone
|
timezone | string |
Identificador de zona horaria de IANA para la conversión de fecha y hora (por ejemplo, "America/New_York", "Europa/Londres", "Australia/Sídney"). |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Success
|
success | boolean |
Indica si la operación se completó correctamente. |
|
Message
|
message | string |
Mensaje legible que describe el resultado |
|
Cuerpo HTML
|
htmlBody | string |
Cuerpo HTML completo listo para usarse en correos electrónicos de alerta u otros destinos compatibles con HTML |
|
Asunto sugerido
|
subject | string |
Línea de asunto sugerida para la alerta |
|
Título del elemento
|
itemTitle | string |
Título del elemento modificado |
|
Dirección URL del elemento
|
itemUrl | string |
Vínculo directo al elemento de SharePoint modificado |
|
Es nuevo elemento
|
isNewItem | boolean |
True si la alerta es para un nuevo elemento o archivo de SharePoint en lugar de una actualización a una existente. |
|
Error
|
error | string |
Detalles del error si el valor correcto es false |