Sinch (預覽版)
Sinch 透過提醒、提醒、邀請、行銷活動等方式,協助您的企業與顧客建立連結。 由 Sinch Engage、Sinch MessageMedia、One NZ、eTXT 和 GroupText 支持,我們的平台在全球傳遞數十億則訊息。 透過此連接器,您可以輕鬆將簡訊與 RCS 整合進工作流程,簡化並自動化客戶溝通。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - 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://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 身份驗證(請參閱以下鏈接中的步驟,瞭解如何獲取一個) 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)的送達收據時觸發。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 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 |
此操作將返回鏈接到您帳戶的發件人 ID 列表。 |
| 取得訊息狀態 |
使用訊息 ID 取得訊息狀態 |
| 發送富文字訊息(RCS) |
發送富文字訊息(RCS) |
| 發送短信 (SMS) |
此動作用於向手機號碼發送簡訊(SMS)。 |
取得寄件者 ID
此操作將返回鏈接到您帳戶的發件人 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 |
數字 |
|
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 |
取得訊息狀態
發送富文字訊息(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 時 |
當您收到傳入的簡訊 (SMS) 時,會觸發此作業。 |
| 當收到送貨收據時 |
當您收到傳出文字訊息 (SMS) 的遞送回執時,會觸發此作業。 |
當收到 SMS 或 RCS 時
當您收到傳入的簡訊 (SMS) 時,會觸發此作業。
傳回
| 名稱 | 路徑 | 類型 | 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) 的遞送回執時,會觸發此作業。
傳回
| 名稱 | 路徑 | 類型 | 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 |
主題 |