SMS Works(Independent Publisher)(미리 보기)
SMS Works는 영국에 본사를 둔 개발자를 위한 저렴한 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) |
| 연락처 | |
|---|---|
| 이름 | 트로이 테일러 |
| URL | https://www.hitachisolutions.com |
| 전자 메일 | ttaylor@hitachisolutions.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 트로이 테일러 |
| 웹 사이트 | https://thesmsworks.co.uk/ |
| 개인 정보 보호 정책 | https://thesmsworks.co.uk/privacy |
| 카테고리 | Communication |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| JWT 토큰 | 시큐어스트링 (보안 문자열) | 이 API에 대한 JWT 토큰 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| SMS 메시지 보내기 |
매개 변수를 기반으로 SMS 메시지를 보냅니다. |
| 고객 ID 가져오기 |
고객 ID를 호출자에게 반환합니다. |
| 메시지 가져오기 |
메시지 ID로 기록된 메시지를 검색합니다. |
| 메시지 검색 |
검색 조건과 일치하는 최대 1,000명의 메시지를 검색합니다. |
| 메시지 삭제 |
일치하는 messageid를 사용하여 메시지를 삭제합니다. |
| 메시지 예약 |
지정한 날짜에 SMS 메시지를 보내도록 예약합니다. |
| 메시지 컬렉션 보내기 |
고유한 SMS 메시지의 컬렉션을 보냅니다. 일괄 처리에는 한 번에 최대 5,000개의 메시지가 포함될 수 있습니다. |
| 실패한 메시지 가져오기 |
검색 조건과 일치하는 실패한 메시지를 검색합니다. |
| 예약된 메시지 가져오기 |
계정에서 예약된 메시지 목록을 반환합니다. 이 목록은 지난 3개월 동안 예약된 모든 메시지와 나중에 전송되도록 예약된 메시지로 구성됩니다. |
| 예약된 메시지 취소 |
예약된 SMS 메시지를 취소합니다. |
| 예약된 일괄 처리 취소 |
예약된 SMS 메시지를 취소합니다. |
| 일괄 처리 메시지 검색 |
지정된 일괄 처리 ID를 사용하여 일괄 처리의 모든 메시지를 검색합니다. |
| 일괄 처리 보내기 |
여러 받는 사람에게 단일 SMS 메시지를 보냅니다. |
| 일괄 처리 예약 |
지정한 날짜에 보낼 SMS 메시지의 일괄 처리를 예약합니다. |
| 읽지 않은 메시지 가져오기 |
검색 조건과 일치하는 읽지 않은 수신 메시지를 가져옵니다. |
| 크레딧 가져오기 |
계정에서 현재 사용할 수 있는 크레딧 수를 반환합니다. |
| 플래시 메시지 보내기 |
받는 사람 잠금 화면에 표시되는 SMS 플래시 메시지를 보냅니다. |
SMS 메시지 보내기
매개 변수를 기반으로 SMS 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
보낸 사람
|
sender | True | string |
메시지의 보낸 사람입니다. 영숫자의 경우 11자, 숫자 보낸 사람 ID의 경우 15자를 초과하지 않아야 합니다. 공백이나 특수 문자가 없습니다. |
|
목적지
|
destination | True | string |
받는 사람의 전화 번호 |
|
Content
|
content | True | string |
받는 사람에게 보낼 메시지입니다. 콘텐츠의 길이는 최대 1280자까지 가능합니다. 160자 이하의 메시지에는 1 크레딧이 청구됩니다. 메시지가 160자보다 긴 경우 받는 사람의 핸드셋으로 전송되기 전에 153자의 청크로 세분화되며 각 153자당 1 크레딧이 청구됩니다. 영국 외부에 등록된 번호로 전송되는 메시지는 일반적으로 이중 크레딧으로 청구되지만, 특정 국가의 경우 크레딧의 일부(예: 2.5)가 청구될 수 있습니다. 각 국가에 대한 요금은 Microsoft에 문의하세요. |
|
배달 보고서 URL
|
deliveryreporturl | string |
이 메시지에 대해 배달 보고서를 게시해야 하는 URL입니다. 지정하지 않으면 계정 페이지에서 구성한 전역 배달 보고서 URL을 사용합니다. |
|
|
일정
|
schedule | string |
메시지를 보낼 날짜입니다. 이는 메시지/일정 서비스에서만 사용되며 다른 서비스에는 비워 둘 수 있습니다. |
|
|
Tag
|
tag | string |
메시지의 식별 레이블로, 나중에 보낸 메시지를 필터링하고 보고하는 데 사용할 수 있습니다. 캠페인에 이상적입니다. 최대 280자입니다. |
|
|
TTL
|
ttl | number |
배달 보고서가 삭제되기까지의 선택적 시간(분)입니다. Optional. 배달 보고서 삭제를 방지하기 위해 생략합니다. |
|
|
응답 전자 메일
|
responseemail | array of string |
이 특정 메시지에 응답을 전달할 이메일 주소의 선택적 목록입니다. 이 기능을 사용하려면 SMS Works 회신 번호가 필요합니다. |
|
|
메타데이터
|
Metadata | object | ||
|
유효성
|
validity | number |
메시지가 EXPIRED로 표시되기 전까지 배달을 시도할 시간(분)입니다. Optional. 기본값은 2880분입니다. |
반환
- response
- SendMessageResponse
고객 ID 가져오기
메시지 가져오기
메시지 ID로 기록된 메시지를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 ID
|
messageid | True | string |
반환할 메시지의 ID입니다. |
반환
- response
- MessageResponse
메시지 검색
검색 조건과 일치하는 최대 1,000명의 메시지를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
query
|
query | True |
반환
- response
- array of MessageResponse
메시지 삭제
일치하는 messageid를 사용하여 메시지를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 ID
|
messageid | True | string |
반환할 메시지의 ID입니다. |
반환
- response
- DeletedMessageResponse
메시지 예약
지정한 날짜에 SMS 메시지를 보내도록 예약합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
보낸 사람
|
sender | True | string |
메시지의 보낸 사람입니다. 영숫자의 경우 11자, 숫자 보낸 사람 ID의 경우 15자를 초과하지 않아야 합니다. 공백이나 특수 문자가 없습니다. |
|
목적지
|
destination | True | string |
받는 사람의 전화 번호 |
|
Content
|
content | True | string |
받는 사람에게 보낼 메시지입니다. 콘텐츠의 길이는 최대 1280자까지 가능합니다. 160자 이하의 메시지에는 1 크레딧이 청구됩니다. 메시지가 160자보다 긴 경우 받는 사람의 핸드셋으로 전송되기 전에 153자의 청크로 세분화되며 각 153자당 1 크레딧이 청구됩니다. 영국 외부에 등록된 번호로 전송되는 메시지는 일반적으로 이중 크레딧으로 청구되지만, 특정 국가의 경우 크레딧의 일부(예: 2.5)가 청구될 수 있습니다. 각 국가에 대한 요금은 Microsoft에 문의하세요. |
|
배달 보고서 URL
|
deliveryreporturl | string |
이 메시지에 대해 배달 보고서를 게시해야 하는 URL입니다. 지정하지 않으면 계정 페이지에서 구성한 전역 배달 보고서 URL을 사용합니다. |
|
|
일정
|
schedule | string |
메시지를 보낼 날짜입니다. 이는 메시지/일정 서비스에서만 사용되며 다른 서비스에는 비워 둘 수 있습니다. |
|
|
Tag
|
tag | string |
메시지의 식별 레이블로, 나중에 보낸 메시지를 필터링하고 보고하는 데 사용할 수 있습니다. 캠페인에 이상적입니다. 최대 280자입니다. |
|
|
TTL
|
ttl | number |
배달 보고서가 삭제되기까지의 선택적 시간(분)입니다. Optional. 배달 보고서 삭제를 방지하기 위해 생략합니다. |
|
|
응답 전자 메일
|
responseemail | array of string |
이 특정 메시지에 응답을 전달할 이메일 주소의 선택적 목록입니다. 이 기능을 사용하려면 SMS Works 회신 번호가 필요합니다. |
|
|
메타데이터
|
Metadata | object | ||
|
유효성
|
validity | number |
메시지가 EXPIRED로 표시되기 전까지 배달을 시도할 시간(분)입니다. Optional. 기본값은 2880분입니다. |
반환
- response
- array of ScheduledMessageResponse
메시지 컬렉션 보내기
고유한 SMS 메시지의 컬렉션을 보냅니다. 일괄 처리에는 한 번에 최대 5,000개의 메시지가 포함될 수 있습니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
messages
|
messages | True |
메시지 배열 |
반환
- response
- BatchMessageResponse
실패한 메시지 가져오기
검색 조건과 일치하는 실패한 메시지를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
query
|
query | True |
반환
- response
- array of MessageResponse
예약된 메시지 가져오기
계정에서 예약된 메시지 목록을 반환합니다. 이 목록은 지난 3개월 동안 예약된 모든 메시지와 나중에 전송되도록 예약된 메시지로 구성됩니다.
반환
지정된 날짜 및 시간에 전송되도록 예약된 메시지의 세부 정보
- response
- ScheduledMessagesResponse
예약된 메시지 취소
예약된 SMS 메시지를 취소합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 ID
|
messageid | True | string |
반환할 메시지의 ID입니다. |
반환
- response
- CancelledMessageResponse
예약된 일괄 처리 취소
예약된 SMS 메시지를 취소합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
일괄 처리 ID
|
batchid | True | string |
반환하려는 일괄 처리의 ID |
반환
- response
- CancelledMessageResponse
일괄 처리 메시지 검색
지정된 일괄 처리 ID를 사용하여 일괄 처리의 모든 메시지를 검색합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
일괄 처리 ID
|
batchid | True | string |
반환하려는 일괄 처리의 ID |
반환
- response
- array of MessageResponse
일괄 처리 보내기
여러 받는 사람에게 단일 SMS 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
smsMessage
|
smsMessage | True |
메시지 속성 |
반환
- response
- BatchMessageResponse
일괄 처리 예약
지정한 날짜에 보낼 SMS 메시지의 일괄 처리를 예약합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
smsMessage
|
smsMessage | True |
메시지 속성 |
반환
- response
- ScheduledBatchResponse
읽지 않은 메시지 가져오기
검색 조건과 일치하는 읽지 않은 수신 메시지를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
query
|
query | True |
반환
- response
- array of MessageResponse
크레딧 가져오기
플래시 메시지 보내기
받는 사람 잠금 화면에 표시되는 SMS 플래시 메시지를 보냅니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
보낸 사람
|
sender | True | string |
메시지의 보낸 사람입니다. 영숫자의 경우 11자, 숫자 보낸 사람 ID의 경우 15자를 초과하지 않아야 합니다. 공백이나 특수 문자가 없습니다. |
|
목적지
|
destination | True | string |
받는 사람의 전화 번호 |
|
Content
|
content | True | string |
받는 사람에게 보낼 메시지입니다. 콘텐츠의 길이는 최대 1280자까지 가능합니다. 160자 이하의 메시지에는 1 크레딧이 청구됩니다. 메시지가 160자보다 긴 경우 받는 사람의 핸드셋으로 전송되기 전에 153자의 청크로 세분화되며 각 153자당 1 크레딧이 청구됩니다. 영국 외부에 등록된 번호로 전송되는 메시지는 일반적으로 이중 크레딧으로 청구되지만, 특정 국가의 경우 크레딧의 일부(예: 2.5)가 청구될 수 있습니다. 각 국가에 대한 요금은 Microsoft에 문의하세요. |
|
배달 보고서 URL
|
deliveryreporturl | string |
이 메시지에 대해 배달 보고서를 게시해야 하는 URL입니다. 지정하지 않으면 계정 페이지에서 구성한 전역 배달 보고서 URL을 사용합니다. |
|
|
일정
|
schedule | string |
메시지를 보낼 날짜입니다. 이는 메시지/일정 서비스에서만 사용되며 다른 서비스에는 비워 둘 수 있습니다. |
|
|
Tag
|
tag | string |
메시지의 식별 레이블로, 나중에 보낸 메시지를 필터링하고 보고하는 데 사용할 수 있습니다. 캠페인에 이상적입니다. 최대 280자입니다. |
|
|
TTL
|
ttl | number |
배달 보고서가 삭제되기까지의 선택적 시간(분)입니다. Optional. 배달 보고서 삭제를 방지하기 위해 생략합니다. |
|
|
응답 전자 메일
|
responseemail | array of string |
이 특정 메시지에 응답을 전달할 이메일 주소의 선택적 목록입니다. 이 기능을 사용하려면 SMS Works 회신 번호가 필요합니다. |
|
|
메타데이터
|
Metadata | object | ||
|
유효성
|
validity | number |
메시지가 EXPIRED로 표시되기 전까지 배달을 시도할 시간(분)입니다. Optional. 기본값은 2880분입니다. |
반환
- response
- SendMessageResponse