Twilio
Twilio를 사용하면 앱이 글로벌 SMS, MMS 및 IP 메시지를 보내고 받을 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | 스탠다드 | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL |
Microsoft LogicApps 지원 Microsoft Power Automate 지원 Microsoft Power Apps 지원 |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://www.twilio.com/ |
| 개인 정보 보호 정책 | https://www.twilio.com/legal/privacy |
요구 사항
Twilio 커넥터에는 다음 정보가 필요합니다.
Twilio 대시보드에서 찾을 수 있는 Twilio 계정 ID 및 인증 토큰을 사용하여 앱에서 연결 만들기 권한을 부여합니다. Twilio 평가판 계정을 사용하는 경우 확인된 전화 번호로만 문자 메시지를 보낼 수 있습니다.
문자 메시지를 보낼 수 있는 확인된 Twilio 전화 번호와 문자 메시지를 받을 수 있는 다른 전화 번호입니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유 가능 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Twilio 계정 ID | 시큐어스트링 (보안 문자열) | Twilio 계정 ID | 진실 |
| Twilio 액세스 토큰 | 시큐어스트링 (보안 문자열) | Twilio 액세스 토큰 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 1200 | 60초 |
동작
| 메시지 가져오기 |
이 작업은 제공된 메시지 ID로 지정된 단일 메시지를 반환합니다. |
| 메시지 나열 V2 |
계정과 연결된 메시지 목록을 반환합니다. 이 작업은 페이지 매김을 지원합니다. |
| 메시지 나열[사용되지 않음] |
계정과 연결된 메시지 목록을 반환합니다. |
| 문자 메시지 보내기(SMS) |
이 작업은 휴대폰 번호로 새 메시지를 보내는 데 사용됩니다. |
메시지 가져오기
이 작업은 제공된 메시지 ID로 지정된 단일 메시지를 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 SID
|
MessageId | True | string |
메시지의 고유 SID입니다. |
반환
단일 메시지의 전파입니다.
- Message
- Message
메시지 나열 V2
계정과 연결된 메시지 목록을 반환합니다. 이 작업은 페이지 매김을 지원합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전화 번호로
|
To | string |
이 전화 번호에 메시지만 표시합니다. |
|
|
전화 번호에서
|
From | string |
이 전화 번호의 메시지만 표시합니다. |
|
|
보낸 날짜
|
DateSent | date |
YYYY-MM-DD로 지정된 이 날짜(GMT 형식)에 전송된 메시지만 표시합니다. 예: 2009-07-06. |
|
|
한계
|
PageSize | integer |
각 목록 페이지에서 반환할 리소스 수입니다. 기본값은 50입니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록 V2
- MessageListV2
메시지 나열[사용되지 않음]
계정과 연결된 메시지 목록을 반환합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전화 번호로
|
To | string |
이 전화 번호에 메시지만 표시합니다. |
|
|
전화 번호에서
|
From | string |
이 전화 번호의 메시지만 표시합니다. |
|
|
보낸 날짜
|
DateSent | date |
YYYY-MM-DD로 지정된 이 날짜(GMT 형식)에 전송된 메시지만 표시합니다. 예: 2009-07-06. |
|
|
한계
|
PageSize | integer |
각 목록 페이지에서 반환할 리소스 수입니다. 기본값은 50입니다. |
|
|
페이지
|
Page | integer |
페이지 번호입니다. 기본값은 0입니다. |
반환
하나 이상의 메시지 목록입니다.
- 메시지 목록
- MessageList
문자 메시지 보내기(SMS)
이 작업은 휴대폰 번호로 새 메시지를 보내는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
전화 번호에서
|
from | True | string |
보낼 메시지 유형에 대해 사용하도록 설정된 Twilio 전화 번호(E.164 형식) 또는 영숫자 발신자 ID입니다. |
|
전화 번호로
|
to | True | string |
대상 전화 번호입니다. '+' 및 국가 코드(예: +16175551212(E.164 형식)를 사용하여 서식을 지정합니다. |
|
문자 메시지
|
body | True | string |
보낼 메시지의 텍스트로, 1600자로 제한됩니다. |
|
미디어 URL
|
media_url | array of uri |
보낼 미디어의 URI 목록입니다. |
|
|
상태 콜백
|
StatusCallback | uri |
메시지 상태가 변경될 때마다 Twilio가 게시할 URL입니다. |
|
|
Messaging Service Sid
|
messaging_service_sid | string |
메시징 서비스의 고유 ID입니다. |
|
|
애플리케이션 SID
|
application_sid | string |
필요한 메시지 상태 콜백으로 구성된 Twilio 애플리케이션의 SID입니다. |
|
|
최대 가격
|
max_price | string |
메시지의 총 최대 가격 한도입니다. |
|
|
유효 기간
|
validity_period | string |
메시지가 Twilio 큐에 남아 있을 수 있는 시간(초)입니다. |
반환
단일 메시지의 전파입니다.
- Message
- Message
정의
Message
단일 메시지의 전파입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
문자 메시지
|
body | string |
메시지의 본문입니다. |
|
From Number
|
from | phone |
메시지를 보낸 전화 번호입니다. |
|
To Number
|
to | phone |
메시지를 보낸 전화 번호입니다. |
|
상태
|
status | string |
메시지의 전송 상태입니다. |
|
SID
|
sid | string |
보낸 메시지의 SID입니다. |
|
계정 Sid
|
account_sid | string |
보낸 메시지와 연결된 계정의 SID입니다. |
|
API
|
api_version | string |
메시지를 보내는 데 사용되는 API의 버전입니다. |
|
세그먼트 수
|
num_segments | string |
메시지가 나뉘어진 세그먼트 수입니다. |
|
미디어 수
|
num_media | string |
보낸 메시지와 연결된 미디어 파일 수입니다. |
|
만든 Date-Time
|
date_created | string |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
보낸 Date-Time
|
date_sent | string |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
업데이트된 Date-Time
|
date_updated | string |
yyyy-MM-ddTHH:mm:ss.fffZ(UTC 형식) |
|
방향
|
direction | string |
보낸 메시지와 연결된 방향입니다. |
|
오류 코드
|
error_code | integer |
보낸 메시지와 연결된 오류 코드(있는 경우)입니다. |
|
오류 메시지
|
error_message | string |
보낸 메시지와 연결된 오류 메시지(있는 경우)입니다. |
|
가격
|
price | string |
보낸 메시지의 비용입니다. |
|
단위
|
price_unit | string |
메시지 비용을 평가하는 데 사용되는 가격 단위입니다. |
|
URI
|
uri | uri |
이 리소스에 대한 상대 URI입니다. |
|
하위 리소스 URI
|
subresource_uris | object |
모든 하위 리소스에 대한 상대 URI입니다. |
|
Messaging Service Sid
|
messaging_service_sid | string |
메시징 서비스의 고유 ID입니다. |
MessageList
하나 이상의 메시지 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
messages
|
messages | array of Message | |
|
페이지
|
page | integer |
respone의 페이지 번호입니다. |
|
한계
|
page_size | integer |
응답의 페이지 크기입니다. |
|
페이지 수
|
num_pages | integer |
응답의 총 페이지 수입니다. |
|
Start
|
start | integer |
첫 번째 메시지의 인덱스입니다. |
|
끝
|
end | integer |
마지막 메시지의 인덱스입니다. |
|
URI
|
uri | uri |
이 목록의 상대 URI입니다. |
|
첫 번째 페이지 URI
|
first_page_uri | uri |
첫 번째 페이지의 상대 URI입니다. |
|
다음 페이지 URI
|
next_page_uri | uri |
다음 페이지의 상대 URI입니다. |
|
메시지 수
|
total | integer |
총 메시지 수입니다. |
|
이전 페이지 URI
|
previous_page_uri | uri |
이전 페이지의 상대 URI입니다. |
MessageListV2
하나 이상의 메시지 목록입니다.
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
@odata.nextLink
|
@odata.nextLink | string |
다음 페이지의 상대 URI입니다. |
|
value
|
value | array of Message |
하나 이상의 메시지 목록입니다. |