boomapp connect
"インテリジェント" グローバル 2 ウェイ、電子メール、音声、SMS、プッシュ メッセージング。 boomapp 接続を使用して Power Platform アプリケーションをスーパーチャージし、真に自動化されたマルチチャネルの会話通信ワークフローを構築します (件名によって一意に駆動されます)。 受信者の応答に基づく完全にインタラクティブな通信ワークフローにより、エンゲージメントを通じて行動の変化を強制することなく、シームレスで摩擦のない相互作用を実現できます。 詳細および無料試用版アカウントの設定については、当社のウェブサイトをご覧ください。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure China リージョン |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 21Vianet が運営する China Cloud |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 21Vianet が運営する China Cloud |
| お問い合わせ | |
|---|---|
| 名前 | Boomerang のサポート |
| URL | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| support@boomcomms.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | ブーメランアイコムス株式会社 |
| Website | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| プライバシー ポリシー | https://boomerangmessaging.com/privacy/ |
| カテゴリ | 通信;生産性 |
前提条件
続行するには、次のものが必要です。
- カスタム コネクタ機能を備えた Microsoft Power Automate プラン
- Boomerang サブスクリプション
- Boomerang API 認証の詳細。
Boomerang でアカウントを作成する
- web サイト - Boomerang アカウントを作成する方法の詳細。
サポートとドキュメント:
ドキュメントは こちらをご覧ください。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| ユーザー名 | securestring | この API のユーザー名 | 正しい |
| パスワード | securestring | この API のパスワード | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
|
単一メール メッセージまたは一括メール メッセージを送信します。 メールはドメイン @boomerangui.com から送信され、件名をカスタマイズしたり、[差出人] アドレスをオーバーライドしたりできます。 電子メール アドレスや URL に応答を転送することもできます。 |
|
| Sms の一方向 |
SMS メッセージは、最大 11 文字を含む必要がある英数字の発信元 (会社名など) を使用して配信され、受信者は英数字発信元を使用して送信されたメッセージに応答できません。 また、英数字の送信元を含むメッセージの配信がサポートされていない宛先では (ローカルの制限により)、メッセージが確実に配信されるように、これは数値の発信元に置き換えられる可能性があることに注意してください。 |
| SMS カスタム番号 |
SMS メッセージは、要求で指定された番号を使用して配信されるため、すべての応答がその番号に返されます。 Boomerang のキャンペーン機能を使用しているお客様は、キャンペーンに関連付けられている番号を使用できます。これにより、Boomerang UI 内のキャンペーン レポート セクションから受信応答にアクセスできます。 ただし、SMS 2 方向の方法とは異なり、応答は送信メッセージに対して追跡されません。 詳細については、https://boomerangmessaging.com/docs/sending-sms-messages を参照してください。 |
| Sms 双方向 |
このメソッドを使用すると、各送信トランザクションに対して直接応答を追跡でき、システムとエンド ユーザー間の会話を管理するために使用されます。 返信はメール アドレスに転送でき、Boommail を使用しているお客様は電子メール 2-SMS メッセージをレスポンダーに送り返すことができます。 双方向メッセージングと会話型メッセージングの詳細については、 https://boomerangmessaging.com/docs/sending-sms-messagesを参照してください。 |
| Voice |
固定番号は、Text-To-Speech (TTS) 音声通話の発信者として使用されます。 キーストローク '1' と '2' はメッセージの受け入れまたは拒否に使用され、'9' は呼び出しをリダイレクトするために使用されます。 詳細については、 https://boomerangmessaging.com/docs/sending-delivering-voice-messages を参照してください |
単一メール メッセージまたは一括メール メッセージを送信します。 メールはドメイン @boomerangui.com から送信され、件名をカスタマイズしたり、[差出人] アドレスをオーバーライドしたりできます。 電子メール アドレスや URL に応答を転送することもできます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
from
|
from | string |
From アドレスとして使用するコンテンツを渡します。 空白の場合、既定値はアカウント設定から取得されます |
|
|
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 |
既定では、すべてのメッセージは 1 つのチケットを送信します。つまり、メッセージは最初の応答を受信すると閉じられます。 同じ送信元メッセージに対する複数の応答を照合するには、true を渡してオープン チケットを使用します。 |
|
|
email_responses
|
email_responses | string |
メッセージ応答の転送先の電子メール アドレス。 |
|
|
push_responses
|
push_responses | string |
メッセージ応答が投稿される CallBack 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 |
Sms の一方向
SMS メッセージは、最大 11 文字を含む必要がある英数字の発信元 (会社名など) を使用して配信され、受信者は英数字発信元を使用して送信されたメッセージに応答できません。 また、英数字の送信元を含むメッセージの配信がサポートされていない宛先では (ローカルの制限により)、メッセージが確実に配信されるように、これは数値の発信元に置き換えられる可能性があることに注意してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
from
|
from | string |
1 方向メッセージの送信元 ID。 最大 11 文字を含む英数字。 |
|
|
message_content
|
message_content | string |
すべての recipientAddresses に送信される送信メッセージの内容。 |
|
|
受信者の宛先アドレス
|
number | string |
受信者の宛先アドレス。少なくとも 11 桁 (+ または先頭の '0' を除く) と最大 16 桁の携帯電話番号 (+を除き、番号自体の事前修正として使用されます)。 1 つの数値または最大 10,000 個の数値の配列を渡すことができます。 |
|
|
priority
|
priority | boolean |
優先度の状態をメッセージに設定するために使用する省略可能なパラメーター。 "priority" で送信されたメッセージは、アカウントに対して構成された "ソーシャル時間" をオーバーライドします。 優先順位を設定するには 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 メッセージは、要求で指定された番号を使用して配信されるため、すべての応答がその番号に返されます。 Boomerang のキャンペーン機能を使用しているお客様は、キャンペーンに関連付けられている番号を使用できます。これにより、Boomerang UI 内のキャンペーン レポート セクションから受信応答にアクセスできます。 ただし、SMS 2 方向の方法とは異なり、応答は送信メッセージに対して追跡されません。 詳細については、https://boomerangmessaging.com/docs/sending-sms-messages を参照してください。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
from
|
from | string |
メッセージに関連付けられている送信 ID は、アクティブなキャンペーンに現在関連付けられている受信キャンペーン番号である可能性があります。 |
|
|
message_content
|
message_content | string |
すべての recipientAddresses に送信される送信メッセージの内容。 |
|
|
受信者の宛先アドレス
|
number | string |
受信者の宛先アドレス。少なくとも 11 桁 (+ または先頭の '0' を除く) と最大 16 桁の携帯電話番号 (+を除き、番号自体の事前修正として使用されます)。 1 つの数値または最大 10,000 個の数値の配列を渡すことができます。 |
|
|
priority
|
priority | boolean |
優先度の状態をメッセージに設定するために使用する省略可能なパラメーター。 "priority" で送信されたメッセージは、アカウントに対して構成された "ソーシャル時間" をオーバーライドします。 優先順位を設定するには 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 を使用しているお客様は電子メール 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 桁の携帯電話番号 (+を除き、番号自体の事前修正として使用されます)。 1 つの数値または最大 10,000 個の数値の配列を渡すことができます。 |
|
|
validity_period
|
validity_period | integer |
メッセージの送信に使用される番号がアクティブになる期間。 有効期間が過ぎると、メッセージへの返信は配信されません。 双方向メッセージの場合、最小有効期間は 1 日です。 |
|
|
open_ticket
|
open_ticket | boolean |
既定では、すべてのメッセージは 1 つのチケットを送信します。つまり、メッセージは最初の応答を受信すると閉じられます。 同じ送信元メッセージに対する複数の応答を照合するには、true を渡してオープン チケットを使用します。 |
|
|
email_responses
|
email_responses | string |
メッセージ応答の転送先の電子メール アドレス。 |
|
|
push_responses
|
push_responses | string |
メッセージ応答が投稿される CallBack URL。 |
|
|
priority
|
priority | boolean |
優先度の状態をメッセージに設定するために使用する省略可能なパラメーター。 "priority" で送信されたメッセージは、アカウントに対して構成された "ソーシャル時間" をオーバーライドします。 優先順位を設定するには 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 |
Voice
固定番号は、Text-To-Speech (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 桁の携帯電話番号 (+を除き、番号自体の事前修正として使用されます)。 1 つの数値または最大 10,000 個の数値の配列を渡すことができます。 |
|
|
priority
|
priority | boolean |
優先度の状態をメッセージに設定するために使用する省略可能なパラメーター。 "priority" で送信されたメッセージは、アカウントに対して構成された "ソーシャル時間" をオーバーライドします。 優先順位を設定するには 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 応答の送信時 |
インテリジェントな 2 方向/会話型メッセージとして送信されたときに、関連付けられている送信メッセージに自動的にマップされる受信応答によってトリガーされます。 |
| 配信時に確認済み |
エンド ユーザーの配信状態の更新によってトリガーされます。 エンド ユーザーのネットワーク オペレーターによって返された配信状態でトランザクションを更新します。 詳細については、 https://boomerangmessaging.com/docs を参照してください |
SMS 応答の送信時
インテリジェントな 2 方向/会話型メッセージとして送信されたときに、関連付けられている送信メッセージに自動的にマップされる受信応答によってトリガーされます。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
状態
|
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 |
|
from
|
replies.from | string |
from |
|
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 |
|
コピー先
|
drs.destination | string |
コピー先 |
|
custom_parameter
|
drs.custom_parameter | string |
custom_parameter |
|
campaign_name
|
drs.campaign_name | string |
campaign_name |
|
unique_id
|
drs.unique_id | string |
unique_id |