Enviar una notificación de Microsoft Teams desde una operación de Studio en Jitterbit Studio

Introducción

Este patrón de diseño de integración envía un mensaje formateado a un canal de Microsoft Teams desde una operación de Studio. La operación utiliza el conector de Microsoft Teams para publicar un mensaje en un equipo y canal específicos a través de Microsoft Graph API. Este patrón se usa comúnmente para notificar a un equipo cuando ocurre un evento significativo, como la recepción de un nuevo pedido, la creación de un registro o la finalización de una operación con errores.

Antes de configurar el conector, se debe completar los requisitos previos de Microsoft Teams, que requieren un registro de aplicación de Azure en Microsoft Entra ID.

Patrón de diseño

La operación de Studio sigue el patrón de transformación:

La actividad de origen proporciona los datos utilizados para construir el mensaje (por ejemplo, un resultado de consulta de base de datos, un registro de Salesforce o una salida de script). La transformación construye el texto del mensaje. La actividad Send Message de Microsoft Teams publica el mensaje en el equipo y canal seleccionados.

Parte 1: Completar los requisitos previos

El conector de Microsoft Teams se autentica mediante OAuth 2.0, lo que requiere un registro de aplicación en Microsoft Entra ID (anteriormente Azure Active Directory).

Sigue los pasos en requisitos previos de Microsoft Teams para:

1. Registrar una aplicación en el portal de Microsoft Entra ID y anotar el Identificador de la aplicación (cliente) y el Identificador del directorio (inquilino).

2. Crear un secreto de cliente para la aplicación y anotar su valor. El valor solo es visible cuando se crea por primera vez.

3. Otorgar los permisos requeridos de Microsoft Graph API y hacer clic en Grant admin consent.

Mantén disponibles el identificador del inquilino, el identificador del cliente, el valor del secreto de cliente, así como tu nombre de usuario y contraseña de Microsoft Entra ID para la configuración de la conexión.

Parte 2: Configurar la conexión de Microsoft Teams

1. En Studio, abre tu proyecto y haz clic en la pestaña Project endpoints and connectors en la paleta de componentes de diseño.

2. Haz clic en el conector de Microsoft Teams para abrir la configuración de conexión.

3. Connection Name: Escribe un nombre como Microsoft Teams.

4. Tenant ID: Escribe el identificador del directorio (inquilino) del registro de tu aplicación en Microsoft Entra ID.

5. Client ID: Escribe el identificador de la aplicación (cliente) del registro de tu aplicación.

6. Client Secret: Escribe el valor del secreto de cliente del registro de tu aplicación.

   Consejo

   Almacena el secreto de cliente, el nombre de usuario y la contraseña como variables de proyecto con sus valores ocultos. Esto mantiene las credenciales sensibles fuera de la configuración de conexión directa y facilita su rotación sin editar el proyecto.

7. Username: Escribe el nombre de usuario que utilizas para iniciar sesión en Microsoft Entra ID.

8. Password: Escribe la contraseña de esa cuenta.

9. Haz clic en Test y luego en Save Changes.

Parte 3: Configurar la actividad Send Message

1. En la paleta de componentes de diseño, expande el extremo de Microsoft Teams y arrastra el tipo de actividad Send Message al lienzo de diseño.

2. Haz doble clic en la actividad para abrir su configuración.

Paso 1: Escribe un nombre y selecciona un equipo

1. Name: Escribe un nombre como Post Teams Notification.

2. En la tabla Select a Team, haz clic en una fila para seleccionar el equipo que contiene el canal de destino. La tabla se completa desde el extremo de Microsoft Teams. Si la tabla está vacía, verifica que la prueba de conexión haya sido exitosa.

3. Haz clic en Siguiente.

Paso 2: Selecciona un canal

1. En la tabla Seleccionar un canal, haz clic en una fila para seleccionar el canal donde deseas publicar. La tabla muestra los canales del equipo que seleccionaste en el paso anterior.

2. Configuración opcional: Si deseas enviar mensajes con formato HTML en lugar de texto sin formato, expande Configuración opcional y selecciona Tipo de contenido: 'HTML'.

3. Haz clic en Siguiente.

Paso 3: Revisa los esquemas de datos

El conector genera esquemas de solicitud y respuesta a partir del punto de conexión de Microsoft Teams. Revísalos y haz clic en Finalizado.

El esquema de solicitud contiene los siguientes campos bajo sendMessageRequest:

• message: El contenido de texto del mensaje. Obligatorio.
• contentType: El tipo de contenido del mensaje. Este campo se completa automáticamente según la configuración Tipo de contenido: 'HTML' del paso anterior.
• attachment: Un objeto opcional para adjuntar un archivo, que contiene los campos fileName y fileData. Los archivos mayores a 4 MB causarán que la operación falle.

Parte 4: Asigna el mensaje en una transformación

En la transformación que precede la actividad Enviar mensaje, asigna el campo message del esquema de solicitud a un script que construya la cadena del mensaje.

Por ejemplo, para enviar una notificación sobre un nuevo pedido, el script de transformación para sendMessageRequest/message podría ser:

<trans>
"New order #" + $order_id + " received from " + $customer_name + " for $" + $order_total
</trans>

Donde order_id, customer_name y order_total son variables globales completadas por un script anterior o asignadas desde la actividad de origen.

Verifica la integración

Implementa y ejecuta la operación para probar la notificación. Consulta los registros de operación para confirmar que la actividad Enviar mensaje se completó sin errores. Si el mensaje no aparece en el canal de Teams, verifica que se hayan seleccionado el equipo y el canal correctos en la configuración de la actividad y que se haya otorgado el consentimiento del administrador para todos los permisos de API requeridos.