boomapp connect
「インテリジェント」なグローバル双方向、電子メール、音声、SMS、プッシュ メッセージング。 boomapp connect を使用して Power Platform アプリケーションを促進し、真に自動化されたマルチチャネル会話型コミュニケーション通信ワークフローを構築します (情報カテゴリ別で一意に駆動されます)。 受信者の応答に基づく完全に対話型通信ワークフローにより、エンゲージメントを通じて動作変更を強制することなく、シームレスでスムーズな対話を実現できます。 詳細および無料試用版アカウントの設定については、当社の Web サイトを参照してください。
このコネクタは、次の製品および地域で利用可能です。
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure China の地域 |
| Power Automate | Premium | 以下を除くすべての Power Automate 地域 : - 21 Vianet が運用する中国のクラウド |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 21 Vianet が運用する中国のクラウド |
| お問い合わせ先 | |
|---|---|
| 件名 | Boomerang サポート |
| [URL] | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| メール | support@boomcomms.com |
| Connector Metadata | |
|---|---|
| 発行者 | Boomerang I-Comms Ltd |
| Web サイト | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| プライバシー ポリシー | https://boomerangmessaging.com/privacy/ |
| カテゴリ | 通信; 生産性 |
前提条件
続行するには、次のものが必要です:
- カスタム コネクタ機能を備えた Microsoft Power Automate プラン
- Boomerang サブスクリプション
- Boomerang API 認証の詳細。
Boomerang でアカウントを作成する
- Web サイト - Boomerang アカウントの作成方法の詳細。
サポートとドキュメント:
ここ でドキュメントを確認できます。
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | 内容 | 必要 |
|---|---|---|---|
| ユーザー名 | securestring | この API のユーザー名 | 真 |
| パスワード | securestring | この API のパスワード | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| SMS カスタム番号 |
SMS メッセージは、要求で指定された番号を使用して配信されるため、応答はその番号に返されます。 Boomerang のキャンペーン機能を使用している顧客は、キャンペーンに関連付けられた番号を使用できます。これにより、Boomerang UI 内のキャンペーン レポート セクションから受信用返信にアクセスできます。 ただし、SMS 双方向メソッドとは異なり、返信は送信メッセージに対して追跡されません。 詳細については、https://boomerangmessaging.com/docs/sending-sms-messages を参照してください。 |
| SMS 一方向 |
SMS メッセージは、最大 11 文字を含む必要がある英数字の発信元 (会社名など) を使用して配信され、受信者は英数字の発信元を使用して送信されたメッセージに応答できません。 また、(地域の制限により) 英数字の発信者を使用したメッセージの配信がサポートされていない宛先では、メッセージが確実に配信されるように、これを数字の発信者に置き換えることができることに注意してください。 |
| SMS 双方向 |
この方法では、返信を各送信トランザクションに対して直接追跡でき、システムとエンド ユーザー間の会話を管理するために使用されます。 返信はメール アドレスに転送でき、Boommail を使用している顧客は email-2-SMS メッセージを応答者に送り返すことができます。 双方向および会話型メッセージングの詳細については、https://boomerangmessaging.com/docs/sending-sms-messages を参照してください。 |
| 電子メール |
単一または一括のメール メッセージを送信します。 電子メールはドメイン @boomerangui.com から送信され、件名をカスタマイズして「差出人」アドレスを上書きすることができます。 メール アドレスや URL に応答を転送することも可能 |
| 音声 |
固定番号は、音声合成 (TTS) 音声通話の発信元として使用されます。 キーストローク「1」および「2」はメッセージを受け入れるか拒否するために使用され、「9」は通話をリダイレクトするために使用されます。 詳細については、https://boomerangmessaging.com/docs/sending-delivering-voice-messages を参照 |
SMS カスタム番号
SMS メッセージは、要求で指定された番号を使用して配信されるため、応答はその番号に返されます。 Boomerang のキャンペーン機能を使用している顧客は、キャンペーンに関連付けられた番号を使用できます。これにより、Boomerang UI 内のキャンペーン レポート セクションから受信用返信にアクセスできます。 ただし、SMS 双方向メソッドとは異なり、返信は送信メッセージに対して追跡されません。 詳細については、https://boomerangmessaging.com/docs/sending-sms-messages を参照してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
開始
|
from | string |
メッセージに関連付けられている送信 ID は、現在有効なキャンペーンに関連付けられているインバウンド キャンペーン番号である可能性があります。 |
|
|
message_content
|
message_content | string |
すべての recipientAddresses に送信される送信メッセージのコンテンツ。 |
|
|
受信者の宛先アドレス
|
number | string |
受信者の宛先アドレス。最小 11 桁 (+ または先頭の「0」を除く) および最大 16 桁 (番号自体のプレフィックスとして使用される + を除く) を含む必要がある携帯電話番号。 単一の番号または最大 10,000 個の番号の配列を渡すことができます。 |
|
|
優先度
|
priority | boolean |
メッセージに優先度ステータスを設定するために使用されるオプションのパラメーター。 「優先度」で送信されたメッセージは、アカウントに対して設定された「ソーシャル時間」を上書きします。 True を渡すと、優先度が設定されます。 |
|
|
unique_identifier
|
unique_identifier | string |
各トランザクションの一意の識別子。 これは、メッセージの重複を防ぐために使用されます。Boomerang が、以前に使用された ID を持つトランザクションをすべて無視するためです。 |
|
|
campaign_name
|
campaign_name | string |
特定のキャンペーンおよびバッチ メッセージごとにメッセージをグループ化するために使用できるオプションの識別子。 |
|
|
custom_parameter
|
custom_parameter | string |
カスタム参照に使用されるパラメーター。 これは、たとえば、キャンペーン参照、ジョブ参照、バッチ ID などとして使用できます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
status | integer |
状態 |
|
メッセージ
|
message | string |
メッセージ |
|
取引
|
transactions | array of object |
取引 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
SMS 一方向
SMS メッセージは、最大 11 文字を含む必要がある英数字の発信元 (会社名など) を使用して配信され、受信者は英数字の発信元を使用して送信されたメッセージに応答できません。 また、(地域の制限により) 英数字の発信者を使用したメッセージの配信がサポートされていない宛先では、メッセージが確実に配信されるように、これを数字の発信者に置き換えることができることに注意してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
開始
|
from | string |
一方向メッセージの発信元 ID。 最大 11 文字を含む英数字の値。 |
|
|
message_content
|
message_content | string |
すべての recipientAddresses に送信される送信メッセージのコンテンツ。 |
|
|
受信者の宛先アドレス
|
number | string |
受信者の宛先アドレス。最小 11 桁 (+ または先頭の「0」を除く) および最大 16 桁 (番号自体のプレフィックスとして使用される + を除く) を含む必要がある携帯電話番号。 単一の番号または最大 10,000 個の番号の配列を渡すことができます。 |
|
|
優先度
|
priority | boolean |
メッセージに優先度ステータスを設定するために使用されるオプションのパラメーター。 「優先度」で送信されたメッセージは、アカウントに対して設定された「ソーシャル時間」を上書きします。 True を渡すと、優先度が設定されます。 |
|
|
unique_identifier
|
unique_identifier | string |
各トランザクションの一意の識別子。 これは、メッセージの重複を防ぐために使用されます。Boomerang が、以前に使用された ID を持つトランザクションをすべて無視するためです。 |
|
|
campaign_name
|
campaign_name | string |
特定のキャンペーンおよびバッチ メッセージごとにメッセージをグループ化するために使用できるオプションの識別子。 |
|
|
custom_parameter
|
custom_parameter | string |
カスタム参照に使用されるパラメーター。 これは、たとえば、キャンペーン参照、ジョブ参照、バッチ ID などとして使用できます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
status | integer |
状態 |
|
メッセージ
|
message | string |
メッセージ |
|
取引
|
transactions | array of object |
取引 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
SMS 双方向
この方法では、返信を各送信トランザクションに対して直接追跡でき、システムとエンド ユーザー間の会話を管理するために使用されます。 返信はメール アドレスに転送でき、Boommail を使用している顧客は email-2-SMS メッセージを応答者に送り返すことができます。 双方向および会話型メッセージングの詳細については、https://boomerangmessaging.com/docs/sending-sms-messages を参照してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
conversation_id
|
conversation_id | string |
同じ会話の一部であるすべてのメッセージ (返信を含む) をグループ化するための会話 ID を定義する |
|
|
message_content
|
message_content | string |
すべての recipientAddresses に送信される送信メッセージのコンテンツ。 |
|
|
受信者の宛先アドレス
|
number | string |
受信者の宛先アドレス。最小 11 桁 (+ または先頭の「0」を除く) および最大 16 桁 (番号自体のプレフィックスとして使用される + を除く) を含む必要がある携帯電話番号。 単一の番号または最大 10,000 個の番号の配列を渡すことができます。 |
|
|
validity_period
|
validity_period | integer |
メッセージの送信に使用された番号が有効になる期間。 有効期間が終了すると、メッセージへの返信は配信されません。 双方向メッセージの場合、最小有効期間は 1 日です。 |
|
|
open_ticket
|
open_ticket | boolean |
既定では、すべてのメッセージに単一のチケットが送信されます。これは、最初の応答を受信するとメッセージが閉じられることを意味します。 同じ元のメッセージに対する複数の応答を照合するには、true を渡してオープン チケットを使用します。 |
|
|
email_responses
|
email_responses | string |
メッセージ応答の転送先のメール アドレス。 |
|
|
push_responses
|
push_responses | string |
メッセージ応答が投稿されるコールバック URL。 |
|
|
優先度
|
priority | boolean |
メッセージに優先度ステータスを設定するために使用されるオプションのパラメーター。 「優先度」で送信されたメッセージは、アカウントに対して設定された「ソーシャル時間」を上書きします。 True を渡すと、優先度が設定されます。 |
|
|
unique_identifier
|
unique_identifier | string |
各トランザクションの一意の識別子。 これは、メッセージの重複を防ぐために使用されます。Boomerang が、以前に使用された ID を持つトランザクションをすべて無視するためです。 |
|
|
campaign_name
|
campaign_name | string |
特定のキャンペーンおよびバッチ メッセージごとにメッセージをグループ化するために使用できるオプションの識別子。 |
|
|
custom_parameter
|
custom_parameter | string |
カスタム参照に使用されるパラメーター。 これは、たとえば、キャンペーン参照、ジョブ参照、バッチ ID などとして使用できます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
status | integer |
状態 |
|
メッセージ
|
message | string |
メッセージ |
|
取引
|
transactions | array of object |
取引 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
電子メール
単一または一括のメール メッセージを送信します。 電子メールはドメイン @boomerangui.com から送信され、件名をカスタマイズして「差出人」アドレスを上書きすることができます。 メール アドレスや URL に応答を転送することも可能
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
開始
|
from | string |
差出人アドレスとして使用するコンテンツを渡します。 空白の場合、既定値はアカウント設定から取得される |
|
|
email_subject
|
email_subject | string |
受信者の受信トレイでメールを受信したときに既定で表示される件名 |
|
|
message_content
|
message_content | string |
すべての recipientAddresses に送信される送信メッセージのコンテンツ。 |
|
|
email_address
|
email_address | array of string |
email_address |
|
|
validity_period
|
validity_period | integer |
メッセージの送信に使用された番号が有効になる期間。 有効期間が終了すると、メッセージへの返信は配信されません。 双方向メッセージの場合、最小有効期間は 1 日です。 |
|
|
open_ticket
|
open_ticket | boolean |
既定では、すべてのメッセージに単一のチケットが送信されます。これは、最初の応答を受信するとメッセージが閉じられることを意味します。 同じ元のメッセージに対する複数の応答を照合するには、true を渡してオープン チケットを使用します。 |
|
|
email_responses
|
email_responses | string |
メッセージ応答の転送先のメール アドレス。 |
|
|
push_responses
|
push_responses | string |
メッセージ応答が投稿されるコールバック URL。 |
|
|
unique_identifier
|
unique_identifier | string |
各トランザクションの一意の識別子。 これは、メッセージの重複を防ぐために使用されます。Boomerang が、以前に使用された ID を持つトランザクションをすべて無視するためです。 |
|
|
campaign_name
|
campaign_name | string |
特定のキャンペーンおよびバッチ メッセージごとにメッセージをグループ化するために使用できるオプションの識別子。 |
|
|
custom_parameter
|
custom_parameter | string |
カスタム参照に使用されるパラメーター。 これは、たとえば、キャンペーン参照、ジョブ参照、バッチ ID などとして使用できます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
status | integer |
状態 |
|
メッセージ
|
message | string |
メッセージ |
|
取引
|
transactions | array of object |
取引 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
email_address
|
transactions.email_address | string |
email_address |
音声
固定番号は、音声合成 (TTS) 音声通話の発信元として使用されます。 キーストローク「1」および「2」はメッセージを受け入れるか拒否するために使用され、「9」は通話をリダイレクトするために使用されます。 詳細については、https://boomerangmessaging.com/docs/sending-delivering-voice-messages を参照
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
voice_intro
|
voice_intro | string |
音声通話に応答したときに再生されるメッセージ。 メッセージの内容はその直後に再生されます。 |
|
|
voice_thank_you
|
voice_thank_you | string |
メッセージの内容が再生された後、音声通話の最後に再生されるメッセージ。 |
|
|
voice_redirect_message
|
voice_redirect_message | string |
メッセージの内容が再生された後、音声通話の最後に再生されるメッセージ。 |
|
|
数値
|
number | string |
リダイレクト番号 |
|
|
voice_retries
|
voice_retries | integer |
音声通話に最初に応答しなかった場合の試行回数。 |
|
|
voice_delay
|
voice_delay | integer |
再試行の間にシステムが待機した時間。 |
|
|
message_content
|
message_content | string |
すべての recipientAddresses に送信される送信メッセージのコンテンツ。 |
|
|
数値
|
number | string |
受信者の宛先アドレス。最小 11 桁 (+ または先頭の「0」を除く) および最大 16 桁 (番号自体のプレフィックスとして使用される + を除く) を含む必要がある携帯電話番号。 単一の番号または最大 10,000 個の番号の配列を渡すことができます。 |
|
|
優先度
|
priority | boolean |
メッセージに優先度ステータスを設定するために使用されるオプションのパラメーター。 「優先度」で送信されたメッセージは、アカウントに対して設定された「ソーシャル時間」を上書きします。 True を渡すと、優先度が設定されます。 |
|
|
unique_identifier
|
unique_identifier | string |
各トランザクションの一意の識別子。 これは、メッセージの重複を防ぐために使用されます。Boomerang が、以前に使用された ID を持つトランザクションをすべて無視するためです。 |
|
|
campaign_name
|
campaign_name | string |
特定のキャンペーンおよびバッチ メッセージごとにメッセージをグループ化するために使用できるオプションの識別子。 |
|
|
custom_parameter
|
custom_parameter | string |
カスタム参照に使用されるパラメーター。 これは、たとえば、キャンペーン参照、ジョブ参照、バッチ ID などとして使用できます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
status | integer |
状態 |
|
メッセージ
|
message | string |
メッセージ |
|
取引
|
transactions | array of object |
取引 |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
トリガー
| SMS 応答の送信について |
インテリジェントな双方向/会話型メッセージとして送信されると、関連する送信メッセージに自動的にマッピングされる受信応答によってトリガーされる |
| 配送確認済み |
エンド ユーザーの配信状態の更新によってトリガーされます。 エンド ユーザーのネットワーク オペレーターから返された配信状態でトランザクションを更新します。 詳細については、https://boomerangmessaging.com/docs を参照 |
SMS 応答の送信について
インテリジェントな双方向/会話型メッセージとして送信されると、関連する送信メッセージに自動的にマッピングされる受信応答によってトリガーされる
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
status | integer |
状態 |
|
メッセージ
|
message | string |
メッセージ |
|
has_more
|
has_more | boolean |
has_more |
|
返信
|
replies | array of object |
返信 |
|
transaction_id
|
replies.transaction_id | string |
transaction_id |
|
custom_parameter
|
replies.custom_parameter | string |
custom_parameter |
|
response_id
|
replies.response_id | string |
response_id |
|
開始
|
replies.from | string |
開始 |
|
response_content
|
replies.response_content | string |
response_content |
|
is_new
|
replies.is_new | boolean |
is_new |
|
transaction_date
|
replies.transaction_date | string |
transaction_date |
|
response_date
|
replies.response_date | string |
response_date |
配送確認済み
エンド ユーザーの配信状態の更新によってトリガーされます。 エンド ユーザーのネットワーク オペレーターから返された配信状態でトランザクションを更新します。 詳細については、https://boomerangmessaging.com/docs を参照
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
status | integer |
状態 |
|
メッセージ
|
message | string |
メッセージ |
|
has_more
|
has_more | boolean |
has_more |
|
drs
|
drs | array of object |
drs |
|
transaction_id
|
drs.transaction_id | string |
transaction_id |
|
状態
|
drs.status | string |
状態 |
|
status_date
|
drs.status_date | string |
status_date |
|
destination
|
drs.destination | string |
destination |
|
custom_parameter
|
drs.custom_parameter | string |
custom_parameter |
|
campaign_name
|
drs.campaign_name | string |
campaign_name |
|
unique_id
|
drs.unique_id | string |
unique_id |