Conector Microsoft Teams
  • 13 May 2024
  • 4 Minutos para leer
  • Colaboradores

Conector Microsoft Teams


Resumen del artículo

::: (info) () Para descargar la aplicación, visite: Biblioteca:::

Conector Microsoft 365

Para la integración con aplicaciones de Microsoft como Teams, Outlook y Office Suite.

Propósito

Utiliza este documento para integrar tus Tulip Apps con productos de Microsoft 365 como Teams, Office Suite y Outlook.

Requisitos previos

::: (info) () Nota: La información de autenticación Oauth2 debe ser generada en Entra ID antes de usar este Conector. Sigue esta guía para generar las credenciales requeridas.
Conectarla API MS Graph a Tulip con Oauth2 :::

Documentación API

Documentación de Microsoft Graph API

Ámbitos necesarios para este conector

Funciones del conector

1) Obtener todos los equipos

Propósito

Este conector obtendrá todos los equipos de los que forma parte un usuario mediante su cuenta de Microsoft teams.

Punto final

Llamada HTTP GET al punto final - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

Entrada requerida

No se requieren entradas

Salida requerida Extractor

  1. teamID: Identificador único del equipo que se utilizará para realizar las demás tareas.
  2. teamName: Nombre del equipo.
  3. teamDescription: Descripción del equipo.

2) Obtener todos los canales de un equipo

Propósito

Este conector obtendrá todos los canales de un equipo pasando el teamID como entrada.

Punto final

Llamada HTTP GET al punto final - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Entrada requerida

A continuación se indican los parámetros de URL que deben introducirse

  1. Id. de equipo

Salida requerida Extractor

  1. channelId: Identificador único del Canal que se utilizará para realizar las demás tareas.
  2. channelName: El nombre para mostrar del Canal.
  3. channelDescription: Descripción del canal.

3) Crear un nuevo canal

Propósito

  1. Los usuarios pueden introducir un ID de equipo, un nombre de canal y una descripción del canal y Tulip creará un nuevo canal con el nombre proporcionado. La respuesta de la API serán los metadatos y varias propiedades del canal. Esto se puede utilizar para obtener y actualizar los datos del canal.
  2. La información se extrae de la API de Microsoft Graph V1.0 y puede ser utilizada dentro de las aplicaciones de Tulip, tablas de Tulip o variables de Tulip que se canalizarán en otras funciones del conector.

Punto final

Llamada HTTP POST al punto final - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Entrada requerida

Los siguientes son los parámetros que se envían como el cuerpo de la solicitud

  1. ID de equipo
  2. Nombre del canal
  3. Descripción del canal

Salida Requerida Extractor

  1. channelId: Identificador único del Canal que se utilizará para realizar las demás tareas.
  2. channelName:Nombre para mostrar del canal.
  3. channelDescription: Descripción del canal.

4) Actualizar las propiedades del canal

Propósito

  1. Los usuarios pueden introducir un ID de equipo, un ID de canal, un nombre de canal nuevo y una descripción de canal nueva. Tulip actualizará un canal nuevo con el nombre y la descripción proporcionados. La respuesta de la API serán los metadatos y varias propiedades del canal. Esto se puede utilizar para obtener y actualizar los datos del canal.
  2. La información se extrae de la API de Microsoft Graph V1.0 y puede ser utilizada dentro de las aplicaciones de Tulip, tablas de Tulip o variables de Tulip que se canalizarán en otras funciones del conector.

Punto final

Llamada HTTP PATCH al punto final https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Entrada requerida

Los siguientes son los parámetros que se envían como parte de la URL y/o el cuerpo de la solicitud

  1. ID de equipo
  2. ID de canal
  3. Nombre del canal
  4. Descripción del canal

Extractor de salida requerido

No se requiere ningún extractor de salida.

5) Enviar un mensaje a un canal

Propósito

Los usuarios pueden pasar un ID de equipo, ID de canal, asunto y contenido del mensaje como entrada y Tulip enviará un mensaje con el contenido del mensaje proporcionado.

Punto final

Llamada HTTP POST al punto final - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages

Entrada requerida

Los siguientes son los parámetros que se envían como parte de la URL y/o del cuerpo de la solicitud

  1. ID de equipo
  2. ID de canal
  3. Asunto
  4. Contenido del mensaje

Extractor de salida requerido

No requerimos ningún extractor de salida.

6) Obtener todos los Mensajes de un Canal específico

Propósito

Este conector obtendrá todos los mensajes de un canal específico.

Punto final

Llamada HTTP GET al punto final - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages

Entrada obligatoria

A continuación se indican los parámetros de URL que deben introducirse.

  1. ID de equipo
  2. ID de canal

Salida requerida Extractor

  1. messageId: Identificador único del Mensaje que se utilizará para realizar las demás tareas.
  2. messageContent: El contenido del mensaje.
  3. messageFrom: Nombre del remitente.

7) Responder a un mensaje

Propósito

Los usuarios pueden pasar un ID de equipo, ID de canal, asunto y contenido del mensaje como entrada para responder a un mensaje y Tulip enviará una respuesta con el contenido del mensaje proporcionado.

Punto final

Llamada HTTP POST al punto final - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

Entrada obligatoria

Los siguientes son los parámetros que se envían como parte de la URL y/o del cuerpo de la solicitud

  1. ID de equipo
  2. ID de canal
  3. ID de mensaje
  4. Contenido del mensaje

Extractor de salida requerido

No se requiere ningún extractor de salida.

8) Borrar un canal

Propósito

Los usuarios pueden pasar un ID de equipo y un ID de canal como entrada y Tulip eliminará el canal específico con las entradas proporcionadas.

Punto final

Llamada HTTP DELETE al punto final -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Entrada requerida

Los siguientes son los parámetros de URL que se deben pasar

  1. ID de equipo
  2. ID de canal

Extractor de salida necesario

No se requiere ningún extractor de salida.

9) Obtener la lista de miembros de un equipo

Propósito

Este conector obtendrá todos los miembros de un equipo específico.

Punto final

Llamada HTTP GET al punto final https://graph.microsoft.com:443/v1.0/teams/{teamID}/members

Entrada obligatoria

A continuación se indican los parámetros de URL que deben introducirse.

  1. ID de equipo

Salida requerida Extractor

  1. Id. de miembro: Identificador único del Miembro.
  2. Nombre del miembro: El nombre para mostrar del Miembro.
  3. EmailID Miembro: El ID de correo electrónico del Miembro.
  4. Rol del miembro: El rol de un miembro en el Canal de Equipo.

Más información

Más información sobre Microsoft Connectors


¿Te ha sido útil este artículo?