Conector de Microsoft Teams para Jitterbit Integration Studio

Resumen

El conector de Microsoft Teams establece acceso a Microsoft Teams.

El conector de Microsoft Teams proporciona una interfaz para crear una conexión de Microsoft Teams, la base que se utiliza para generar instancias de actividades de Microsoft Teams. Estas actividades, una vez configuradas, interactúan con Microsoft Teams a través de la conexión.

Se accede al conector de Microsoft Teams desde la pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza para configurar primero una conexión de Microsoft Teams. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que están destinadas a usarse como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión específica de Microsoft Teams y sus actividades se denominan extremo de Microsoft Teams:

• Enumerar canales: Recupera una lista de canales para un equipo en Microsoft Teams y está destinado a usarse como objetivo en una operación.

• Agregar miembros: Agrega miembros a un canal en un equipo en Microsoft Teams y está destinado a usarse como objetivo en una operación.

• Agregar canales: Crea canales (con la opción de agregar miembros) en un equipo en Microsoft Teams y está destinado a ser utilizado como objetivo en una operación.

• Charlar: Recupera un chat existente o crea un nuevo chat en Microsoft Teams y está destinado a usarse como destino en una operación.

• Enviar mensaje: Envía un mensaje a un equipo y canal específicos en Microsoft Teams y está destinado a ser utilizado como objetivo en una operación.

Requisitos previos y versiones de API compatibles

El conector de Microsoft Teams requiere el uso de una versión de agente 10.1 o posterior. Estas versiones del agente descargan automáticamente la última versión del conector cuando es necesario.

El conector de Microsoft Teams utiliza la API REST de Microsoft Graph v1.0. Consulte la documentación de la API para obtener información sobre los nodos y campos del esquema.

El conector de Microsoft Teams requiere que se cree y registre una aplicación con Microsoft Entra ID con un conjunto específico de permisos. Cree y configure esta aplicación como se describe en Requisitos previos de Microsoft Teams antes de configurar el conector.

El conector de Microsoft Teams admite OAuth 2.0 mediante el proceso de registro de la aplicación Microsoft Entra ID.

Problemas conocidos

El conector de Microsoft Teams tiene este problema conocido:

• La prueba de una consultar en una actividad de Lista de canales de Microsoft Teams falla si el nombre de un equipo contiene espacios

  • Resumen: La prueba de una consultar en el paso 2 de una actividad Enumerar canales de Microsoft Teams falla con un error Consulta no válida si el nombre del equipo de Microsoft Teams contiene espacios.

  • Información adicional: El problema se limita a la prueba de la consultar. La configuración de la actividad aún se puede completar. En el tiempo de ejecución, la operación devolverá los detalles del canal esperados.

Solución de problemas

Si experimenta problemas con el conector de Microsoft Teams, se recomiendan estos pasos de solución de problemas:

1. Haga clic en el botón Probar en la configuración de conexión para garantizar que la conexión sea exitosa y para garantizar que se descargue la última versión del conector al agente (a menos que se utilice la política Deshabilitar actualización automática del conector política de la organización).

2. Asegúrese de que los registros de aplicaciones de Microsoft Entra ID asociados con la conexión no utilicen el Gráfico de Azure AD obsoleto.

3. Verifique los registros de operación para cualquier información escrita durante la ejecución de la operación.

4. Habilitar el registro de depurar de operación (para agentes de la nube o para agentes privados) para generar archivos de registro y datos adicionales.

5. Si utiliza agentes privados, puede habilitar el registro detallado del conector para este conector utilizando esta entrada de configuración específica de nombre y nivel de registrador:

   <logger name="org.jitterbit.connector.teams" level="DEBUG"/>
   

6. Si utiliza agentes privados, puede consultar los registros de agentes para obtener más información.

7. Para obtener más información sobre la solución de problemas, consulte Solución de problemas de funcionamiento.

8. Conexión: Al probar la conexión, puede recibir el error The user or administrator has not consented to use the application Si no se ha otorgado el consentimiento del administrador a alguno de los permisos de la API de Microsoft Graph.

   Para resolverlo, otorgue el consentimiento del administrador a cualquier permiso de API que lo requiera, como se documenta en Permisos de la API de Microsoft Graph en Prerrequisitos.