Sinch(미리 보기)
Sinch는 경고, 미리 알림, 초대, 마케팅 캠페인 등을 통해 비즈니스가 고객과 연결할 수 있도록 지원합니다. Sinch Engage, Sinch MessageMedia, One NZ, eTXT 및 GroupText가 제공하는 이 플랫폼은 전 세계적으로 수십억 개의 메시지를 제공합니다. 이 커넥터를 사용하면 SMS 및 RCS를 워크플로에 쉽게 통합하여 고객 통신을 간소화하고 자동화할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 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://messagemedia.com/contact/ |
| 전자 메일 | support@messagemedia.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | 신치 스웨덴 AB |
| 웹 사이트 | https://messagemedia.com |
| 개인 정보 보호 정책 | https://messagemedia.com/legal/privacy-policy/ |
| 카테고리 | Communication |
커넥터 이름
신흐 (주)
API 설명서
https://messagemedia.github.io/documentation/#tag/Messages/operation/SendMessages
지원되는 작업
https://support.messagemedia.com/hc/en-us/categories/10710547404559-Power-Automate-App-Support
자격 증명을 가져오는 방법
이 커넥터는 사용 API Key 및 API secret 인증(하나를 얻는 방법에 대한 bellow 링크의 단계 참조) https://support.messagemedia.com/hc/en-us/articles/4413627066383-Creating-New-API-Credentials
지원되는 작업
이 커넥터는 다음 작업을 지원합니다.
-
Send Text Message (SMS): 여러 모바일 받는 사람에게 문자 메시지를 보냅니다. -
Send Rich Text Message (RCS): RCS(서식 있는 문자 메시지)를 보냅니다. -
Get sender IDs: 이 작업은 계정에 연결된 보낸 사람 ID 목록을 반환합니다. -
Get message status: 메시지 ID를 사용하여 메시지 상태 가져오기 -
When SMS or RCS is received: 들어오는 메시지(SMS 또는 RCS)를 받으면 이 작업이 트리거됩니다. -
When delivery receipt is received: 이 작업은 아웃바운드 메시지(SMS 또는 RCS)에 대한 배달 영수증을 받으면 트리거됩니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| API 키 | 시큐어스트링 (보안 문자열) | 이 api에 대한 api_key | 진실 |
| api_secret | 시큐어스트링 (보안 문자열) | 이 api에 대한 api_secret | 진실 |
| Sinch 서비스 | 문자열 | 연결 중인 API입니다. Sinch MessageMedia(아시아 특정 계정에 가장 적합) 중 하나를 선택합니다. Sinch 참여(유럽, 미국 계정에 가장 적합) | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| RCS(서식 있는 문자 메시지 보내기) |
RCS(서식 있는 문자 메시지 보내기) |
| 메시지 상태 가져오기 |
메시지 ID를 사용하여 메시지 상태 가져오기 |
| 문자 메시지 보내기(SMS) |
이 작업은 문자 메시지(SMS)를 휴대폰 번호로 보내는 데 사용됩니다. |
| 보낸 사람 ID 가져오기 |
이 작업은 계정에 연결된 보낸 사람 ID 목록을 반환합니다. |
RCS(서식 있는 문자 메시지 보내기)
RCS(서식 있는 문자 메시지 보내기)
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
메시지 상태 가져오기
메시지 ID를 사용하여 메시지 상태 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이 메시지의 고유 ID
|
messageId | True | string |
이 메시지의 고유 ID |
반환
- 몸
- message
문자 메시지 보내기(SMS)
이 작업은 문자 메시지(SMS)를 휴대폰 번호로 보내는 데 사용됩니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
보낸 사람 ID
|
source_number | string |
사용할 원본 번호 지정 |
|
|
대상 번호
|
to | True | string |
E.164 형식의 받는 사람의 휴대폰 번호입니다. 최대 100명의 받는 사람, 공백으로 구분 |
|
Message
|
message | True | string |
SMS 메시지 본문 |
|
배달 보고서
|
delivery_report | boolean |
각 메시지와 함께 배달 보고서를 요청할 수 있습니다. 배달 보고서가 요청되면 메시지(또는 웹후크)에 지정된 callback_url 속성에 웹후크가 제출됩니다. |
|
|
콜백 URL
|
callback_url | string |
URL은 웹후크가 HTTP POST 요청을 통해 푸시될 각 메시지에 포함될 수 있습니다. |
|
|
메타데이터 키
|
metadata_key | string |
메타데이터 키 |
|
|
메타데이터 값
|
metadata_value | string |
메타데이터 값 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
각 메시지와 함께 배달 보고서를 요청할 수 있습니다. 배달 보고서가 요청되면 메시지(또는 웹후크)에 지정된 callback_url 속성에 웹후크가 제출됩니다. |
|
destination_number
|
messages.destination_number | string |
대상 번호 |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
메시지 만료 타임스탬프 |
|
message_flags
|
messages.message_flags | array of |
메시지 플래그 |
|
message_id
|
messages.message_id | string |
메시지 ID |
|
출처
|
messages.metadata.Source | string |
출처 |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
status
|
messages.status | string |
status |
|
내용
|
messages.content | string |
내용 |
|
source_number
|
messages.source_number | string |
원본 번호 |
|
미디어
|
messages.media | array of string |
미디어 |
|
제목
|
messages.subject | string |
제목 |
보낸 사람 ID 가져오기
이 작업은 계정에 연결된 보낸 사람 ID 목록을 반환합니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
page
|
pagination.page | integer |
page |
|
page_size
|
pagination.page_size | integer |
page_size |
|
total_count
|
pagination.total_count | integer |
total_count |
|
page_count
|
pagination.page_count | integer |
page_count |
|
type
|
default_sender.type | string |
type |
|
숫자
|
default_sender.number | string |
숫자 |
|
source_type
|
default_sender.source_type | string |
source_type |
|
mms_capable
|
default_sender.mms_capable | boolean |
mms_capable |
|
보낸 사람
|
senders | array of object |
보낸 사람 |
|
display_type
|
senders.display_type | string |
display_type |
|
is_default
|
senders.is_default | boolean |
is_default |
|
label
|
senders.label | string |
label |
|
mms_capable
|
senders.mms_capable | boolean |
mms_capable |
|
숫자
|
senders.number | string |
숫자 |
|
number_id
|
senders.number_id | string |
number_id |
|
source_type
|
senders.source_type | string |
source_type |
|
type
|
senders.type | string |
type |
|
number_status
|
senders.number_status | string |
number_status |
|
account_id
|
account_id | string |
account_id |
|
vendor_id
|
vendor_id | string |
vendor_id |
트리거
| SMS 또는 RCS가 수신되는 경우 |
이 작업은 SMS(들어오는 문자 메시지)를 받을 때 트리거됩니다. |
| 배달 확인이 수신되는 경우 |
이 작업은 SMS(아웃바운드 문자 메시지)에 대한 배달 영수증을 받으면 트리거됩니다. |
SMS 또는 RCS가 수신되는 경우
이 작업은 SMS(들어오는 문자 메시지)를 받을 때 트리거됩니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
원본 메시지의 ID |
|
reply_id
|
reply_id | string |
이 알림이 나타내는 회신의 고유 ID |
|
status
|
status | string |
배달 보고서는 메시지 상태를 나타냅니다. |
|
source_address
|
source_address | string |
원본 주소 |
|
destination_address
|
destination_address | string |
대상 주소 |
|
내용
|
content | string |
회신 내용 |
|
메시지 콘텐츠 V2 - 텍스트
|
contact_message.text_message.text | string |
메시지 콘텐츠 V2 - 텍스트 |
|
type
|
type | string |
type |
|
status_code
|
status_code | string |
상태 코드는 메시지의 상태에 대한 보다 세부적인 인사이트를 제공합니다. |
|
submitted_date
|
submitted_date | string |
메시지 타임스탬프 |
|
date_received
|
date_received | string |
공급자 타임스탬프 |
|
Attachments
|
attachments | array of object |
회신에 포함된 모든 첨부 파일이 포함된 목록입니다. 이 필드는 계정에서 인바운드 MMS를 사용하도록 설정하고 회신에 첨부 파일이 포함된 경우에만 존재합니다. |
|
첨부 파일 형식
|
attachments.attachment_type | string |
이 첨부 파일과 연결된 MIME 형식 |
|
첨부 파일 콘텐츠
|
attachments.attachment_content | string |
Base64로 인코딩된 첨부 파일 |
|
첨부 파일 이름
|
attachments.attachment_name | string |
첨부 파일의 이름 |
|
메타데이터
|
metadata | array of object |
원래 메시지 제출 요청에 포함된 모든 메타데이터 |
|
메타데이터 키
|
metadata.metadata_key | string |
메타데이터 키 |
|
메타데이터 값
|
metadata.metadata_value | string |
메타데이터 값 |
배달 확인이 수신되는 경우
이 작업은 SMS(아웃바운드 문자 메시지)에 대한 배달 영수증을 받으면 트리거됩니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
원본 메시지의 ID |
|
status
|
status | string |
배달 보고서는 메시지 상태를 나타냅니다. |
|
source_address
|
source_address | string |
원본 주소 |
|
destination_address
|
destination_address | string |
대상 주소 |
|
내용
|
content | string |
내용 |
|
type
|
type | string |
type |
|
delivery_report_id
|
delivery_report_id | string |
배달 보고서 ID |
|
status_code
|
status_code | string |
상태 코드는 메시지의 상태에 대한 보다 세부적인 인사이트를 제공합니다. |
|
submitted_date
|
submitted_date | string |
메시지 타임스탬프 |
|
date_received
|
date_received | string |
공급자 타임스탬프 |
|
Attachments
|
attachments | array of object |
Attachments |
|
첨부 파일 형식
|
attachments.attachment_type | string |
첨부 파일 형식 |
|
첨부 파일 콘텐츠
|
attachments.attachment_content | string |
첨부 파일 콘텐츠 |
|
첨부 파일 이름
|
attachments.attachment_name | string |
첨부 파일 이름 |
|
메타데이터
|
metadata | array of object |
원래 제출 메시지에 포함된 모든 메타데이터 |
|
메타데이터 키
|
metadata.metadata_key | string |
메타데이터 키 |
|
메타데이터 값
|
metadata.metadata_value | string |
메타데이터 값 |
정의
message
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
callback_url
|
callback_url | string |
URL은 웹후크가 HTTP POST 요청을 통해 푸시될 각 메시지에 포함될 수 있습니다. |
|
delivery_report
|
delivery_report | boolean |
각 메시지와 함께 배달 보고서를 요청할 수 있습니다. 배달 보고서가 요청되면 메시지(또는 웹후크)에 지정된 callback_url 속성에 웹후크가 제출됩니다. |
|
destination_number
|
destination_number | string |
메시지가 배달되어야 하는 대상 번호입니다. |
|
format
|
format | string |
이 형식은 메시지를 보낼 형식, SMS(문자 메시지), MMS(멀티미디어 메시지) 또는 TTS(텍스트 음성 변환)를 지정합니다. |
|
message_expiry_timestamp
|
message_expiry_timestamp | string |
메시지 만료 타임스탬프를 제공하여 메시지를 배달해야 하는 최신 시간을 지정할 수 있습니다. |
|
message_flags
|
message_flags | array of |
message_flags |
|
message_id
|
message_id | string |
메시지 ID |
|
출처
|
metadata.Source | string |
출처 |
|
scheduled
|
scheduled | string |
메시지의 예약된 배달 날짜 시간 |
|
status
|
status | string |
메시지의 상태입니다. |
|
내용
|
content | string |
내용 |
|
source_number
|
source_number | string |
원본 번호 |
|
미디어
|
media | array of string |
미디어 |
|
제목
|
subject | string |
제목 |