簡訊作品（獨立發行商）（預覽版）

SMS Works 是一項針對英國開發人員的低成本 SMS 服務。您只需為已發送的短信付費。

此連接器適用於以下產品和區域：

服務	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://www.hitachisolutions.com
Email	ttaylor@hitachisolutions.com

連接器中繼資料
Publisher	特洛伊·泰勒
網站	https://thesmsworks.co.uk/
隱私策略	https://thesmsworks.co.uk/privacy
類別	Communication

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
JWT 代幣	securestring	此 API 的 JWT 權杖	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

傳送 SMS 訊息	根據您的參數發送短信。
傳送批次	將單個 SMS 消息發送給多個收件人。
傳送訊息集合	傳送一組獨特的 SMS 訊息。批次一次最多可包含 5000 則訊息。
刪除訊息	刪除具有相符 messageid 的訊息。
取得失敗的訊息	擷取符合搜尋條件的失敗訊息。
取得客戶 ID	將客戶 ID 傳回給來電者。
取得排定的訊息	傳回從您帳戶排程的訊息清單，包括過去 3 個月內排程的任何訊息，以及未來排定傳送的任何訊息。
取得未讀訊息	取得符合您搜尋條件的未讀傳入郵件。
取得積分	傳回帳戶上目前可用的點數數目。
取得訊息	依訊息 ID 擷取記錄的訊息。
取消排程批次	取消排程的簡訊。
取消排程訊息	取消排程的簡訊。
排程批次	排程在您指定的日期時間傳送一批 SMS 訊息。
排程訊息	排程在您指定的日期時間傳送 SMS 訊息。
搜尋訊息	檢索多達 1000 條符合您搜索條件的消息。
擷取批次訊息	擷取具有指定批次識別碼的批次中的所有訊息。
發送快訊	傳送 SMS 快閃訊息，該訊息會顯示在收件者的鎖定畫面上。

傳送 SMS 訊息

作業識別碼：: SendMessage

根據您的參數發送短信。

參數

名稱	機碼	必要	類型	Description
寄件者	sender	True	string	訊息的寄件者。英數字元不應超過 11 個字元，或數字寄件者 ID 不應超過 15 個字元。沒有空格或特殊字元。
目的地	destination	True	string	收件人的電話號碼
Content	content	True	string	要傳送給收件者的訊息。內容長度最多可達 1280 個字元。 160 個字元或更少的訊息將收取 1 個積分。如果您的訊息長度超過 160 個字元，則在發送到收件人的手機之前，它將被分解為 153 個字元的區塊，並且每 153 個字元將向您收取 1 個積分。發送到在英國境外註冊的號碼的訊息通常會收取雙倍積分，但對於某些國家/地區，可能會收取一小部分積分（例如 2.5）。請聯絡我們以了解每個國家/地區的費率。
傳遞報告 URL	deliveryreporturl		string	我們應該針對此訊息報告POST傳遞的URL。如果未指定任何項目，我們將使用您在帳戶頁面上設定的全域傳遞報告 URL。
排程	schedule		string	傳送訊息的日期。這僅由訊息/排程服務使用，並且可以留空用於其他服務。
標記	tag		string	訊息的識別標籤，可用來篩選和報告您稍後傳送的訊息。非常適合活動。最多 280 個字元。
TTL	ttl		number	刪除傳遞報告之前的選擇性分鐘數。選擇性。省略以防止刪除傳遞報告。
回覆電子郵件	responseemail		array of string	可選的電子郵件地址清單，可將此特定訊息的回應轉寄至。使用此功能需要 SMS Works 回覆號碼。
後設資料	Metadata		object
有效期	validity		number	在訊息標示為 EXPIRED 之前嘗試傳遞的選擇性分鐘數。選擇性。預設值為 2880 分鐘。

傳回

response: SendMessageResponse

傳送批次

作業識別碼：: SendBatch

將單個 SMS 消息發送給多個收件人。

參數

名稱	機碼	必要	類型	Description
短信消息	smsMessage	True		訊息屬性

傳回

response: BatchMessageResponse

傳送訊息集合

作業識別碼：: SendAny

傳送一組獨特的 SMS 訊息。批次一次最多可包含 5000 則訊息。

參數

名稱	機碼	必要	類型	Description
messages	messages	True		訊息陣列

傳回

response: BatchMessageResponse

刪除訊息

作業識別碼：: DeleteMessage

刪除具有相符 messageid 的訊息。

參數

名稱	機碼	必要	類型	Description
訊息 ID	messageid	True	string	您要傳回的訊息 ID

傳回

response: DeletedMessageResponse

取得失敗的訊息

作業識別碼：: GetFailedMessages

擷取符合搜尋條件的失敗訊息。

參數

名稱	機碼	必要	類型	Description
查詢	query	True

傳回

response: array of MessageResponse

取得客戶 ID

作業識別碼：: Test

將客戶 ID 傳回給來電者。

傳回

response: TestResponse

取得排定的訊息

作業識別碼：: GetScheduledMessages

傳回從您帳戶排程的訊息清單，包括過去 3 個月內排程的任何訊息，以及未來排定傳送的任何訊息。

傳回

排定在指定日期和時間傳送之訊息的詳細資料

response: ScheduledMessagesResponse

取得未讀訊息

作業識別碼：: GetInboxMessages

取得符合您搜尋條件的未讀傳入郵件。

參數

名稱	機碼	必要	類型	Description
查詢	query	True

傳回

response: array of MessageResponse

取得積分

作業識別碼：: Credits

傳回帳戶上目前可用的點數數目。

傳回

response: CreditsResponse

取得訊息

作業識別碼：: GetMessageById

依訊息 ID 擷取記錄的訊息。

參數

名稱	機碼	必要	類型	Description
訊息 ID	messageid	True	string	您要傳回的訊息 ID

傳回

response: MessageResponse

取消排程批次

作業識別碼：: CancelScheduledBatchJob

取消排程的簡訊。

參數

名稱	機碼	必要	類型	Description
批次識別碼	batchid	True	string	您要傳回的批次識別碼

傳回

response: CancelledMessageResponse

取消排程訊息

作業識別碼：: CancelScheduledJob

取消排程的簡訊。

參數

名稱	機碼	必要	類型	Description
訊息 ID	messageid	True	string	您要傳回的訊息 ID

傳回

response: CancelledMessageResponse

排程批次

作業識別碼：: ScheduleBatch

排程在您指定的日期時間傳送一批 SMS 訊息。

參數

名稱	機碼	必要	類型	Description
短信消息	smsMessage	True		訊息屬性

傳回

response: ScheduledBatchResponse

排程訊息

作業識別碼：: ScheduleMessage

排程在您指定的日期時間傳送 SMS 訊息。

參數

名稱	機碼	必要	類型	Description
寄件者	sender	True	string	訊息的寄件者。英數字元不應超過 11 個字元，或數字寄件者 ID 不應超過 15 個字元。沒有空格或特殊字元。
目的地	destination	True	string	收件人的電話號碼
Content	content	True	string	要傳送給收件者的訊息。內容長度最多可達 1280 個字元。 160 個字元或更少的訊息將收取 1 個積分。如果您的訊息長度超過 160 個字元，則在發送到收件人的手機之前，它將被分解為 153 個字元的區塊，並且每 153 個字元將向您收取 1 個積分。發送到在英國境外註冊的號碼的訊息通常會收取雙倍積分，但對於某些國家/地區，可能會收取一小部分積分（例如 2.5）。請聯絡我們以了解每個國家/地區的費率。
傳遞報告 URL	deliveryreporturl		string	我們應該針對此訊息報告POST傳遞的URL。如果未指定任何項目，我們將使用您在帳戶頁面上設定的全域傳遞報告 URL。
排程	schedule		string	傳送訊息的日期。這僅由訊息/排程服務使用，並且可以留空用於其他服務。
標記	tag		string	訊息的識別標籤，可用來篩選和報告您稍後傳送的訊息。非常適合活動。最多 280 個字元。
TTL	ttl		number	刪除傳遞報告之前的選擇性分鐘數。選擇性。省略以防止刪除傳遞報告。
回覆電子郵件	responseemail		array of string	可選的電子郵件地址清單，可將此特定訊息的回應轉寄至。使用此功能需要 SMS Works 回覆號碼。
後設資料	Metadata		object
有效期	validity		number	在訊息標示為 EXPIRED 之前嘗試傳遞的選擇性分鐘數。選擇性。預設值為 2880 分鐘。

傳回

response: array of ScheduledMessageResponse

搜尋訊息

作業識別碼：: GetMessages

檢索多達 1000 條符合您搜索條件的消息。

參數

名稱	機碼	必要	類型	Description
查詢	query	True

傳回

response: array of MessageResponse

擷取批次訊息

作業識別碼：: GetBatchById

擷取具有指定批次識別碼的批次中的所有訊息。

參數

名稱	機碼	必要	類型	Description
批次識別碼	batchid	True	string	您要傳回的批次識別碼

傳回

response: array of MessageResponse

發送快訊

作業識別碼：: SendFlashMessage

傳送 SMS 快閃訊息，該訊息會顯示在收件者的鎖定畫面上。

參數

名稱	機碼	必要	類型	Description
寄件者	sender	True	string	訊息的寄件者。英數字元不應超過 11 個字元，或數字寄件者 ID 不應超過 15 個字元。沒有空格或特殊字元。
目的地	destination	True	string	收件人的電話號碼
Content	content	True	string	要傳送給收件者的訊息。內容長度最多可達 1280 個字元。 160 個字元或更少的訊息將收取 1 個積分。如果您的訊息長度超過 160 個字元，則在發送到收件人的手機之前，它將被分解為 153 個字元的區塊，並且每 153 個字元將向您收取 1 個積分。發送到在英國境外註冊的號碼的訊息通常會收取雙倍積分，但對於某些國家/地區，可能會收取一小部分積分（例如 2.5）。請聯絡我們以了解每個國家/地區的費率。
傳遞報告 URL	deliveryreporturl		string	我們應該針對此訊息報告POST傳遞的URL。如果未指定任何項目，我們將使用您在帳戶頁面上設定的全域傳遞報告 URL。
排程	schedule		string	傳送訊息的日期。這僅由訊息/排程服務使用，並且可以留空用於其他服務。
標記	tag		string	訊息的識別標籤，可用來篩選和報告您稍後傳送的訊息。非常適合活動。最多 280 個字元。
TTL	ttl		number	刪除傳遞報告之前的選擇性分鐘數。選擇性。省略以防止刪除傳遞報告。
回覆電子郵件	responseemail		array of string	可選的電子郵件地址清單，可將此特定訊息的回應轉寄至。使用此功能需要 SMS Works 回覆號碼。
後設資料	Metadata		object
有效期	validity		number	在訊息標示為 EXPIRED 之前嘗試傳遞的選擇性分鐘數。選擇性。預設值為 2880 分鐘。

傳回

response: SendMessageResponse

定義

測試回應

學分回應

ScheduledMessages回應