Sinch (預覽版)
Sinch 透過提醒、提醒、邀請、行銷活動等方式,協助您的企業與顧客建立連結。 由 Sinch Engage、Sinch MessageMedia、One NZ、eTXT 和 GroupText 支持,我們的平台在全球傳遞數十億則訊息。 透過此連接器,您可以輕鬆將簡訊、RCS 與 MMS 整合進工作流程,簡化並自動化客戶溝通。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| Copilot Studio | 進階 | 除以下部分外,所有Power Automate區域: - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government regions - Azure中國地區 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除以下部分外,所有Power Apps區域 - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除以下部分外,所有Power Automate區域: - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 支援通道 |
| URL | https://messagemedia.com/contact/ |
| support@messagemedia.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 辛奇瑞典 AB |
| 網站 | https://messagemedia.com |
| 隱私策略 | https://messagemedia.com/legal/privacy-policy/ |
| 類別 | Communication |
您的連接器名稱
辛奇交戰
API 文件
https://docs.app.api.sinch.com/
支援的作業
如何取得認證
此連接器使用 API Key 和 API secret 身份驗證(請參閱以下鏈接中的步驟,瞭解如何獲取一個) https://support.app.sinch.com/hc/en-us/articles/11098727231375-Creating-new-API-credentials
支援的作業
此連接器支援下列作業:
-
Send Text Message (SMS):向多個行動收件人發送簡訊(SMS)。 -
Send Rich Text Message (RCS):將 RCS 訊息傳送給行動收件人。 -
Send MMS Message (MMS):向多個行動收件人發送多媒體訊息(MMS)。 -
Get sender IDs:取得與你帳戶連結的寄件人ID。 -
Get message status:使用訊息 ID 獲取訊息狀態。 -
When a message is received:此操作會在您收到來信(SMS、RCS、MMS)時觸發。 -
When delivery receipt is received:此操作會在您收到外發訊息(SMS、RCS、MMS)的送達收據時觸發。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 密鑰 (api_key) | securestring | 此 API 的api_key | 對 |
| api_secret | securestring | 此 API 的api_secret | 對 |
| 辛奇服務 | 字串 | 這是連接的 API,請選擇以下之一:Sinch MessageMedia(亞洲專屬帳號最佳);Sinch Engage(歐洲、美國帳戶最佳) | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 取得寄件者 ID |
取得與你帳戶連結的寄件人識別碼清單。 |
| 取得訊息狀態 |
使用 Message ID 取得訊息狀態。 |
| 發送多媒體訊息 |
此動作用於向行動號碼發送多媒體訊息(MMS)。 |
| 發送富文字訊息(RCS) |
將 RCS 訊息發送給行動收件人。 |
| 發送短信 (SMS) |
向多個行動裝置收件人發送簡訊(SMS)。 |
取得寄件者 ID
取得與你帳戶連結的寄件人識別碼清單。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
頁面
|
pagination.page | integer |
頁面 |
|
page_size
|
pagination.page_size | integer |
page_size |
|
total_count
|
pagination.total_count | integer |
total_count |
|
page_count
|
pagination.page_count | integer |
page_count |
|
型別
|
default_sender.type | string |
型別 |
|
數字
|
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 |
|
標籤
|
senders.label | string |
標籤 |
|
mms_capable
|
senders.mms_capable | boolean |
mms_capable |
|
數字
|
senders.number | string |
數字 |
|
display_name
|
senders.display_name | string |
發送者格式化顯示名稱 |
|
number_id
|
senders.number_id | string |
number_id |
|
source_type
|
senders.source_type | string |
source_type |
|
型別
|
senders.type | string |
型別 |
|
number_status
|
senders.number_status | string |
number_status |
|
account_id
|
account_id | string |
account_id |
|
vendor_id
|
vendor_id | string |
vendor_id |
取得訊息狀態
使用 Message ID 取得訊息狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
此訊息的唯一 ID
|
messageId | True | string |
此訊息的唯一 ID |
傳回
- 身體
- message
發送多媒體訊息
此動作用於向行動號碼發送多媒體訊息(MMS)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
目的地號碼
|
to | True | string |
收件人的手機號碼(E.164格式)。 最多100名收件人,中間有空格分隔 |
|
Message
|
message | True | string |
MMS 訊息主體 |
|
媒體內容
|
media | byte |
媒體內容將包含在 MMS 訊息中,編碼為 Base64 字串。 支援的媒體類型包括圖片(JPEG、PNG、GIF)、影片(MP4)及音訊檔案(MP3)。 每個媒體附件的最大檔案大小為 600kB。 |
|
|
寄件者識別碼
|
source_number | string |
指定一個支援MMS的來源號碼 |
|
|
中繼資料索引鍵
|
metadata_key | string |
中繼資料索引鍵 |
|
|
詮釋資料值
|
metadata_value | string |
詮釋資料值 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
每則訊息都可以請求送達報告 |
|
destination_number
|
messages.destination_number | string |
目的地號碼 |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
訊息到期時間戳記 |
|
message_id
|
messages.message_id | string |
訊息識別碼 |
|
來源
|
messages.metadata.Source | string |
來源 |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
狀態
|
messages.status | string |
狀態 |
|
內容
|
messages.content | string |
內容 |
|
source_number
|
messages.source_number | string |
來源編號 |
|
媒體
|
messages.media | array of string |
媒體 |
|
主題
|
messages.subject | string |
主題 |
發送富文字訊息(RCS)
將 RCS 訊息發送給行動收件人。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
發送短信 (SMS)
向多個行動裝置收件人發送簡訊(SMS)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
寄件者識別碼
|
source_number | string |
指定要使用的來源號碼 |
|
|
目的地號碼
|
to | True | string |
收件人的手機號碼(E.164格式)。 最多100名收件人,中間有空格分隔 |
|
Message
|
message | True | string |
SMS訊息內文 |
|
遞送報告
|
delivery_report | boolean |
每則訊息都可以要求傳遞報告。 如果要求傳遞報告,則會將 Webhook 提交至為訊息指定的 callback_url 屬性 (或 Webhook) |
|
|
回呼網址
|
callback_url | string |
每個訊息中都可以包含一個 URL,Webhook 將透過 HTTP POST 請求推送到該訊息 |
|
|
中繼資料索引鍵
|
metadata_key | string |
中繼資料索引鍵 |
|
|
詮釋資料值
|
metadata_value | string |
中繼資料值 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
每則訊息都可以要求傳遞報告。 如果要求傳遞報告,則會將 Webhook 提交至為訊息指定的 callback_url 屬性 (或 Webhook) |
|
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 |
訊息識別碼 |
|
來源
|
messages.metadata.Source | string |
來源 |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
狀態
|
messages.status | string |
狀態 |
|
內容
|
messages.content | string |
內容 |
|
source_number
|
messages.source_number | string |
來源編號 |
|
媒體
|
messages.media | array of string |
媒體 |
|
主題
|
messages.subject | string |
主題 |
觸發程序
| 收到訊息時 |
此操作會在收到訊息(SMS、RCS、MMS)時觸發。 |
| 當收到送貨收據時 |
此操作會在您收到外撥訊息(SMS、RCS、MMS)的送達收據時觸發。 |
收到訊息時
此操作會在收到訊息(SMS、RCS、MMS)時觸發。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
原始訊息的 ID |
|
reply_id
|
reply_id | string |
此通知所代表之回覆的唯一識別碼 |
|
狀態
|
status | string |
傳遞報告指出訊息狀態 |
|
source_address
|
source_address | string |
來源位址 |
|
destination_address
|
destination_address | string |
目的地位址 |
|
內容
|
content | string |
回復內容 |
|
訊息內容 V2 - 文字
|
contact_message.text_message.text | string |
訊息內容 V2 - 文字 |
|
型別
|
type | string |
型別 |
|
status_code
|
status_code | string |
狀態碼可讓您更精細地瞭解訊息的狀態 |
|
submitted_date
|
submitted_date | string |
訊息時間戳記 |
|
date_received
|
date_received | string |
提供者時間戳記 |
|
Attachments
|
attachments | array of object |
包含回覆中包含的所有附件的清單。 只有在您已在帳戶中啟用傳入彩信,且回覆包含附件時,才會出現此欄位 |
|
附件類型
|
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、RCS、MMS)的送達收據時觸發。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
原始訊息的 ID |
|
狀態
|
status | string |
傳遞報告指出訊息狀態 |
|
source_address
|
source_address | string |
來源位址 |
|
destination_address
|
destination_address | string |
目的地位址 |
|
內容
|
content | string |
內容 |
|
型別
|
type | string |
型別 |
|
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 |
詮釋資料值 |
定義
訊息
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
callback_url
|
callback_url | string |
每個訊息中都可以包含一個 URL,Webhook 將透過 HTTP POST 請求推送到該訊息 |
|
delivery_report
|
delivery_report | boolean |
每則訊息都可以要求傳遞報告。 如果要求傳遞報告,則會將 Webhook 提交至為訊息指定的 callback_url 屬性 (或 Webhook) |
|
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 |
訊息識別碼 |
|
來源
|
metadata.Source | string |
來源 |
|
scheduled
|
scheduled | string |
訊息的排程傳遞日期、時間 |
|
狀態
|
status | string |
訊息的狀態 |
|
內容
|
content | string |
內容 |
|
source_number
|
source_number | string |
來源編號 |
|
媒體
|
media | array of string |
媒體 |
|
主題
|
subject | string |
主題 |