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 キーとシークレット コードが資格情報メールに記載されます。 開始のヘルプについては、私たちのチームにお問い合わせください。 私たちのワールドクラスのクライアント サービスチームは、あなたの会社のニーズに最適なアカウントの登録と選択について説明します。
お問い合わせ:
support@truedialog.com | |
---|---|
ライブ チャット | https://www.truedialog.com/ |
電話番号 | 512-501-5940 |
資格情報を取得したら、コネクタの使用を開始できます。
最も価値のあるアクションは "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 をひとり、または複数の受信者に送信する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
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
|
accountId | True | string |
取引先企業 ID |
戻り値
- Body
- AccountResponse
連絡先の更新
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Account ID
|
accountId | True | string |
更新された連絡先の取引先企業の親会社として使用されるアカウント ID |
連絡先 ID
|
contactid | True | string |
更新される取引先担当者の ID |
PhoneNumber
|
PhoneNumber | string |
利用可能な場合は携帯電話番号。 これまたは Email フィールドのいずれかが必要です |
|
メール
|
string |
取引先担当者のメール アドレスです。 これまたは PhoneNumber フィールドのいずれかが必要です |
||
FirstName
|
FirstName | string |
取引先担当者の名前です。 |
|
LastName
|
LastName | string |
取引先担当者の苗字です。 |
戻り値
- Body
- ContactResponse
電話番号またはメール アドレスを介して取引先担当者を検索します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Account ID for subscription
|
accountId | True | string |
連絡先が表示されるアカウント。 |
Phone number to search
|
phone | True | string |
パスされた電話番号またはメールで既存の連絡先を検索します。 |
戻り値
- Items
- ContactSearchRequest
TrueDialog で取引先担当者レコードを作成します
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Account ID
|
accountId | True | string |
作成された連絡先の取引先企業の親会社として使用されるアカウント ID |
PhoneNumber
|
PhoneNumber | string |
利用可能な場合は携帯電話番号。 これまたは Email フィールドのいずれかが必要です |
|
メール
|
string |
取引先担当者のメール アドレスです。 これまたは PhoneNumber フィールドのいずれかが必要です |
||
FirstName
|
FirstName | string |
取引先担当者の名前です。 |
|
LastName
|
LastName | string |
取引先担当者の苗字です。 |
戻り値
- Body
- ContactResponse
受け取ったキーワード |
この操作は、エンドユーザーがキーワードでテキストを送信するたびにフローをトリガーします |
受け取ったメッセージの停止 |
この操作は、エンドユーザーが 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 |
実際のメッセージのテキスト |
名前 | パス | 型 | 説明 |
---|---|---|---|
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 |
アカウントが承認されているかどうか |
名前 | パス | 型 | 説明 |
---|---|---|---|
accountId
|
accountId | integer |
取引先企業 ID |
phoneNumber
|
phoneNumber | string |
Phone Number |
email
|
string |
|
|
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 |
名前 | パス | 型 | 説明 |
---|---|---|---|
id
|
id | integer |
id |
accountId
|
accountId | integer |
取引先企業 ID |
statusId
|
statusId | integer |
状態 ID |
phoneNumber
|
phoneNumber | string |
Phone Number |
email
|
string |
|
|
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 |
更新者 |
名前 | パス | 型 | 説明 |
---|---|---|---|
チャネル
|
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 |
スケジュール |
名前 | パス | 型 | 説明 |
---|---|---|---|
userName
|
userName | string |
userName |
accountId
|
accountId | integer |
取引先企業 ID |
email
|
string |
|
|
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 |
パスワードを最後に変更した日付 |