共用方式為

TrueDialog 簡訊

TrueDialog 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）
連絡人​​
名稱 TrueDialog 支援
URL https://www.truedialog.com/help/
Email support@truedialog.com
連接器中繼資料
Publisher TrueDialog 動態
網站 https://www.truedialog.com/
隱私策略 https://www.truedialog.com/privacy-policy/
類別 Communication

TrueDialog 的 SMS API 是企業級的，具有比任何其他 SMS 軟件更多的預構建功能。 我們的 SMS API 專為開發人員打造，高度可靠、安全，並包含預先建置的 ISO 9001 資料庫，可提供額外的選擇退出和合規保護。 也可通過我們功能齊全的 Enterprise-Grade SMS 短信軟件獲得。

先決條件

您將需要這些認證才能繼續：

  • Microsoft Power Apps 或 Power Automate 方案
  • TrueDialog 帳戶和計劃以及您帳戶的 TrueDialog API 金鑰和密碼。 點擊 這裡 註冊。

如何取得認證

點擊 這裡 註冊。 當您註冊 TrueDialog 時，API 密鑰和密碼將位於您的憑據電子郵件中。 如需入門協助，請聯絡我們的團隊。 我們世界一流的客戶服務團隊將引導您完成註冊並選擇最適合您公司需求的帳戶。

聯絡我們：

電子郵件 support@truedialog.com
即時聊天 https://www.truedialog.com/
電話 512-501-5940

開始使用 TrueDialog 連接器

取得認證之後，您就可以開始使用聯結器。

行動

發送短信

最有價值的動作是“發送短信”。 它允許向單個或多個收件人發送短信。 此動作有數個必填欄位：

  • 帳戶 ID – 可從 [取得目前使用者資訊] 回應中使用，也可以硬式編碼。
  • 頻道 — 保留預設值 22 以使用預設關聯的電話號碼。
  • 目標 – 有效的美國電話號碼，無需格式化 （例如：+15125453809）
  • 訊息 – 訊息本身。
  • 執行 — 如果您不想延遲傳送，請保留預設值 True。

觸發器

您可以在這裡找到為帳戶註冊的回呼清單： https://ui.truedialog.com/Callbacks

收到的傳入訊息

最重要的觸發因素。 每當使用者向相關聯的電話號碼發送簡訊時，此操作都會觸發流程。

需要帳戶 ID 才能註冊觸發器。 您可以透過道明入口網站取得帳戶編號，該帳戶位於右上角的帳戶名稱旁邊。

傳入訊息包含訊息文字和其他必要欄位。

停止收到訊息

每當使用者在 STOP 或同義字中傳送文字時，此作業就會觸發流程。 它還會自動選擇退出 TrueDialog 系統中的聯繫。 若要傳送訊息給選擇退出的聯絡人，請在傳送簡訊時將旗標 forceOptIn 設定為 True。 請謹慎使用此 ForceOptIt 功能，並確保追蹤選擇退出的記錄。

為使用者提供開始使用連接器的逐步程式。 您應該在這裡突出顯示常見用例，例如您預期的熱門觸發器和操作，以及它們如何在自動化場景中提供幫助。 盡可能包含圖像。

收到送貨通知

此作業會觸發每個交貨通知收據的流程。 請注意，並非所有行動電信業者都會發送通知收據。

無效目標

當其中一個目標手機無效或被列入黑名單時，仍然可以發送簡訊並且不會收到錯誤。 為此，您應該在傳送訊息時將屬性「IgnoreInvalidTargets」設定為true。 如果已傳送的SMS收件者清單中顯示無效的電話號碼，則此作業會觸發流程。

已知問題與限制

與自定義連接器相比，TrueDialog API 具有更多功能

FAQ

要獲取解導 API 的最新描述，請訪問 此處

在此處提供常見問題的細分及其各自的答案。 這可以涵蓋與基礎服務互動或連接器本身的常見問題。

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

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

名稱 類型 Description 為必填項目
使用者名稱 securestring 此 API 的使用者名稱 對
密碼 securestring 此 API 的密碼 對

節流限制

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

動作

獲取帳戶信息

取得帳戶相關資訊
獲取當前用戶信息

取得使用者的相關資訊，其認證已用於連線
發送短信

傳送簡訊給單一或多個收件者
聯絡人搜尋

透過電話號碼或電子郵件地址搜尋聯絡人。
聯絡人更新

更新連絡人
聯繫人創建

在 TrueDialog 中建立聯絡人記錄

獲取帳戶信息

作業識別碼：
Account_Get_Info

取得帳戶相關資訊

參數

名稱 機碼 必要 類型 Description
應擷取的帳戶識別碼
 accountId True string

帳戶 ID

傳回

身體
AccountResponse

獲取當前用戶信息

作業識別碼：
User_Get_Self_Info

取得使用者的相關資訊，其認證已用於連線

傳回

身體
UserResponse

發送短信

作業識別碼：
Campaign_Push

傳送簡訊給單一或多個收件者

參數

名稱 機碼 必要 類型 Description
帳戶識別碼
 accountId True string

用於傳送簡訊的帳戶ID
渠道
 Channels True array of string

渠道
Targets
 Targets True array of string

Targets
ContactListIds
 ContactListIds array of string

聯絡人清單ID
ExcludeListIds
 ExcludeListIds array of string

排除清單識別碼
媒體 ID
 MediaId integer

媒體 ID
Message
 Message True string

Message
忽略一次性使用
 IgnoreSingleUse boolean

忽略一次性使用
強制選擇
 ForceOptIn boolean

Opt-In 力
附表
 Schedules array of string

與動作相關聯的排程清單
Execute
 Execute True boolean

如果動作應該在建立時執行，請設定 true
忽略無效目標
 IgnoreInvalidTargets boolean

指出是否應忽略無效的數字

傳回

身體
PushCampaignResponse

聯絡人搜尋

作業識別碼：
Contact_Search

透過電話號碼或電子郵件地址搜尋聯絡人。

參數

名稱 機碼 必要 類型 Description
訂閱的帳戶 ID
 accountId True string

連絡人可見的帳戶。
要搜尋的電話號碼
 phone True string

使用傳遞的電話號碼或電子郵件查找現有聯繫人。

傳回

物品
ContactSearchRequest

聯絡人更新

作業識別碼：
Contact_Update

更新連絡人

參數

名稱 機碼 必要 類型 Description
帳戶識別碼
 accountId True string

將用作更新聯絡人的父帳戶的帳戶 ID
連絡人識別碼
 contactid True string

將更新的連絡人識別碼
電話號碼
 PhoneNumber string

手機號碼（如果有）。 此欄位或電子郵件欄位為必要欄位
Email
 Email string

聯繫人的電子郵件位址。 此欄位或電話號碼欄位為必要欄位。
FirstName
 FirstName string

連絡人的名字。
姓氏
 LastName string

聯繫人的姓氏。

傳回

身體
ContactResponse

聯繫人創建

作業識別碼：
Contact_Create

在 TrueDialog 中建立聯絡人記錄

參數

名稱 機碼 必要 類型 Description
帳戶識別碼
 accountId True string

將用作已建立聯絡人的父帳戶的帳戶 ID
電話號碼
 PhoneNumber string

手機號碼（如果有）。 此欄位或電子郵件欄位為必要欄位
Email
 Email string

聯繫人的電子郵件位址。 此欄位或電話號碼欄位為必要欄位。
FirstName
 FirstName string

連絡人的名字。
姓氏
 LastName string

聯繫人的姓氏。

傳回

身體
ContactResponse

觸發程序

停止收到訊息

每當使用者在 STOP 或同義字中傳送文字時，此作業就會觸發流程
收到的傳入訊息

每當使用者傳訊時，此作業都會觸發流程
收到送貨通知

此作業會觸發每個交貨通知收據的流程
收到關鍵字

每當使用者在關鍵字中輸入文字時，此作業都會觸發流程
無效目標

如果在傳送SMS期間篩選出目標，則此作業會觸發流程

停止收到訊息

作業識別碼：
Stop_received

每當使用者在 STOP 或同義字中傳送文字時，此作業就會觸發流程

參數

名稱 機碼 必要 類型 Description
訂閱的帳戶 ID
 accountId True string

在大多數情況下，請使用根帳戶 ID 來訂閱通知。

傳回

名稱 路徑 類型 Description
回呼時間戳記
 CallbackTimestamp string

回呼的傳送日期和時間。 格式：yyyy-MM-ddTHH：mm：ss
回呼令牌
 CallbackToken string

回呼權杖
TransactionId
 TransactionId string

交易識別碼
帳戶ID
 AccountId integer

帳戶 ID
客戶名稱
 AccountName string

回呼與之關聯的帳戶名稱
通道標識
 ChannelId integer

管道識別碼
通道代碼
 ChannelCode string

訊息傳送通道的代碼（長代碼的實際電話號碼）
聯絡人識別碼
 ContactId integer

聯絡人 ID
聯絡人帳戶識別碼
 ContactAccountId integer

擁有連絡人記錄之帳戶的 ID
聯絡人帳戶名稱
 ContactAccountName string

擁有連絡人記錄的帳戶名稱
電話號碼
 PhoneNumber string

已選擇退出的終端使用者電話號碼

收到的傳入訊息

作業識別碼：
Incoming_SMS_Received

每當使用者傳訊時，此作業都會觸發流程

參數

名稱 機碼 必要 類型 Description
訂閱的帳戶 ID
 AccountId True string

在大多數情況下，請使用根帳戶 ID 來訂閱通知。

傳回

名稱 路徑 類型 Description
客戶名稱
 AccountName string

回呼與之關聯的帳戶名稱
通道代碼
 ChannelCode string

訊息傳送通道的代碼（長代碼的實際電話號碼）
通道標識
 ChannelId integer

訊息傳送通道的識別碼
聯絡人識別碼
 ContactId integer

連絡人 ID （如果有的話） （未知連絡人為 null）
Message
 Message string

實際訊息文字
電話號碼
 PhoneNumber string

目標電話號碼
帳戶ID
 AccountId integer

回呼與之相關聯的帳戶 ID
回呼時間戳記
 CallbackTimestamp string

回呼的傳送日期和時間。 格式：yyyy-MM-ddTHH：mm：ss
回呼令牌
 CallbackToken string

回呼權杖
TransactionId
 TransactionId string

唯一令牌

收到送貨通知

作業識別碼：
Delivery_Notice_received

此作業會觸發每個交貨通知收據的流程

參數

名稱 機碼 必要 類型 Description
訂閱的帳戶 ID
 accountId True string

在大多數情況下，請使用根帳戶 ID 來訂閱通知。

傳回

名稱 路徑 類型 Description
回呼時間戳記
 CallbackTimestamp string

回呼的傳送日期和時間。 格式：yyyy-MM-ddTHH：mm：ss
回呼令牌
 CallbackToken string

回呼權杖
TransactionId
 TransactionId string

交易識別碼
帳戶ID
 AccountId integer

帳戶 ID
客戶名稱
 AccountName string

回呼與之關聯的帳戶名稱
狀態識別碼
 StatusId integer

2 = 已交付;3 = 未送達;7 = 未知
地位
 Status string

傳遞代碼 — 已傳遞的訊息或錯誤代碼確定。 對於未傳遞 - null
通道標識
 ChannelId integer

管道識別碼
通道代碼
 ChannelCode string

訊息傳送通道的代碼（長代碼的實際電話號碼）
訊息標識符
 MessageId string

訊息標識符
電話號碼
 PhoneNumber string

電話號碼
聯絡人識別碼
 ContactId integer

聯絡人 ID
動作標識符
 ActionId integer

動作識別碼
Message
 Message string

實際訊息文字

收到關鍵字

作業識別碼：
Keyword_received

每當使用者在關鍵字中輸入文字時，此作業都會觸發流程

參數

名稱 機碼 必要 類型 Description
訂閱的帳戶 ID
 accountId True string

在大多數情況下，請使用根帳戶 ID 來訂閱通知。

傳回

名稱 路徑 類型 Description
回呼時間戳記
 CallbackTimestamp string

回呼傳送的日期和時間格式：yyyy-MM-ddTHH：mm：ss
回呼令牌
 CallbackToken string

回呼權杖
TransactionId
 TransactionId string

交易識別碼
帳戶ID
 AccountId integer

回呼與之相關聯的帳戶 ID
客戶名稱
 AccountName string

回呼與之關聯的帳戶名稱
CampaignId
 CampaignId integer

行銷活動ID
通道標識
 ChannelId integer

管道識別碼
通道代碼
 ChannelCode string

訊息傳送通道的代碼（長代碼的實際電話號碼）
聯絡人識別碼
 ContactId integer

提交關鍵字的聯絡人 ID
Keyword
 Keyword string

實際已提交的關鍵字
關鍵字標識符
 KeywordId integer

已提交關鍵字的ID
Message
 Message string

實際訊息文字
電話號碼
 PhoneNumber string

提交關鍵字之最終使用者的電話號碼

無效目標

作業識別碼：
Invalid_Targets

如果在傳送SMS期間篩選出目標，則此作業會觸發流程

參數

名稱 機碼 必要 類型 Description
訂閱的帳戶 ID
 accountId True string

在大多數情況下，請使用根帳戶 ID 來訂閱通知。

傳回

名稱 路徑 類型 Description
回呼時間戳記
 CallbackTimestamp string

回呼的傳送日期和時間。 格式：yyyy-MM-ddTHH：mm：ss
回呼URL
 CallbackURL string

回呼 URL
TransactionId
 TransactionId string

交易識別碼
帳戶ID
 AccountId integer

帳戶 ID
動作標識符
 ActionId integer

動作識別碼
運行標識
 RunId integer

執行標識符
無效目標
 InvalidTargets array of object

無效目標
標的
 InvalidTargets.Target string

已篩選出的目標
原因標識符
 InvalidTargets.ReasonId integer

原因的 ID。 0 - 無效、1 - 選擇退出、2 - 重複、3 - 封鎖、4 - 無法遞送、5 - 一次性使用
原因
 InvalidTargets.Reason string

原因的簡短描述

定義

帳戶回應

名稱 路徑 類型 Description
識別碼
 id integer

帳戶的 ID。
狀態
 status integer

帳戶的目前狀態。
parentId
 parentId integer

此帳戶父項的帳戶識別碼。
名稱
 name string

帳戶的名稱
創建
 created string

建立帳戶的時間。
允許回呼
 allowCallback boolean

設定是否允許此帳戶使用回呼機制。
callbackToken
 callbackToken string

回呼權杖
型別
 type integer

帳戶類型（主帳戶或子帳戶）
accountType 帳戶類型
 accountType integer

帳戶類型名稱
已核准
 isApproved boolean

帳戶是否已批准

聯絡回應

名稱 路徑 類型 Description
accountId
 accountId integer

帳戶 ID
電話號碼
 phoneNumber string

電話號碼
電子郵件
 email string

電子郵件
preferredLanguageId
 preferredLanguageId string

偏好的語言識別碼
偏好語言
 preferredLanguage string

首選語言
assignedId
 assignedId string

指派的標識符
名字
 firstName string

名字
lastName
 lastName string

姓氏
phoneStatusId
 phoneStatusId integer

電話狀態標識碼
電話狀態
 phoneStatus integer

電話狀態
phoneHardErrorCount
 phoneHardErrorCount integer

phone 硬錯誤計數
phoneSoftErrorCount
 phoneSoftErrorCount integer

電話軟錯誤計數
phoneTotalHardErrorCount
 phoneTotalHardErrorCount integer

phone 總硬錯誤數
phoneTotalSoftErrorCount
 phoneTotalSoftErrorCount integer

phone 軟錯誤總計數
phoneLastHardError
 phoneLastHardError string

phone 上次硬錯誤
phoneLastSoft錯誤
 phoneLastSoftError string

phone 上次軟錯誤
phoneHardError自
 phoneHardErrorSince string

手機硬錯誤
phoneSoftError自
 phoneSoftErrorSince string

手機軟錯誤
狀態標識符
 statusId integer

狀態識別碼
創建
 created string

創建
modified
 modified string

modified
由...創建
 createdBy string

創建者
修改者
 modifiedBy string

修改者
識別碼
 id integer

識別碼

聯絡搜尋請求

名稱 路徑 類型 Description
識別碼
 id integer

識別碼
accountId
 accountId integer

帳戶 ID
狀態標識符
 statusId integer

狀態識別碼
電話號碼
 phoneNumber string

電話號碼
電子郵件
 email string

電子郵件
assignedId
 assignedId string

指派的標識符
名字
 firstName string

名字
lastName
 lastName string

姓氏
subscriptions
 subscriptions array of

subscriptions
attributes
 attributes array of

attributes
phoneStatusId
 phoneStatusId integer

電話狀態標識碼
創建
 created string

創建
由...創建
 createdBy string

創建者
modified
 modified string

modified
修改者
 modifiedBy string

修改者

PushCampaign回應

名稱 路徑 類型 Description
通道
 channels array of

通道
targets
 targets array of string

targets
targetsUrl
 targetsUrl string

目標網址
targetsColumn
 targetsColumn string

targets 欄
contactListIds
 contactListIds array of

聯絡人清單ID
excludeListIds
 excludeListIds array of

排除清單識別碼
campaignId
 campaignId integer

行銷活動ID
媒體標識符
 mediaId string

媒體 ID
訊息
 message string

訊息
從
 from string

從
主題
 subject string

主題
忽略SingleUse
 ignoreSingleUse boolean

忽略一次性使用
強制選擇
 forceOptIn boolean

強制 Opt-In
狀態標識符
 statusId integer

狀態識別碼
roundRobinById
 roundRobinById boolean

循環 ID
globalRoundRobin
 globalRoundRobin boolean

全球循環賽
狀態
 status string

狀態
識別碼
 id integer

識別碼
accountId
 accountId integer

帳戶 ID
創建
 created string

創建
modified
 modified string

modified
由...創建
 createdBy string

創建者
修改者
 modifiedBy string

修改者
schedules
 schedules array of

schedules

使用者回應

名稱 路徑 類型 Description
使用者名稱
 userName string

使用者名稱
accountId
 accountId integer

帳戶 ID
電子郵件
 email string

電子郵件
名字
 firstName string

名字
lastName
 lastName string

姓氏
電話號碼
 phoneNumber string

電話號碼
isAdmin
 isAdmin boolean

是管理員
Key
 apiKey.key string

Key
密碼
 apiKey.secret string

密碼
lastActivity
 apiKey.lastActivity string

上一篇活動
類型Id
 apiKey.typeId integer

類型標識符
型別
 apiKey.type integer

型別
標籤
 apiKey.label string

標籤
使用者名稱
 apiKey.userName string

使用者名稱
validTo
 apiKey.validTo string

有效至
accountId
 apiKey.accountId integer

帳戶 ID
識別碼
 apiKey.id integer

識別碼
isChat用戶
 isChatUser boolean

是聊天用戶
僅報告
 reportOnly boolean

僅報告
請求編號
 requestNumber boolean

請求編號
canCreateContact
 canCreateContact boolean

可以建立聯絡人
isAlertAgent
 isAlertAgent boolean

是警示代理程式
同意
 agreed boolean

同意
留言
 comment string

留言
已核准
 isApproved boolean

已核准
是鎖定
 isLockedOut boolean

被鎖定
lastLockoutDate
 lastLockoutDate string

上次鎖定日期
創建日期
 creationDate string

創建日期
last登入日期
 lastLoginDate string

最後登入日期
last活動日期
 lastActivityDate string

最後活動日期
lastPasswordChangedDate
 lastPasswordChangedDate string

最後密碼變更日期