Azure Communication Services SMS 이벤트(미리 보기)
구독의 Azure Communication Services 리소스에서 SMS 메시지를 수신하는 커넥터입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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 SMS 이벤트 커넥터를 사용하면 Azure Communication Services 전화 번호로 전송된 SMS 메시지를 처리할 수 있습니다.
필수 조건
계속하려면 다음이 필요합니다.
- 사용자 지정 커넥터 기능이 있는 Microsoft Power Apps 또는 Power Automate 계획
- Event Grid 리소스 공급자가 등록된 Azure 구독
- Azure Communication Services 리소스
- SMS 메시지를 받도록 설정된 Azure Communication Services에서 구입한 전화 번호
자격 증명을 가져오는 방법
Azure Communication Services 리소스 만들기 - 빠른 시작 문서.
"SMS 보내기 및 받기" 기능이 선택된 상태에서 이 리소스에서 전화 번호를 구입합니다.
Azure Communication Services 리소스가 포함된 구독에 대한 Event Grid 리소스 공급자를 등록합니다.
커넥터 연결에 사용할 수 있는 Microsoft Entra ID 사용자 또는 서비스 주체를 만듭니다.
- 옵션 1: Microsoft Entra ID 계정을 사용하여 연결 - 새 사용자 추가
- 옵션 2: 서비스 주체(Microsoft Entra ID 애플리케이션) 인증을 사용한 연결 - 서비스 주체를 설정하거나 Azure CLI 또는 Azure Portal을 통해 등록된 애플리케이션을 만들 수도 있습니다. 그런 다음 자격 증명을 사용하여 인증할 수 있습니다.
Microsoft Entra ID 사용자 또는 서비스 주체에게 할당된 다음 권한이 있는지 확인합니다.
Microsoft.Communication/CommunicationServices/Read
Microsoft.Resources/subscriptions/resourceGroups/read
Microsoft.EventGrid/eventSubscriptions/write (이벤트 구독을 작성하는 명령)
Microsoft.EventGrid/eventSubscriptions/read (마이크로소프트 이벤트 그리드의 이벤트 구독 읽기)
Microsoft.EventGrid/eventSubscriptions/delete
사용자 지정 역할을 만들거나 다음 기본 제공 역할에 사용자를 할당하여 이 작업을 수행할 수 있습니다.
읽기 권한자 - Azure Communication Services 리소스 수준에서
EventGrid EventSubscription 기여자 - 리소스 그룹 수준에서
커넥터 시작
이 커넥터에는 SMS 메시지가 수신될 때 단일 트리거가 포함됩니다. 기본적으로 메시지가 구매한 전화 번호로 전송될 때 실행되지만 SMS 메시지의 "받는 사람" 및 "보낸 사람" 전화 번호에 따라 실행되도록 구성할 수도 있습니다.
알려진 문제 및 제한 사항
- "이벤트 구독 이름"이 설정된 경우 업데이트 시 트리거가 일시적으로 비활성화됨 - 트리거를 만들 때 값이 "이벤트 구독 이름" 필드에 할당된 경우 트리거에 대한 업데이트(예: "대상" 전화 번호 추가)를 적용하는 데 최대 10분이 걸릴 수 있습니다. 이 시간 동안 트리거가 작동하지 않습니다.
- Flow 전에 연결이 삭제된 경우 이벤트 구독이 삭제되지 않습니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| Microsoft Entra ID 통합 | Microsoft Entra ID를 사용하여 ACS 이벤트 리소스에 액세스합니다. | 모든 지역 | 공유할 수 없음 |
| 서비스 주체(Microsoft Entra ID 애플리케이션) 인증 | Microsoft Entra ID 인증을 사용하여 Azure Communication Service 리소스에 액세스합니다. | 모든 지역 | 공유할 수 없음 |
| 기본값 [사용되지 않음] | 이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다. | 모든 지역 | 공유할 수 없음 |
Microsoft Entra ID 통합
인증 ID: aadOauth
적용 가능: 모든 지역
Microsoft Entra ID를 사용하여 ACS 이벤트 리소스에 액세스합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
서비스 주체(Microsoft Entra ID 애플리케이션) 인증
인증 ID: aadOauthClientCredentials
적용 가능: 모든 지역
Microsoft Entra ID 인증을 사용하여 Azure Communication Service 리소스에 액세스합니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| 임차인 ID | 문자열 | Microsoft Entra ID 애플리케이션의 테넌트 ID입니다. | 진실 |
| 클라이언트 ID | 문자열 | Microsoft Entra ID 애플리케이션의 클라이언트(또는 애플리케이션) ID입니다. | 진실 |
| 클라이언트 암호 | 시큐어스트링 (보안 문자열) | Microsoft Entra ID 애플리케이션의 클라이언트 암호입니다. | 진실 |
기본값 [사용되지 않음]
적용 가능: 모든 지역
이 옵션은 명시적 인증 유형이 없는 이전 연결에만 해당되며 이전 버전과의 호환성을 위해서만 제공됩니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
트리거
| SMS 메시지가 수신되는 경우 |
Azure Communication Services SMS 메시지가 수신되는 경우 |
SMS 메시지가 수신되는 경우
Azure Communication Services SMS 메시지가 수신되는 경우
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Subscription
|
subscriptionId | True | string |
Microsoft Azure 구독의 고유 식별자입니다. 구독 ID는 모든 Azure 리소스에 대한 ID의 일부를 형성합니다. |
|
리소스 그룹 이름
|
resourceGroupName | True | string |
리소스를 포함하는 리소스 그룹의 이름입니다. |
|
리소스 이름
|
resourceName | True | string |
Communication Services 리소스의 이름입니다. |
|
전화 번호로 필터링
|
toPhoneNumbers | array of string | ||
|
전화 번호로 필터링
|
fromPhoneNumbers | array of string | ||
|
이벤트 구독 이름
|
eventSubscriptionName | string |
새 이벤트 구독의 이름입니다. |
|
|
includedEventTypes
|
includedEventTypes | True | array of string |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
|
array of object | ||
|
에게
|
data.to | string | |
|
부터
|
data.from | string | |
|
Message
|
data.message | string | |
|
수신된 타임스탬프
|
data.receivedTimestamp | string | |
|
메시지 ID
|
data.messageId | string |