共用方式為

智能對話框

SmartDialog 是一個用於發送和接收 SMS 和 WhatsApp 消息的平台。 它提供各種各樣的智能消息服務。

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

服務 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.arenainteractive.fi/contact
Email support@arenainteractive.fi
連接器中繼資料
Publisher 競技場互動 Oy
網站 https://www.arenainteractive.fi
隱私策略 https://www.arenainteractive.fi/privacypolicy
類別 傳達;通敵

SmartDialog 連接器

此連接器可用於使用 SmartDialog 平台發送和接收 SMS 消息。

先決條件

  1. SmartDialog 訂閱和帳戶。 請與 sales@arenainteractive.fi
  2. 需要為您的帳戶啟用 OAuth，並要求用戶端密碼。 這可以通過向 support@arenainteractive.fi我們發送電子郵件來完成。

設定

  1. 請遵循從 OpenAPI定義建立自訂聯結器中的指示。
  2. 建立流程或 PowerApp，並從自訂區段新增 SmartDialog 動作。 使用您的 SmartDialog 帳戶登入。

支援的動作

  • 新訊息（接收訊息的觸發器）
  • 傳送訊息
  • 發送 WhatsApp 訊息
  • 傳送討論回覆訊息
  • 發送回覆訊息
  • WhatsApp 選擇加入
  • WhatsApp 選擇退出
  • 創建 WhatsApp 模板
  • 取得群組聯絡方式
  • 建立群組聯絡人
  • 更新群組聯絡人
  • 刪除群組聯絡人
  • 刪除所有群組聯絡人

節流限制

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

動作

WhatsApp 選擇加入（已棄用）[已棄用]

WhatsApp 選擇加入發件人和收件人。 （已棄用）
WhatsApp 選擇退出（已棄用）[已棄用]

WhatsApp 選擇退出發件人和收件人。 （已棄用）
傳送訊息

傳送訊息給收件者。
傳送討論回覆訊息

傳送討論回覆訊息給收件者。
刪除所有群組聯絡人

刪除所有群組聯絡人
刪除群組聯絡人

使用電話號碼刪除群組聯絡人。
創建 WhatsApp 模板

建立新的 WhatsApp 範本。
取得群組聯絡方式

取得群組聯絡方式
建立群組聯絡人

建立群組聯絡人
更新群組聯絡人

更新群組聯絡人
發送 WhatsApp 訊息

發送 WhatsApp 模板消息。
發送回覆訊息

傳送回覆訊息給收件者。

WhatsApp 選擇加入（已棄用）[已棄用]

作業識別碼：
WhatsAppOptIn

WhatsApp 選擇加入發件人和收件人。 （已棄用）

參數

名稱 機碼 必要 類型 Description
寄件者位址
 Sender True string

註冊的 Whatsapp 身分證號碼以選擇加入。
收件人地址
 Recipient True string

要選擇加入的收件者編號。

WhatsApp 選擇退出（已棄用）[已棄用]

作業識別碼：
WhatsAppOptOut

WhatsApp 選擇退出發件人和收件人。 （已棄用）

參數

名稱 機碼 必要 類型 Description
寄件者位址
 Sender True string

註冊的 Whatsapp 身份證號碼以選擇退出。
收件人地址
 Recipient True string

要從選擇加入中刪除的配方編號。

傳送訊息

作業識別碼：
SendMessage

傳送訊息給收件者。

參數

名稱 機碼 必要 類型 Description
客戶
 Customer-Id True string

用於傳送的客戶。
服務
 Service-Id True string

用於傳送的服務。
訊息傳送者
 Sender True string

訊息的寄件者可以是字母數字、長代碼或短代碼（有限制）。
訊息內容
 Content True string

訊息的內容。
訊息通訊協定
 Protocol True string

用來傳送訊息的通訊協定。
傳送日期時間
 SendDateTime date-time

傳送訊息的日期和時間。 留空以立即發送。
Address
 Address True string

郵件收件者地址。
附件 Uri
 AttachmentUri string

傳送包含附件的 WhatsApp 訊息時要使用的附件 URI。
客戶資料
 CustomerData string

此訊息的計費/分組資料，選用。
廣告訊息
 AdMessage boolean

選用覆寫旗標，可將訊息標示為廣告訊息
Dlr 網址
 DlrUrl string

透過 http-get 傳遞狀態回呼的 URL。 您可以將查詢字串值新增至 url，它們將被保留。
請求標識碼
 RequestId string

選用的唯一請求 ID，可用來識別重複的請求。 如果偵測到重複的要求 ID，則會取消傳送。 無法保證在高輸送量/流量情況下，具有重複請求 ID 的要求會遭到封鎖。 指定的 requestId 將被「記住」7 天。

傳回

名稱 路徑 類型 Description
訊息標識碼
 MessageId string

新建立的訊息識別碼。
訊息部分計數
 MessagePartCount integer

此訊息的訊息組件的近似數目。
收件者
 Recipients array of object

收件者
收件人地址
 Recipients.Address string

收件人地址（電話號碼/電子郵件/用戶 ID 等）。
收件者 ID
 Recipients.Id string

用於接收傳遞狀態資訊的收件者識別碼。

傳送討論回覆訊息

作業識別碼：
SendDiscussionReplyMessage

傳送討論回覆訊息給收件者。

參數

名稱 機碼 必要 類型 Description
客戶
 CustomerId True string

用於傳送的客戶。
執行緒識別碼
 ThreadId True string

要回覆的現有執行緒的識別碼。
訊息內容
 Content True string

訊息的內容。
客戶資料
 CustomerData string

此訊息的計費/分組資料，選用。

傳回

名稱 路徑 類型 Description
訊息標識碼
 MessageId string

新建立的訊息識別碼。
訊息部分計數
 MessagePartCount integer

此訊息的訊息組件的近似數目。
收件者
 Recipients array of object

收件者
收件人地址
 Recipients.Address string

收件人地址（電話號碼/電子郵件/用戶 ID 等）。
收件者 ID
 Recipients.Id string

用於接收傳遞狀態資訊的收件者識別碼。
ThreadId
 ThreadId string

訊息傳送至的執行緒識別碼。

刪除所有群組聯絡人

作業識別碼：
DeleteAllGroupContacts

刪除所有群組聯絡人

參數

名稱 機碼 必要 類型 Description
客戶
 Customer True string

客戶要取得群組服務。
團體服務
 Group Service True string

要使用的群組服務。

傳回

response
boolean

刪除群組聯絡人

作業識別碼：
DeleteGroupContact

使用電話號碼刪除群組聯絡人。

參數

名稱 機碼 必要 類型 Description
客戶
 Customer True string

客戶要取得群組服務。
團體服務
 Group Service True string

要使用的群組服務。
電話
 Phone True string

要刪除的聯絡人的電話號碼。

傳回

response
boolean

創建 WhatsApp 模板

作業識別碼：
CreateWhatsappTemplate

建立新的 WhatsApp 範本。

參數

名稱 機碼 必要 類型 Description
客戶
 Customer-Id True string

要為其建立範本的客戶。
身分識別號碼
 IdentityNumber True string

用於範本的 WhatsApp 身分識別號碼。
顯示名稱
 DisplayName True string

範本顯示名稱。
Content
 RawContent True string

範本內容。
範本類別
 Category True string

範本類別。
範本語言
 Language True string

模板語言的 2 個字符代碼。
按鈕類型
 Type string

按鈕類型。
按鈕標籤
 Label string

按鈕標籤。
按鈕資料
 Data string

按鈕資料。 網址 （Url）、電話號碼 （Call） 或文字 （QuickReply）。 Url 的最大長度為 2000，電話號碼和文本的最大長度為 20。
附件網址
 AttachmentUrl string

範例附件的 URL。

取得群組聯絡方式

作業識別碼：
GetGroupContact

取得群組聯絡方式

參數

名稱 機碼 必要 類型 Description
客戶
 Customer True string

客戶要取得群組服務。
團體服務
 Group Service True string

要使用的群組服務。
電話
 Phone True string

聯絡人的電話號碼。
區域
 Region string

選用的電話號碼區域，用於剖析電話號碼。

傳回

名稱 路徑 類型 Description
電話
 phone string

聯絡人的電話號碼。
Email
 email string

聯絡人的電子郵件地址。
名字
 firstName string

聯絡人的名字。
姓氏
 lastName string

聯絡人的姓氏。
性別
 gender string

聯繫人的性別。
出生年份
 birthYear integer

聯繫人的出生年份。
地址
 streetAddress string

聯絡人的街道地址。
郵遞區號
 zipCode string

聯絡人的郵遞區號。
城市
 city string

接觸城市。
國碼 (地區碼)
 countryCode string

聯絡人的國家/地區代碼。
失敗的訊息
 failedMessages integer

聯絡人的失敗訊息數。
自訂屬性
 customContactProperties array of object

為聯絡人儲存的自訂連絡人屬性集合。
名稱
 customContactProperties.name string

自訂聯絡人屬性名稱。
價值觀
 customContactProperties.value string

自訂連絡人屬性值。

建立群組聯絡人

作業識別碼：
CreateGroupContact

建立群組聯絡人

參數

名稱 機碼 必要 類型 Description
客戶
 Customer True string

客戶要取得群組服務。
團體服務
 Group Service True string

要使用的群組服務。
Active
 active boolean

指示聯絡人是否處於作用中的旗標。
電話
 phone True string

聯絡人的電話號碼。
Email
 email string

聯絡人的電子郵件地址。
名字
 firstName string

聯絡人的名字。
姓氏
 lastName string

聯絡人的姓氏。
性別
 gender string

聯繫人的性別。
出生年份
 birthYear integer

聯繫人的出生年份。
地址
 streetAddress string

聯絡人的街道地址。
郵遞區號
 zipCode string

聯絡人的郵遞區號。
城市
 city string

接觸城市。
國碼 (地區碼)
 countryCode string

聯絡人的 3 個字母國家/地區代碼。
名稱
 name string

自訂屬性名稱。
價值觀
 value string

自訂屬性值。
電話號碼區域
 phoneNumberRegions array of string

用於解析號碼的電話號碼區域。 如果留空，則默認為芬蘭。

傳回

已建立聯絡人的唯一 ID。

聯絡人 ID
uuid

更新群組聯絡人

作業識別碼：
UpdateGroupContact

更新群組聯絡人

參數

名稱 機碼 必要 類型 Description
客戶
 Customer True string

客戶要取得群組服務。
團體服務
 Group Service True string

要使用的群組服務。
電話
 Phone True string

要更新之連絡人的電話號碼。
Active
 active boolean

指示聯絡人是否處於作用中的旗標。
Email
 email string

聯絡人的電子郵件地址。
名字
 firstName string

聯絡人的名字。
姓氏
 lastName string

聯絡人的姓氏。
性別
 gender string

聯繫人的性別。
出生年份
 birthYear integer

聯繫人的出生年份。
地址
 streetAddress string

聯絡人的街道地址。
郵遞區號
 zipCode string

聯絡人的郵遞區號。
城市
 city string

接觸城市。
國碼 (地區碼)
 countryCode string

聯絡人的 3 個字母國家/地區代碼。
名稱
 name string

自訂聯絡人屬性名稱。
價值觀
 value string

自訂連絡人屬性值。
電話號碼區域
 phoneNumberRegions array of string

用於解析號碼的電話號碼區域。 如果留空，則默認為芬蘭。

傳回

response
boolean

發送 WhatsApp 訊息

作業識別碼：
SendWhatsappTemplateMessage

發送 WhatsApp 模板消息。

參數

名稱 機碼 必要 類型 Description
客戶
 Customer-Id True string

用於傳送的客戶。
服務
 Service-Id True string

用於傳送的服務。
WhatsApp 模板
 TemplateName True string

用於傳送的範本。
Address
 Address True string

郵件收件者地址。
BodyParameters
 BodyParameters array of string

BodyParameters
HeaderParameters
 HeaderParameters array of string

HeaderParameters
類型
 Type string

按鈕類型。 每個範本只能包含一個類型，可以包含多個相同類型的類型。
文字
 Data string

按鈕的文字。
傳送日期時間
 SendDateTime string

傳送訊息的日期和時間。 留空以立即發送。
附件 Uri
 AttachmentUri string

附件 URI （如果範本包含附件）。
使用 SMS 後援
 UseSmsFallback boolean

是否應該使用 SMS 作為後備。
Dlr 網址
 DlrUrl string

傳遞報告 傳送程序完成時將收到回呼的 URL。
客戶資料
 CustomerData string

此訊息的計費/分組資料，選用。
請求標識碼
 RequestId string

選用的唯一請求 ID，可用來識別重複的請求。 如果偵測到重複的要求 ID，則會取消傳送。 無法保證在高輸送量/流量情況下，具有重複請求 ID 的要求會遭到封鎖。 指定的 requestId 將被「記住」7 天。

傳回

名稱 路徑 類型 Description
訊息標識碼
 messageId string

新建立的訊息識別碼。
訊息部分計數
 messagePartCount integer

此訊息的訊息組件的近似數目。
收件人
 recipients array of object

收件人
收件人地址
 recipients.address string

收件人地址（電話號碼/電子郵件/用戶 ID 等）。
收件者 ID
 recipients.id string

用於接收傳遞狀態資訊的收件者識別碼。

發送回覆訊息

作業識別碼：
SendReplyMessage

傳送回覆訊息給收件者。

參數

名稱 機碼 必要 類型 Description
ParentMessage Id
 ParentMessageId True string

要回覆的父訊息識別碼。
客戶
 Customer-Id True string

用於傳送的客戶。
服務
 Service-Id True string

用於傳送的服務。
訊息傳送者
 Sender True string

訊息的寄件者可以是字母數字、長代碼或短代碼（有限制）。
訊息內容
 Content True string

訊息的內容。
訊息通訊協定
 Protocol True string

用來傳送訊息的通訊協定。
傳送日期時間
 SendDateTime date-time

傳送訊息的日期和時間。 留空以立即發送。
Address
 Address True string

郵件收件者地址。
附件 Uri
 AttachmentUri string

傳送包含附件的 WhatsApp 訊息時要使用的附件 URI。
客戶資料
 CustomerData string

此訊息的計費/分組資料，選用。
廣告訊息
 AdMessage boolean

選用覆寫旗標，可將訊息標示為廣告訊息
Dlr 網址
 DlrUrl string

透過 http-get 傳遞狀態回呼的 URL。 您可以將查詢字串值新增至 url，它們將被保留。
請求標識碼
 RequestId string

選用的唯一請求 ID，可用來識別重複的請求。 如果偵測到重複的要求 ID，則會取消傳送。 無法保證在高輸送量/流量情況下，具有重複請求 ID 的要求會遭到封鎖。 指定的 requestId 將被「記住」7 天。

傳回

名稱 路徑 類型 Description
訊息標識碼
 MessageId string

新建立的訊息識別碼。
訊息部分計數
 MessagePartCount integer

此訊息的訊息組件的近似數目。
收件者
 Recipients array of object

收件者
收件人地址
 Recipients.Address string

收件人地址（電話號碼/電子郵件/用戶 ID 等）。
收件者 ID
 Recipients.Id string

用於接收傳遞狀態資訊的收件者識別碼。

觸發程序

新訊息

當新訊息到達 2-Way 服務時。

新訊息

作業識別碼：
NewMessage

當新訊息到達 2-Way 服務時。

參數

名稱 機碼 必要 類型 Description
客戶
 Customer True string

要使用的客戶。
服務
 Service True string

要使用的 2-Way 服務。

傳回

名稱 路徑 類型 Description
訊息傳送者
 sender string

訊息寄件者。
訊息收件者
 recipient string

訊息的收件者。
訊息內容
 content string

收到的訊息內容。
訊息時間戳記
 timestamp date-time

訊息的時間戳記。
訊息通訊協定
 protocol string

已接收訊息的通訊協定。
attachments
 attachments array of object

attachments
附件檔名
 attachments.name string

附件的檔名。
附件 MIME 類型
 attachments.mimeType string

附件的 MIME 類型。
附件資源位置
 attachments.resourceLocation string

附件資源位置。
訊息標識碼
 messageId string

已接收訊息的唯一訊息識別碼。

定義

全域唯一識別碼 (UUID)

已建立聯絡人的唯一 ID。

已建立聯絡人的唯一 ID。

聯絡人 ID
uuid

布爾值

這是基本資料類型「布林值」。