Azure Communication Chat
Azure Communication Services 채팅 기능을 활용하는 커넥터입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL | https://azure.microsoft.com/services/communication-services |
| 전자 메일 | acssolutions@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://azure.microsoft.com/services/communication-services |
| 개인 정보 보호 정책 | https://privacy.microsoft.com |
| 카테고리 | Communication |
Azure Communication Services 채팅은 플랫폼 간 애플리케이션에 실시간 텍스트 통신을 추가하는 데 도움이 됩니다.
필수 조건
계속하려면 다음이 필요합니다.
- 사용자 지정 커넥터 기능이 있는 Microsoft Power Apps 또는 Power Automate 계획
- Azure 구독
- Azure Communication Services 리소스
자격 증명을 가져오는 방법
1 Azure Communication Services 리소스 설정
2 연결 문자열 인증
- Azure Communication Services 리소스 엔드포인트 URL을 사용하여 새 연결을 만들 수 있습니다.
커넥터 시작
Azure Communication Services 리소스를 설정한 후 사용자 액세스 토큰을 생성합니다. 커넥터 작업에 이 토큰을 사용합니다.
알려진 문제 및 제한 사항
이 시점에서 알려진 문제 또는 제한 사항이 없습니다.
자주 묻는 질문(FAQ)
- 액세스 토큰을 생성하려면 어떻게 해야 하나요?
- Azure Communication Services ID 커넥터를 사용하여 새 사용자 ID를 생성하고 사용자에 대한 액세스 토큰을 새로 고칠 수 있습니다. 포털을 통해 수동으로 테스트할 수도 있습니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 엔드포인트 URL | 시큐어스트링 (보안 문자열) | Azure Communication Services 엔드포인트 URL입니다. | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 채팅 스레드 나열 |
채팅 스레드를 나열합니다. |
| 채팅 스레드 만들기 |
채팅 스레드를 만듭니다. |
| 채팅 스레드 메시지 나열 |
채팅 스레드의 메시지를 나열합니다. |
| 채팅 스레드 삭제 |
채팅 스레드를 삭제합니다. |
| 채팅 스레드 속성 가져오기 |
채팅 스레드의 속성을 가져옵니다. |
| 채팅 스레드 속성 업데이트 |
채팅 스레드의 속성을 업데이트합니다. |
| 채팅 스레드 참가자 나열하기 |
채팅 스레드에서 참가자를 나열합니다. |
| 채팅 스레드 참가자 제거 |
채팅 스레드에서 참가자를 제거합니다. |
| 채팅 스레드 참가자 추가 |
채팅 스레드에 참가자를 추가합니다. |
| 채팅 스레드에 메시지 보내기 |
채팅 스레드에 메시지를 보냅니다. |
채팅 스레드 나열
채팅 스레드를 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
시작 시간
|
startTime | string |
채팅 스레드를 가져오는 RFC3339 형식(yyyy-MM-ddTHH:mm:ssZ)의 시작 시간입니다. |
|
|
최대 페이지 크기
|
maxPageSize | integer |
페이지당 반환되는 최대 채팅 스레드 수입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
채팅 스레드
|
value | array of object |
채팅 스레드의 컬렉션입니다. |
|
아이디
|
value.id | string |
채팅 스레드 ID입니다. |
|
주제
|
value.topic | string |
채팅 스레드 토픽입니다. |
|
마지막으로 받은 메시지
|
value.lastMessageReceivedOn | string |
마지막 메시지가 서버에 도착했을 때 RFC3339 형식(yyyy-MM-ddTHH:mm:ssZ)의 타임스탬프입니다. |
|
삭제됨
|
value.deletedOn | string |
채팅 스레드가 삭제되었을 때 RFC3339 형식(yyyy-MM-ddTHH:mm:ssZ)의 타임스탬프입니다. |
|
다음 링크
|
nextLink | string |
검색할 수 있는 채팅 스레드가 더 많은 경우 다음 링크가 채워집니다. |
채팅 스레드 만들기
채팅 스레드를 만듭니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
채팅 스레드 토픽
|
topic | True | string |
채팅 스레드 토픽입니다. |
|
사용자 ID
|
id | string | ||
|
이름
|
displayName | string |
채팅 참가자의 표시 이름입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
chatThread.id | string |
채팅 스레드 ID |
|
주제
|
chatThread.topic | string |
채팅 스레드 토픽 |
|
생성 일자
|
chatThread.createdOn | date-time |
채팅 만들기 시간 |
|
createdByCommunicationIdentifier
|
chatThread.createdByCommunicationIdentifier | CommunicationIdentifier |
통신 식별자입니다. |
채팅 스레드 메시지 나열
채팅 스레드의 메시지를 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
스레드 ID
|
chatThreadId | True | string |
채팅 스레드 ID입니다. |
|
시작 시간
|
startTime | string |
메시지를 가져오는 RFC3339 형식(yyyy-MM-ddTHH:mm:ssZ)의 시작 시간입니다. |
|
|
최대 페이지 크기
|
maxPageSize | string |
페이지당 반환할 최대 메시지 수입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
메시지 목록
|
value | array of object |
채팅 메시지의 컬렉션입니다. |
|
아이디
|
value.id | string |
채팅 메시지의 ID입니다. 이 ID는 서버가 생성됩니다. |
|
유형
|
value.type | string |
채팅 메시지 유형입니다. |
|
버전
|
value.version | string |
채팅 메시지의 버전입니다. |
|
시퀀스 ID
|
value.sequenceId | string |
대화의 채팅 메시지 시퀀스입니다. |
|
message
|
value.content.message | string |
채팅 메시지 콘텐츠입니다. |
|
initiatorCommunicationIdentifier
|
value.content.initiatorCommunicationIdentifier | CommunicationIdentifier |
통신 식별자입니다. |
|
주제
|
value.content.topic | string |
topicUpdated 유형의 메시지에 대한 채팅 메시지 콘텐츠입니다. |
|
참가자
|
value.content.participants | array of object |
참가자 또는 참가자Removed 유형의 메시지에 대한 채팅 메시지 콘텐츠입니다. |
|
communicationIdentifier
|
value.content.participants.communicationIdentifier | CommunicationIdentifier |
통신 식별자입니다. |
|
보낸 사람 표시 이름
|
value.senderDisplayName | string |
채팅 메시지 보낸 사람의 표시 이름입니다. 이 속성은 푸시 알림의 보낸 사람 이름을 채우는 데 사용됩니다. |
|
생성 일자
|
value.createdOn | string |
채팅 메시지가 서버에 도착했을 때 RFC3339 형식의 타임스탬프(yyyy-MM-ddTHH:mm:ssZ)입니다. |
|
senderCommunicationIdentifier
|
value.senderCommunicationIdentifier | CommunicationIdentifier |
통신 식별자입니다. |
|
다음 링크
|
nextLink | string |
검색할 수 있는 채팅 메시지가 더 많은 경우 다음 링크가 채워집니다. |
채팅 스레드 삭제
채팅 스레드를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
스레드 ID
|
chatThreadId | True | string |
채팅 스레드 ID입니다. |
채팅 스레드 속성 가져오기
채팅 스레드의 속성을 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
스레드 ID
|
chatThreadId | True | string |
채팅 스레드 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
채팅 스레드 ID입니다. |
|
주제
|
topic | string |
채팅 스레드 토픽입니다. |
|
생성 일자
|
createdOn | string |
스레드가 만들어진 시간입니다. |
|
삭제됨
|
deletedOn | string |
스레드가 삭제된 시간입니다. |
|
원시 ID
|
createdByCommunicationIdentifier.rawId | string |
식별자의 원시 ID입니다. |
|
아이디
|
createdByCommunicationIdentifier.communicationUser.id | string |
통신 사용자의 ID입니다. |
채팅 스레드 속성 업데이트
채팅 스레드의 속성을 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
스레드 ID
|
chatThreadId | True | string |
채팅 스레드 ID입니다. |
|
채팅 스레드 토픽
|
topic | string |
채팅 스레드 토픽입니다. |
채팅 스레드 참가자 나열하기
채팅 스레드에서 참가자를 나열합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
스레드 ID
|
chatThreadId | True | string |
채팅 스레드 ID입니다. |
|
건너뛸 참가자 수
|
skip | string |
응답에서 지정된 위치까지 참가자를 건너뜁니다. |
|
|
페이지당 최대 참가자 수
|
maxPageSize | string |
페이지당 반환할 최대 참가자 수입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
value
|
value | array of object |
채팅 참가자. |
|
communicationIdentifier
|
value.communicationIdentifier | CommunicationIdentifier |
통신 식별자입니다. |
|
이름
|
value.displayName | string |
채팅 참가자의 표시 이름입니다. |
|
시간
|
value.shareHistoryTime | string |
채팅 기록이 공유되는 RFC3339 형식(yyyy-MM-ddTHH:mm:ssZ)의 시간입니다. |
|
다음 링크
|
nextLink | string |
검색할 수 있는 채팅 참가자가 더 많은 경우 다음 링크가 채워집니다. |
채팅 스레드 참가자 제거
채팅 스레드에서 참가자를 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
스레드 ID
|
chatThreadId | True | string |
채팅 스레드 ID입니다. |
|
사용자 ID
|
id | string |
채팅 스레드 참가자 추가
채팅 스레드에 참가자를 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
스레드 ID
|
chatThreadId | True | string |
채팅 스레드 ID입니다. |
|
사용자 ID
|
id | string | ||
|
표시 이름
|
displayName | string |
채팅 참가자의 표시 이름입니다. |
|
|
시간
|
shareHistoryTime | string |
채팅 기록이 공유되는 RFC3339 형식(yyyy-MM-ddTHH:mm:ssZ)의 시간입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
invalidParticipants
|
invalidParticipants | array of object |
참가자 목록이 잘못되었습니다. |
|
목표/타겟
|
invalidParticipants.target | string |
대상 ID입니다. |
|
코드
|
invalidParticipants.code | string |
오류 코드입니다. |
|
Message
|
invalidParticipants.message | string |
오류 메시지입니다. |
채팅 스레드에 메시지 보내기
채팅 스레드에 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
액세스 토큰
|
Access-Token | True | string |
사용자 액세스 토큰입니다. |
|
스레드 ID
|
chatThreadId | True | string |
채팅 스레드 ID입니다. |
|
Content
|
content | True | string |
메시지 콘텐츠입니다. |
|
이름
|
senderDisplayName | True | string |
메시지 보낸 사람 이름을 표시합니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
아이디 |
정의
CommunicationIdentifier
통신 식별자입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 ID
|
communicationUser.id | string |