- 인쇄
::: (정보) ()앱을 다운로드하려면 방문하세요: 라이브러리:::
Microsoft 365 커넥터
Teams, Outlook, Office 제품군과 같은 Microsoft 앱과의 통합을 위한 앱입니다.
목적
이 문서를 사용하여 튤립 앱을 Teams, Office Suite 및 Outlook과 같은 Microsoft 365 제품과 통합하세요.
사전 요구 사항
::: (정보) ()참고: 이 커넥터를 사용하기 전에 Entra ID에서 Oauth2 인증 정보를 생성해야 합니다. 이 가이드에 따라 필요한 자격 증명을 생성하세요. Oauth2::를 사용하여 MS Graph API를 Tulip에 연결합니다:
API 문서
이 커넥터에 필요한 범위
커넥터 기능
1) 모든 팀 가져오기
목적
이 커넥터는 사용자가 Microsoft 팀 계정을 사용하여 소속된 모든 팀을 가져옵니다.
엔드포인트
엔드포인트에 대한 HTTP GET 호출 - https://graph.micrsoft.com:443/v1.0/me/joinedTeams
필수 입력
입력이 필요하지 않습니다.
필수 출력 추출기
- teamID: 다른 작업을 수행하는 데 사용되는 팀의 고유 식별자입니다.
- 팀 이름: 팀의 표시 이름입니다.
- 팀 설명: 팀에 대한 설명입니다.
2) 팀의 모든 채널 가져오기
목적
이 커넥터는 팀ID를 입력으로 전달하여 팀의 모든 채널을 가져옵니다.
엔드포인트
엔드포인트에 대한 HTTP GET 호출 - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels
필수 입력
전달할 URL 매개변수는 다음과 같습니다.
- 팀 ID
필수 출력 추출기
- channelId: 다른 작업을 수행하는 데 사용되는 채널의 고유 식별자입니다.
- channelName: 채널의 표시 이름입니다.
- channelDescription: 채널에 대한 설명입니다.
3) 새 채널 만들기
목적
- 팀 ID, 채널 이름, 채널 설명을 입력으로 전달하면 Tulip이 입력된 채널 이름으로 새 채널을 생성합니다. API의 응답은 채널의 메타데이터와 다양한 속성입니다. 이를 통해 채널에서 데이터를 가져오고 업데이트하는 데 추가로 사용할 수 있습니다.
- Microsoft Graph V1.0 API에서 가져온 정보는 다른 커넥터 기능으로 파이프되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.
엔드포인트
엔드포인트에 대한 HTTP POST 호출 - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels
필수 입력
요청 본문으로 전송되는 파라미터는 다음과 같습니다.
- 팀 ID
- 채널 이름
- 채널 설명
필수 출력 추출기
- channelId: 다른 작업을 수행하는 데 사용되는 채널의 고유 식별자입니다.
- channelName: 채널의 표시 이름입니다.
- channelDescription: 채널에 대한 설명입니다.
4) 채널 속성 업데이트
목적
- 사용자는 팀 아이디, 채널 아이디, 새 채널 이름, 새 채널 설명을 입력으로 전달하면 튤립은 제공된 새 채널 이름과 설명으로 새 채널을 업데이트합니다. API의 응답은 채널의 메타데이터와 다양한 속성이 됩니다. 이를 통해 채널에서 데이터를 가져오고 업데이트하는 데 추가로 사용할 수 있습니다.
- Microsoft Graph V1.0 API에서 가져온 정보는 다른 커넥터 기능으로 파이핑되는 Tulip 앱, Tulip 테이블 또는 Tulip 변수 내에서 추가로 사용할 수 있습니다.
엔드포인트
엔드포인트 https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}에 대한 HTTP PATCH 호출
필수 입력
다음은 URL 및/또는 요청 본문의 일부로 전송되는 매개변수입니다.
- 팀 ID
- 채널 ID
- 채널 이름
- 채널 설명
필수 출력 추출기
출력 추출기는 필요하지 않습니다.
5) 채널에 메시지 보내기
목적
사용자가 팀 ID, 채널 ID, 제목, 메시지 내용을 입력으로 전달하면 Tulip이 제공된 메시지 내용으로 메시지를 전송합니다.
엔드포인트
엔드포인트에 대한 HTTP POST 호출 - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages
필수 입력
다음은 URL 및/또는 요청 본문의 일부로 전송되는 매개변수입니다.
- 팀 ID
- 채널 ID
- 제목
- 메시지 내용
필수 출력 추출기
출력 추출기가 필요하지 않습니다.
6) 특정 채널의 모든 메시지 가져오기
목적
이 커넥터는 특정 채널의 모든 메시지를 가져옵니다.
엔드포인트
엔드포인트에 대한 HTTP GET 호출 - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages
필수 입력
전달해야 할 URL 매개변수는 다음과 같습니다.
- 팀 ID
- 채널 ID
필수 출력 추출기
- messageId: 다른 작업을 수행하는 데 사용되는 메시지의 고유 식별자입니다.
- 메시지 내용: 메시지의 내용입니다.
- messageFrom: 발신자의 표시 이름입니다.
7) 메시지에 답장하기
목적
사용자는 팀 아이디, 채널 아이디, 제목, 메시지 내용을 입력으로 전달하여 메시지에 답장할 수 있으며, 튤립은 제공된 메시지 내용으로 답장을 보냅니다.
엔드포인트
엔드포인트에 대한 HTTP POST 호출 - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/채널/{채널ID}/메시지/{메시지ID}/답장
필수 입력
다음은 URL 및/또는 요청 본문의 일부로 전송되는 매개변수입니다.
- 팀 ID
- 채널 ID
- 메시지 ID
- 메시지 내용
필수 출력 추출기
출력 추출기는 필요하지 않습니다.
8) 채널 삭제
목적
사용자가 팀 아이디와 채널 아이디를 입력으로 전달하면 튤립이 제공된 입력값으로 특정 채널을 삭제합니다.
엔드포인트
엔드포인트 -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}로 HTTP DELETE 호출합니다.
필수 입력
전달할 URL 매개변수는 다음과 같습니다.
- 팀 ID
- 채널 ID
필수 출력 추출기
출력 추출기는 필요하지 않습니다.
9) 팀에 대한 팀원 목록 가져오기
목적
이 커넥터는 특정 팀의 모든 팀원을 가져옵니다.
엔드포인트
https://graph.microsoft.com:443/v1.0/teams/{teamID}/members 엔드포인트에 대한 HTTP GET 호출
필수 입력
전달할 URL 매개변수는 다음과 같습니다.
- 팀 ID
필수 출력 추출기
- 멤버 ID: 멤버의 고유 식별자입니다.
- 멤버 이름: 회원의 표시 이름입니다.
- 회원 EmailID: 회원의 이메일 ID입니다.
- 팀원 역할: 팀 채널에서 멤버의 역할입니다.
추가 읽기
Microsoft 커넥터에 대한 자세한 정보를 확인하세요.