Saltar al contenido

Conexión de Microsoft Teams

Introducción

Una conexión de Microsoft Teams, creada utilizando el conector de Microsoft Teams, establece acceso a Microsoft Teams. Una vez que se configura una conexión, se pueden crear instancias de actividades de Microsoft Teams asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Microsoft Teams

Una nueva conexión de Microsoft Teams se crea utilizando el conector de Microsoft Teams desde una de estas ubicaciones:

Una conexión de Microsoft Teams existente se puede editar desde estas ubicaciones:

Configurar una conexión de Microsoft Teams

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Microsoft Teams se describe a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú que enumera las variables existentes de las que elegir.

  • Nombre de conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Microsoft Teams y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Microsoft Teams, que se refiere tanto a una conexión específica como a sus actividades.

  • ID de inquilino: Ingresa el ID de inquilino. El ID de inquilino se puede obtener al iniciar sesión en Microsoft Entra ID.

  • ID de cliente: Ingresa el ID de cliente. Tanto el ID de cliente como el valor del secreto de cliente se asignan cuando tu aplicación se registra siguiendo las instrucciones en Requisitos previos de Microsoft Teams.

  • Secreto de cliente: Ingresa el valor del secreto de cliente. Tanto el ID de cliente como el valor del secreto de cliente se asignan cuando tu aplicación se registra siguiendo las instrucciones en Requisitos previos de Microsoft Teams.

  • Nombre de usuario: Ingresa el nombre de usuario que utilizas para iniciar sesión en Microsoft Entra ID.

  • Contraseña: Ingresa la contraseña que utilizas para iniciar sesión en Microsoft Entra ID.

  • Configuraciones opcionales: Haz clic para expandir estas configuraciones opcionales:

    • Ámbito: Ingresa los permisos de API de Microsoft Teams habilitados para el registro de tu aplicación. Por defecto, este campo contiene los 31 permisos de API necesarios para usar todas las actividades, como se describe en Requisitos previos.

      Consejo

      Si no estás ingresando los 31 permisos de API, puedes ingresar .default en este campo. El ámbito .default incluye todos los permisos de API otorgados a tu registro de aplicación, lo que podría incluir permisos adicionales no requeridos por el conector de Microsoft Teams.

    • Usar configuraciones de proxy (Solo agente privado): Al usar un agente privado, se puede seleccionar esta configuración para utilizar configuraciones de proxy de agente privado.

  • Prueba: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la Política de Desactivar Actualización Automática del Conector política de organización.

  • Guardar Cambios: Haz clic para guardar y cerrar la configuración de la conexión.

  • Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Posible error de conexión

Puedes recibir el error El usuario o administrador no ha consentido el uso de la aplicación si no se han otorgado permisos de administrador para cualquier permiso de la API de Microsoft Graph.

Para resolverlo, otorga consentimiento de administrador a cualquier permiso de API que lo requiera, como se documenta en Permisos de la API de Microsoft Graph en Requisitos previos.

Próximos pasos

Después de que se ha creado una conexión de Microsoft Teams, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

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

  • Agregar Miembros: Agrega miembros a un canal en un equipo en Microsoft Teams y está destinado a ser utilizado como un 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 un objetivo en una operación.

  • Chat: Recupera un chat existente o crea un nuevo chat en Microsoft Teams y está destinado a ser utilizado como un objetivo 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 un objetivo en una operación.