TrueDialog SMS

  • リファレンス

TrueDialog SMS コネクタは、長いコードと短いコードを介して大量の個別のテキスト メッセージを送信する機能を提供します。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 TrueDialog サポート
[URL] https://www.truedialog.com/help/
メール support@truedialog.com
Connector Metadata
発行者 TrueDialog Dynamics
Web サイト https://www.truedialog.com/
プライバシー ポリシー https://www.truedialog.com/privacy-policy/
カテゴリー 通信

TrueDialog の SMS API はエンタープライズ グレードであり、他のどの SMS ソフトウェアよりも多くの機能が事前に構築されています。 開発者向けに構築された SMS API は、信頼性と安全性が高く、オプトアウトとコンプライアンス保護を強化するための構築済みの ISO 9001 データベースが含まれています。 フル機能のエンタープライズグレードの SMS テキスト メッセージ ソフトウェアからも入手できます。

前提条件

続行するには、これらの資格情報が必要です。

  • Microsoft Power Apps または Power Automate プラン
  • TrueDialog アカウントとプラン、アカウントの TrueDialog API キーとシークレット コード。 登録するには、こちら をクリックします。

資格情報の入手方法

登録するには、こちら をクリックします。 TrueDialog に登録すると、API キーとシークレット コードが資格情報メールに記載されます。 開始のヘルプについては、私たちのチームにお問い合わせください。 私たちのワールドクラスのクライアント サービスチームは、あなたの会社のニーズに最適なアカウントの登録と選択について説明します。

お問い合わせ:

email support@truedialog.com
ライブ チャット https://www.truedialog.com/
電話番号 512-501-5940

TrueDialog コネクタを開始する

資格情報を取得したら、コネクタの使用を開始できます。

アクション​​

SMS の送信

最も価値のあるアクションは "SMS の送信" です。 これにより、単一または複数の受信者に SMS を送信できます。 このアクションには、いくつかの必須フィールドがあります。

  • アカウントID – Get Current User Info 応答から使用することも、ハード コーディングすることもできます。
  • チャネル – 規定の関連付けられた電話番号を使用するために規定値 22 のままにします。
  • ターゲット – フォーマットなしの有効な米国の電話番号 (例: +15125453809)
  • メッセージ – メッセージ自体。
  • 実行–送信を延期したくない場合は、規定値を True のままにします。

トリガー

アカウントに登録されているコールバックのリストは、こちらにあります: https://ui.truedialog.com/Callbacks

受け取った受信メッセージ

最も重要なトリガー。 この操作は、エンドユーザーが関連する電話番号にテキストを送信するたびにフローをトリガーします。

トリガーを登録するには、アカウント ID が必要です。 アカウント ID は、右上隅のアカウント名の横にある TD ポータルから取得できます。

受信メッセージには、メッセージ テキストとその他の必要なフィールドが含まれています。

受け取ったメッセージの停止

この操作は、エンドユーザーが STOP または同義語でテキストを送信するたびにフローをトリガーします。 また、TrueDialog システムで連絡先を自動的にオプトアウトします。 オプトアウトされた連絡先にメッセージを送信するには、SMS を送信するときにフラグ forceOptIn を True に設定します。 この ForceOptIt 機能は注意して使用し、オプトアウトされたレコードを追跡するようにしてください。

コネクタの使用を開始するための段階的なプロセスをユーザーに提供します。 ここでは、予想される一般的なトリガーやアクションなどの一般的なユースケースと、それらが自動化シナリオでどのように役立つかを強調する必要があります。 可能な場合は画像を含めます。

配達通知を受け取りました

この操作により、配達通知の受領ごとにフローがトリガーされます。 すべての携帯電話会社が通知の領収書を送信するわけではないことに注意してください。

無効なターゲット

ターゲットの電話の 1 つが無効であるか、ブラックリストに登録されている場合でも、SMS を送信することは可能であり、エラーは発生しません。 これを行うには、メッセージを送信するときにプロパティ "IgnoreInvalidTargets" を true に設定する必要があります。 送信された SMS 受信者リストに無効な電話番号が表示された場合、この操作によりフローがトリガーされます。

既知の問題と制限事項

TrueDialog API には、カスタム コネクタと比較してより多くの機能があります

よくあるご質問

Undrlying API の最新の説明を取得するには、こちら の Web サイトにアクセスしてください

ここに、よくある質問とそれぞれの回答の詳細を示します。 これは、基盤となるサービスとの対話、またはコネクタ自体に関する FAQ をカバーできます。

接続の作成

コネクタは、次の認証タイプをサポートしています。
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

件名 タイプ 内容 必要
ユーザー名 securestring この API のユーザー名 真
パスワード securestring この API のパスワード True

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

SMS の送信

SMS をひとり、または複数の受信者に送信する
アカウント情報を取得する

アカウントに関する情報を取得する
取引先担当者の更新

連絡先の更新
取引先担当者の検索

電話番号またはメール アドレスを介して取引先担当者を検索します。
取引先担当者を作成

TrueDialog で取引先担当者レコードを作成します
現在のユーザー情報を取得する

接続でクレデンシャルが使用されたユーザーに関する情報を取得します

SMS の送信

操作 ID:
Campaign_Push

SMS をひとり、または複数の受信者に送信する

パラメーター

名前 キー 必須 型 説明
Account ID
 accountId True string

SMS の送信に使用されるアカウント ID
Channels
 Channels True array of string

Channels
Targets
 Targets True array of string

Targets
ContactListIds
 ContactListIds array of string

取引先担当者リスト ID
ExcludeListIds
 ExcludeListIds array of string

リスト ID を除外する
メディア ID
 MediaId integer

メディア ID
Message
 Message True string

Message
Ignore Single Use
 IgnoreSingleUse boolean

Ignore Single Use
ForceOptIn
 ForceOptIn boolean

オプトインを強要します
スケジュール
 Schedules array of string

アクションに関連付けられているスケジュールのリスト
実行
 Execute True boolean

アクションを作成時に実行する必要がある場合は true に設定します
IgnoreInvalidTargets
 IgnoreInvalidTargets boolean

無効な数値を無視する必要があるかどうかを示します

戻り値

Body
PushCampaignResponse

アカウント情報を取得する

操作 ID:
Account_Get_Info

アカウントに関する情報を取得する

パラメーター

名前 キー 必須 型 説明
取得する必要のあるアカウントの ID
 accountId True string

取引先企業 ID

戻り値

Body
AccountResponse

取引先担当者の更新

操作 ID:
Contact_Update

連絡先の更新

パラメーター

名前 キー 必須 型 説明
Account ID
 accountId True string

更新された連絡先の取引先企業の親会社として使用されるアカウント ID
連絡先 ID
 contactid True string

更新される取引先担当者の ID
PhoneNumber
 PhoneNumber string

利用可能な場合は携帯電話番号。 これまたは Email フィールドのいずれかが必要です
メール
 Email string

取引先担当者のメール アドレスです。 これまたは PhoneNumber フィールドのいずれかが必要です
FirstName
 FirstName string

取引先担当者の名前です。
LastName
 LastName string

取引先担当者の苗字です。

戻り値

Body
ContactResponse

取引先担当者の検索

操作 ID:
Contact_Search

電話番号またはメール アドレスを介して取引先担当者を検索します。

パラメーター

名前 キー 必須 型 説明
Account ID for subscription
 accountId True string

連絡先が表示されるアカウント。
Phone number to search
 phone True string

パスされた電話番号またはメールで既存の連絡先を検索します。

戻り値

Items
ContactSearchRequest

取引先担当者を作成

操作 ID:
Contact_Create

TrueDialog で取引先担当者レコードを作成します

パラメーター

名前 キー 必須 型 説明
Account ID
 accountId True string

作成された連絡先の取引先企業の親会社として使用されるアカウント ID
PhoneNumber
 PhoneNumber string

利用可能な場合は携帯電話番号。 これまたは Email フィールドのいずれかが必要です
メール
 Email string

取引先担当者のメール アドレスです。 これまたは PhoneNumber フィールドのいずれかが必要です
FirstName
 FirstName string

取引先担当者の名前です。
LastName
 LastName string

取引先担当者の苗字です。

戻り値

Body
ContactResponse

現在のユーザー情報を取得する

操作 ID:
User_Get_Self_Info

接続でクレデンシャルが使用されたユーザーに関する情報を取得します

戻り値

Body
UserResponse

トリガー

受け取ったキーワード

この操作は、エンドユーザーがキーワードでテキストを送信するたびにフローをトリガーします
受け取ったメッセージの停止

この操作は、エンドユーザーが STOP または同義語でテキストを送信するたびにフローをトリガーします
受け取った受信メッセージ

この操作は、エンドユーザーがテキストを送信するたびにフローをトリガーします
無効なターゲット

SMS の送信中にターゲットが除外された場合、この操作はフローをトリガーします
配達通知を受け取りました

この操作により、配達通知の受領ごとにフローがトリガーされます

受け取ったキーワード

操作 ID:
Keyword_received

この操作は、エンドユーザーがキーワードでテキストを送信するたびにフローをトリガーします

パラメーター

名前 キー 必須 型 説明
Account ID for subscription
 accountId True string

ほとんどの場合、ルート アカウント ID を使用して通知をサブスクライブします。

戻り値

名前 パス 型 説明
Callback Timestamp
 CallbackTimestamp string

コールバックが送信された日時。形式: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

コールバックのトークン
TransactionId
 TransactionId string

トランザクション ID
AccountId
 AccountId integer

コールバックが関連付けられているアカウントの ID
アカウント名
 AccountName string

コールバックが関連付けられているアカウントの名前
CampaignId
 CampaignId integer

キャンペーン ID
ChannelId
 ChannelId integer

チャネル ID
Channel Code
 ChannelCode string

メッセージが送信されたチャネルのコード (長いコードの実際の電話番号)
ContactId
 ContactId integer

キーワードを送信した連絡先の ID
キーワード
 Keyword string

提出された実際のキーワード
KeywordId
 KeywordId integer

提出されたキーワードの ID
Message
 Message string

実際のメッセージのテキスト
PhoneNumber
 PhoneNumber string

キーワードを送信したエンド ユーザーの電話番号

受け取ったメッセージの停止

操作 ID:
Stop_received

この操作は、エンドユーザーが STOP または同義語でテキストを送信するたびにフローをトリガーします

パラメーター

名前 キー 必須 型 説明
Account ID for subscription
 accountId True string

ほとんどの場合、ルート アカウント ID を使用して通知をサブスクライブします。

戻り値

名前 パス 型 説明
Callback Timestamp
 CallbackTimestamp string

コールバックが送信された日時。 形式: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

コールバックのトークン
TransactionId
 TransactionId string

トランザクション ID
AccountId
 AccountId integer

取引先企業 ID
アカウント名
 AccountName string

コールバックが関連付けられているアカウントの名前
ChannelId
 ChannelId integer

チャネル ID
Channel Code
 ChannelCode string

メッセージが送信されたチャネルのコード (長いコードの実際の電話番号)
ContactId
 ContactId integer

連絡先 ID
ContactAccountId
 ContactAccountId integer

連絡先レコードを所有するアカウントの ID
ContactAccountName
 ContactAccountName string

連絡先レコードを所有するアカウントの名前
PhoneNumber
 PhoneNumber string

オプトアウトされたエンド ユーザーの電話番号

受け取った受信メッセージ

操作 ID:
Incoming_SMS_Received

この操作は、エンドユーザーがテキストを送信するたびにフローをトリガーします

パラメーター

名前 キー 必須 型 説明
Account ID for subscription
 AccountId True string

ほとんどの場合、ルート アカウント ID を使用して通知をサブスクライブします。

戻り値

名前 パス 型 説明
アカウント名
 AccountName string

コールバックが関連付けられているアカウントの名前
Channel Code
 ChannelCode string

メッセージが送信されたチャネルのコード (長いコードの実際の電話番号)
ChannelId
 ChannelId integer

メッセージが送信されたチャネルの ID
ContactId
 ContactId integer

取引先担当者 ID (不明な連絡先の場合は null)
Message
 Message string

実際のメッセージのテキスト
PhoneNumber
 PhoneNumber string

ターゲットの電話番号
AccountId
 AccountId integer

コールバックが関連付けられているアカウントの ID
Callback Timestamp
 CallbackTimestamp string

コールバックが送信された日時。 形式: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

コールバックのトークン
TransactionId
 TransactionId string

一意のトークン

無効なターゲット

操作 ID:
Invalid_Targets

SMS の送信中にターゲットが除外された場合、この操作はフローをトリガーします

パラメーター

名前 キー 必須 型 説明
Account ID for subscription
 accountId True string

ほとんどの場合、ルート アカウント ID を使用して通知をサブスクライブします。

戻り値

名前 パス 型 説明
Callback Timestamp
 CallbackTimestamp string

コールバックが送信された日時。 形式: yyyy-MM-ddTHH:mm:ss
CallbackURL
 CallbackURL string

コールバック URL
TransactionId
 TransactionId string

トランザクション ID
AccountId
 AccountId integer

取引先企業 ID
ActionId
 ActionId integer

アクション ID
RunId
 RunId integer

実行 ID
InvalidTargets
 InvalidTargets array of object

無効なターゲット
Target
 InvalidTargets.Target string

除外されたターゲット
ReasonId
 InvalidTargets.ReasonId integer

理由の ID。 0 - 無効、1 - オプトアウト、2 - 重複、3 - ブロック、4 - 配信不能、5 - 使い捨て
Reason
 InvalidTargets.Reason string

理由の短い説明

配達通知を受け取りました

操作 ID:
Delivery_Notice_received

この操作により、配達通知の受領ごとにフローがトリガーされます

パラメーター

名前 キー 必須 型 説明
Account ID for subscription
 accountId True string

ほとんどの場合、ルート アカウント ID を使用して通知をサブスクライブします。

戻り値

名前 パス 型 説明
Callback Timestamp
 CallbackTimestamp string

コールバックが送信された日時。 形式: yyyy-MM-ddTHH:mm:ss
CallbackToken
 CallbackToken string

コールバックのトークン
TransactionId
 TransactionId string

トランザクション ID
AccountId
 AccountId integer

取引先企業 ID
アカウント名
 AccountName string

コールバックが関連付けられているアカウントの名前
状態 ID
 StatusId integer

2 = 配信済み; 3 = 未配達; 7 = 不明
Status
 Status string

配信コード - 配信されたメッセージは OK またはエラーコード。 未配信の場合 - null
ChannelId
 ChannelId integer

チャネル ID
チャネル コード
 ChannelCode string

メッセージが送信されたチャネルのコード (長いコードの実際の電話番号)
MessageId
 MessageId string

MessageId
PhoneNumber
 PhoneNumber string

Phone Number
ContactId
 ContactId integer

連絡先 ID
ActionId
 ActionId integer

アクション ID
Message
 Message string

実際のメッセージのテキスト

定義

AccountResponse

名前 パス 型 説明
id
 id integer

アカウントの ID。
ステータス
 status integer

アカウントの現在の状態。
parentId
 parentId integer

このアカウントの親であるアカウントの識別子。
名称
 name string

アカウントの名前
created
 created string

アカウントが作成された時。
allowCallback
 allowCallback boolean

このアカウントがコールバック メカニズムの使用を許可されているかどうかを設定します。
callbackToken
 callbackToken string

コールバックのトークン
タイプ
 type integer

アカウント タイプ (マスターまたはサブアカウント)
accountType
 accountType integer

アカウント タイプ名
isApproved
 isApproved boolean

アカウントが承認されているかどうか

ContactResponse

名前 パス 型 説明
accountId
 accountId integer

取引先企業 ID
phoneNumber
 phoneNumber string

Phone Number
email
 email string

email
preferredLanguageId
 preferredLanguageId string

優先する言語 ID
preferredLanguage
 preferredLanguage string

優先する言語
assignedId
 assignedId string

割り当 ID
firstName
 firstName string

First Name
lastName
 lastName string

Last Name
phoneStatusId
 phoneStatusId integer

電話の状態 ID
phoneStatus
 phoneStatus integer

電話の状態
phoneHardErrorCount
 phoneHardErrorCount integer

電話のハード エラー カウント
phoneSoftErrorCount
 phoneSoftErrorCount integer

電話のソフト エラー数
phoneTotalHardErrorCount
 phoneTotalHardErrorCount integer

電話のハード エラー総数
phoneTotalSoftErrorCount
 phoneTotalSoftErrorCount integer

電話のソフト エラー総数
phoneLastHardError
 phoneLastHardError string

電話の最後のハード エラー
phoneLastSoftError
 phoneLastSoftError string

電話の最後のソフト エラー
phoneHardErrorSince
 phoneHardErrorSince string

電話のハード エラー以降
phoneSoftErrorSince
 phoneSoftErrorSince string

電話のソフト エラー以降
statusId
 statusId integer

状態 ID
created
 created string

created
修正日
 modified string

修正日
createdBy
 createdBy string

作成者
modifiedBy
 modifiedBy string

更新者
id
 id integer

id

ContactSearchRequest

名前 パス 型 説明
id
 id integer

id
accountId
 accountId integer

取引先企業 ID
statusId
 statusId integer

状態 ID
phoneNumber
 phoneNumber string

Phone Number
email
 email string

email
assignedId
 assignedId string

割り当 ID
firstName
 firstName string

First Name
lastName
 lastName string

Last Name
サブスクリプション
 subscriptions array of

サブスクリプション
attributes
 attributes array of

attributes
phoneStatusId
 phoneStatusId integer

電話の状態 ID
created
 created string

created
createdBy
 createdBy string

作成者
修正日
 modified string

修正日
modifiedBy
 modifiedBy string

更新者

PushCampaignResponse

名前 パス 型 説明
チャネル
 channels array of

チャネル
対象
 targets array of string

対象
targetsUrl
 targetsUrl string

ターゲット Url
targetsColumn
 targetsColumn string

ターゲット列
contactListIds
 contactListIds array of

取引先担当者リスト ID
excludeListIds
 excludeListIds array of

リスト ID を除外する
campaignId
 campaignId integer

キャンペーン ID
mediaId
 mediaId string

メディア ID
message
 message string

message
送信元
 from string

送信元
件名
 subject string

件名
ignoreSingleUse
 ignoreSingleUse boolean

単一使用を無視
forceOptIn
 forceOptIn boolean

オプトインを強要
statusId
 statusId integer

状態 ID
roundRobinById
 roundRobinById boolean

ID 別ラウンド ロビン
globalRoundRobin
 globalRoundRobin boolean

グローバル ラウンド ロビン
ステータス
 status string

ステータス
id
 id integer

id
accountId
 accountId integer

取引先企業 ID
created
 created string

created
修正日
 modified string

修正日
createdBy
 createdBy string

作成者
modifiedBy
 modifiedBy string

更新者
schedules
 schedules array of

スケジュール

UserResponse

名前 パス 型 説明
userName
 userName string

userName
accountId
 accountId integer

取引先企業 ID
email
 email string

email
firstName
 firstName string

First Name
lastName
 lastName string

Last Name
phoneNumber
 phoneNumber string

Phone Number
isAdmin
 isAdmin boolean

is Admin
key
 apiKey.key string

key
シークレット
 apiKey.secret string

シークレット
lastActivity
 apiKey.lastActivity string

前回の活動
typeId
 apiKey.typeId integer

タイプ ID
タイプ
 apiKey.type integer

タイプ
label
 apiKey.label string

label
userName
 apiKey.userName string

userName
validTo
 apiKey.validTo string

有効期限
accountId
 apiKey.accountId integer

取引先企業 ID
id
 apiKey.id integer

id
isChatUser
 isChatUser boolean

はチャット ユーザー
reportOnly
 reportOnly boolean

レポートのみ
requestNumber
 requestNumber boolean

要求番号
canCreateContact
 canCreateContact boolean

取引先担当者を作成可能
isAlertAgent
 isAlertAgent boolean

はアラート エージェント
agreed
 agreed boolean

同意
コメント
 comment string

コメント
isApproved
 isApproved boolean

は承認済み
isLockedOut
 isLockedOut boolean

はロック アウト
lastLockoutDate
 lastLockoutDate string

最近のロックアウト日
creationDate
 creationDate string

作成日
lastLoginDate
 lastLoginDate string

前回ログイン日
lastActivityDate
 lastActivityDate string

最後の活動の日付
lastPasswordChangedDate
 lastPasswordChangedDate string

パスワードを最後に変更した日付