次の方法で共有


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 の送信

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

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

戻り値

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

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

パラメーター

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

取引先企業 ID

戻り値

取引先担当者の更新

連絡先の更新

パラメーター

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

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

連絡先 ID
contactid True string

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

PhoneNumber
PhoneNumber string

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

メール
Email string

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

FirstName
FirstName string

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

LastName
LastName string

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

戻り値

取引先担当者の検索

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

パラメーター

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

連絡先が表示されるアカウント。

Phone number to search
phone True string

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

戻り値

取引先担当者を作成

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

パラメーター

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

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

PhoneNumber
PhoneNumber string

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

メール
Email string

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

FirstName
FirstName string

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

LastName
LastName string

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

戻り値

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

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

戻り値

トリガー

受け取ったキーワード

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

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

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

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

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

無効なターゲット

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

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

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

受け取ったキーワード

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

パラメーター

名前 キー 必須 説明
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

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

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

この操作は、エンドユーザーが 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

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

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

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

パラメーター

名前 キー 必須 説明
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

一意のトークン

無効なターゲット

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

理由の短い説明

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

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

パラメーター

名前 キー 必須 説明
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

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