メンサジア (プレビュー)
Mensagia は、ビジネス自動化通信のための信頼性の高い 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) |
お問い合わせ先 | |
---|---|
件名 | Mensagia |
[URL] | https://mensagia.com/ |
メール | support@mensagia.com |
Connector Metadata | |
---|---|
発行者 | Mensagia |
Web サイト | https://mensagia.com/ |
プライバシー ポリシー | https://mensagia.com/legal#privacidad |
カテゴリー | 通信 |
Mensagia は、ビジネス自動化通信のための信頼性の高い SMS、メール、および音声メッセージを提供します。
前提条件
続行するには、次のものが必要です。
- Mensagia の "API クライアント" アカウント。
- Mensagia アカウントに十分な残高があることを確認してください。
資格情報の入手方法
API キーは、Mensagia アカウントのポータルに入力することで取得できます。
コネクタの使用を開始する
既知の問題と制限事項
GET メソッドではパラメーターを使用できません。
一般的なエラーと解決策
一般的なエラーや解決策はありません。
よくあるご質問
ご質問がある場合は、お問い合わせ ください。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
件名 | タイプ | 説明設定 | 必須 |
---|---|---|---|
API キー | securestring | API の API キー。 | True |
調整制限
名前 | 呼び出し | 更新期間 |
---|---|---|
接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
SMS の送信 |
Mensagia アカウントを介して連絡先に SMS を送信します。 |
SMS キャンペーンを送信する |
Mensagia アカウントを介して連絡先に SMS キャンペーンを送信します。 |
Voice メッセージを送信する |
この方法では、スペインの電話番号に対して Voice キャンペーンを実行できます。 音声キャンペーンの受信者は、議題、議題と電話番号、または電話番号です。 |
トランザクション メールを送信する |
Mensagia のカスタム テンプレートを使用して、連絡先にトランザクション メールを送信します。 |
双方向 SMS の番号を取得する |
Mensagia アカウントから双方向 SMS の番号のリストを取得します。 |
双方向 SMS を取得 |
Mensagia アカウントから双方向 SMS のリストを取得します。 |
双方向 SMS を送信する |
Mensagia アカウントを介して連絡先に双方向 SMS を送信します。 |
連絡先を作成する |
Mensagia のアカウント内に連絡先を作成します。 |
SMS の送信
Mensagia アカウントを介して連絡先に SMS を送信します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
構成名
|
configuration_name | True | string |
SMS のヘッダーに表示される名前を選択します。 |
Message
|
message | True | string |
送信するテキスト (160 文字以内)。 |
数値
|
numbers | True | string |
このメッセージの受信者の携帯電話番号。 重要: 番号には、対応する国のプレフィックスが必要です。 |
開始日
|
start_date | string |
'YYYY-MM-DD hh:mm' の形式で日付を送信します。 このパラメーターを指定しない場合、メッセージはすぐに送信されます。 |
|
URL パラメーター
|
url_parameters | string |
メッセージに短縮リンク、ランディング、またはフォームがある場合は、リンクのタグ付け。 |
|
URL エクストラフィールド モード
|
url_extrafields_mode | string |
短縮リンクまたはランディングを出荷に含める場合、受信者がコンテンツを表示したときにカスタム フィールドに表示される値を選択できます。 |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
構成 ID
|
data.configuration_id | integer |
ヘッダー ID の送信 |
メッセージ ID
|
data.id | integer |
メッセージ ID |
メッセージ名
|
data.name | string |
メッセージの名前 |
メッセージの本文
|
data.message | string |
メッセージの本文 |
料金
|
data.price | float |
メッセージの料金 |
パック付きの価格
|
data.price_with_packs | float |
パック付きの価格 |
送信者ヘッダー
|
data.push_sender_name | string |
送信者名をプッシュ |
ルート名
|
data.route_name | string |
ルート名 |
送信されたメッセージ
|
data.total_messages_sent | integer |
送信メッセージ合計 |
メッセージ送信パック
|
data.total_messages_sent_with_packs | integer |
パックで送信されたメッセージの総数 |
dlrs
|
data.dlrs | array of object |
dlrs |
メッセージ ID
|
data.dlrs.message_id | string |
メッセージ ID |
送信先番号
|
data.dlrs.number | string |
レセプターの番号 |
送信されたメッセージ
|
data.dlrs.messages_sent | integer |
合計送信メッセージ数 |
SMS ブラックリストにあります
|
data.dlrs.in_SMS_blacklist | boolean |
連絡先が SMS ブラックリストにあるかどうかを確定します |
コールバック URL
|
data.callback_url | string |
コールバック URL |
開始日
|
data.start_date | string |
開始日 |
SMS キャンペーンを送信する
Mensagia アカウントを介して連絡先に SMS キャンペーンを送信します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
構成名
|
configuration_name | True | string |
SMS のヘッダーに表示される名前を選択します。 |
Message
|
message | True | string |
送信するテキスト (160 文字以内)。 |
キャンペーンの名前
|
name | string |
キャンペーンの名前 |
|
利用可能なグループ
|
available_groups | True | string |
キャンペーンの対象となるグループを割り当てます。 |
開始日
|
start_date | date-time |
'YYYY-MM-DD hh:mm' の形式で日付を送信します。 このパラメーターを指定しない場合、メッセージはすぐに送信されます。 |
|
ブロックごとの呼び出し
|
smsxblock | integer |
ブロックあたりの受信者の数。 「ブロックあたりの分数」が存在する場合は必須です。 2 つのパラメーターが送信された場合、キャンペーン構成は「カスタム構成」として定義され、パラメーター「日」および「時間間隔」の値が考慮されます。 |
|
ブロックあたりの分数
|
minutesxblock | integer |
数分ごとに、「ブロックあたりの通話数」で選択された受信者のブロックが送信されます。 「ブロックあたりの通話数」が存在する場合は必須です。 2 つのパラメーターが送信された場合、キャンペーン構成は「カスタム構成」として定義され、パラメーター「日」および「時間間隔」の値が考慮されます。 |
|
日数
|
days | string |
通話を行うことができるスペースを含まない、コンマで区切られた曜日のリスト。 (1,2,3,4,5,6,7) |
|
時間間隔
|
time_intervals | string |
通話を送信できる、スペースを含まない、コンマで区切られた時間間隔のリスト。 「ブロックあたりの分数」と「ブロックあたりの通話数」が送信された場合にのみ考慮されます。(hh:mm-hh:mm,hh:mm-hh:mm...) |
|
URL パラメーター
|
url_parameters | string |
メッセージに短縮リンク、ランディング、またはフォームがある場合は、リンクのタグ付け。 |
|
URL エクストラフィールド モード
|
url_extrafields_mode | string |
短縮リンクまたはランディングを出荷に含める場合、受信者がコンテンツを表示したときにカスタム フィールドに表示される値を選択できます。 |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
構成 ID
|
data.configuration_id | integer |
ヘッダー ID の送信 |
メッセージ ID
|
data.id | integer |
メッセージ ID |
メッセージ名
|
data.name | string |
メッセージの名前 |
メッセージの本文
|
data.message | string |
メッセージの本文 |
料金
|
data.price | float |
メッセージの料金 |
パック付きの価格
|
data.price_with_packs | float |
パック付きの価格 |
送信者ヘッダー
|
data.push_sender_name | string |
送信者名をプッシュ |
ルート名
|
data.route_name | string |
ルート名 |
送信されたメッセージ
|
data.total_messages_sent | integer |
送信メッセージ合計 |
メッセージ送信パック
|
data.total_messages_sent_with_packs | integer |
パックで送信されたメッセージの総数 |
dlrs
|
data.dlrs | array of object |
dlrs |
メッセージ ID
|
data.dlrs.message_id | string |
メッセージ ID |
送信先番号
|
data.dlrs.number | string |
レセプターの番号 |
送信されたメッセージ
|
data.dlrs.messages_sent | integer |
合計送信メッセージ数 |
SMS ブラックリストにあります
|
data.dlrs.in_SMS_blacklist | boolean |
連絡先が SMS ブラックリストにあるかどうかを確定します |
コールバック URL
|
data.callback_url | string |
コールバック URL |
開始日
|
data.start_date | string |
開始日 |
Voice メッセージを送信する
この方法では、スペインの電話番号に対して Voice キャンペーンを実行できます。 音声キャンペーンの受信者は、議題、議題と電話番号、または電話番号です。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
件名
|
name | True | string |
新しい音声キャンペーンの名前。 |
検証済みの電話番号
|
vm_validated_phone_id | True | integer |
この音声キャンペーンで使用される電話番号。 |
タイプ Locution
|
type | True | string |
この音声キャンペーンで使用される VoiceOver のタイプ。 |
Message
|
message | string |
通話で再現するために合成されるテキスト。 text2speech が選択されたスピーチのタイプである場合の必須フィールド。 |
|
メッセージ言語
|
message_language | string |
通話で再現されるテキストを合成する言語のコード。 text2speech が選択されたスピーチのタイプである場合の必須フィールド。 |
|
Voice ファイル
|
voice_file_id | string |
VoiceOver として使用される音声ライブラリ ファイル。 ファイルが選択されたスピーチのタイプである場合の必須フィールド。 |
|
数値
|
numbers | string |
スペースを含まず、国際プレフィックスが付いた、コンマで区切られた電話番号のリスト。 |
|
利用可能なグループ
|
available_groups | string |
キャンペーンの送信先の連絡先のリスト。 |
|
通話タイムアウト
|
vm_timeout | integer |
分単位の最大通話時間。 |
|
最大再試行回数
|
max_retries | integer |
通話の受信者が応答しない場合に実行する再試行の回数。 |
|
再試行 1 回の分数
|
minutes_retry_1 | integer |
最初の通話に応答しなかった後に最初の再試行が行われる間隔 (分単位)。 「最大再試行回数」が 1 より大きい場合、このフィールドは必須です。 |
|
再試行 2 回の分数
|
minutes_retry_2 | integer |
最初の通話に応答しなかった後に最初の再試行が行われる間隔 (分単位)。 「最大再試行回数」が 2 より大きい場合、このフィールドは必須です。 |
|
再試行 3 回の分数
|
minutes_retry_3 | integer |
最初の通話に応答しなかった後に最初の再試行が行われる間隔 (分単位)。 「最大再試行回数」が 3 より大きい場合、このフィールドは必須です。 |
|
再試行 4 回の分数
|
minutes_retry_4 | integer |
最初の通話に応答しなかった後に最初の再試行が行われる間隔 (分単位)。 「最大再試行回数」が 4 より大きい場合、このフィールドは必須です。 |
|
呼び出しタイムアウト
|
ring_timeout | integer |
あなたが電話に出るまでに受信者の電話が鳴る時間 (秒単位)。 |
|
応答コード
|
response_codes | string |
(JSON) 通話でアクションを生成する受信者が押すことができる応答コード。 |
|
応答コードのタイムアウト
|
response_codes_timeout | integer |
受信者が応答コードを押すことができる秒単位の時間。 このフィールドは、「応答コード」が存在する場合は必須です |
|
開始日
|
start_date | string |
'YYYY-MM-DD hh:mm' の形式のキャンペーン開始日付。 このパラメーターを送信しない場合、キャンペーンは新しいキャンペーンの作成から 2 分後に開始されます。 |
|
ブロックごとの呼び出し
|
callsxblock | integer |
ブロックあたりの受信者の数。 「ブロックあたりの分数」が存在する場合は必須です。 2 つのパラメーターが送信された場合、キャンペーン構成は「カスタム構成」として定義され、パラメーター「日」および「時間間隔」の値が考慮されます。 |
|
ブロックあたりの分数
|
minutesxblock | integer |
数分ごとに、「ブロックあたりの通話数」で選択された受信者のブロックが送信されます。 「ブロックあたりの通話数」が存在する場合は必須です。 2 つのパラメーターが送信された場合、キャンペーン構成は「カスタム構成」として定義され、パラメーター「日」および「時間間隔」の値が考慮されます。 |
|
日数
|
days | integer |
通話を行うことができるスペースを含まない、コンマで区切られた曜日のリスト。 (1,2,3,4,5,6,7) |
|
時間間隔
|
time_intervals | string |
通話を送信できる、スペースを含まない、コンマで区切られた時間間隔のリスト。 「ブロックあたりの分数」と「ブロックあたりの通話数」が送信された場合にのみ考慮されます。(hh:mm-hh:mm,hh:mm-hh:mm...) |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
送信者名
|
data.configuration_id | integer |
送信者のヘッダー名 |
Voice キャンペーン ID
|
data.id | integer |
Voice キャンペーン ID |
Voice キャンペーン名
|
data.name | string |
Voice のキャンペーン名 |
キャンペーンがアクティブ
|
data.active | integer |
プロジェクトが現在アクティブかどうかを確定します |
状態 ID
|
data.state_id | integer |
送信ステータス ID を確定します |
ステータス
|
data.state_name | string |
ステータス名 |
音声メッセージ
|
data.message | string |
送信メッセージの本文 |
開始日
|
data.start_date | string |
送信予定日 |
検証済みの電話 ID
|
data.vm_validated_phone_id | integer |
キャンペーンを送信するための検証済みの電話 ID |
検証済み電話番号
|
data.vm_validated_phone_number | string |
検証済み電話番号 |
議題
|
data.groups | array of object |
キャンペーンの対象となる議題。 |
議題 ID
|
data.groups.id | integer |
グループ ID |
議題名
|
data.groups.name | string |
議題名 |
数値
|
data.numbers | string |
キャンペーンの対象となる番号。 |
Timeout
|
data.vm_timeout | integer |
通話のタイムアウト |
最大再試行回数
|
data.max_retries | integer |
最大再試行回数 |
最小再試行分数
|
data.min_retry_minutes | integer |
次の試行まで待機する最小間隔 (分単位)。 |
最大再試行分数
|
data.max_retry_minutes | integer |
次の試行まで待機する最大間隔 (分単位)。 |
応答コード
|
data.response_codes | array of object |
通話に割り当てられた応答コード。 |
コード
|
data.response_codes.code | string |
コードの名前 |
Action
|
data.response_codes.action | string |
コードのアクション |
移動先
|
data.response_codes.transfer_to | string |
必要に応じて、通話のリダイレクト先の番号を指定します。 |
検証済みの電話 ID
|
data.response_codes.vm_validated_phone_id | string |
検証済みの電話 ID |
応答コードのタイムアウト
|
data.response_codes_timeout | string |
応答コードのタイムアウト |
コールバック URL
|
data.callback_url | string |
コールバックの URL |
タイプ
|
data.type | string |
通話のタイプ |
ブロックごとの呼び出し
|
data.callsxblock | integer |
ブロックごとの呼び出し |
ブロックあたりの分数
|
data.minutesxblock | integer |
ブロックあたりの分数 |
許可される日数
|
data.days_allowed | array of string |
音声キャンペーンの送信が許可された日数、 |
許可される時間間隔
|
data.time_intervals_allowed | array of string |
音声キャンペーンの送信が許可された時間間隔、 |
Voice 呼び出しタイムアウト
|
data.ring_timeout | integer |
試行が完了するまで呼び出し音が鳴る最大時間。 |
トランザクション メールを送信する
Mensagia のカスタム テンプレートを使用して、連絡先にトランザクション メールを送信します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
送信元
|
from | True | string |
送信者として振る舞うメール アドレス。 プラットフォームで作成された送信アドレス、またはプラットフォームで検証および認証されたドメインを持つ送信アドレスである必要があります。 |
送信者名
|
from_name | string |
すでに作成されている送信者名を使用する場合は、プラットフォームの送信アドレスに保存されている送信者名とは異なる送信者名を使用する場合は、このフィールドを送信します。 |
|
終了日時
|
to | True | string |
発送先のメール アドレス。 |
議題
|
subject | True | string |
送信する件名。 |
HTML
|
html | string |
送信する HTML。 テンプレート パラメーターなしで必須。 |
|
Template
|
template_id | integer |
Mensagia アカウントで構成されたメール テンプレートを使用して、送信用の HTML を取得できます。 このパラメーターが送信されると、パラメーターが無視されます。 |
|
送信日時
|
start_date | string |
'YYYY-MM-DD hh:mm' の形式の出荷日付。 このパラメーターを送信しない場合、すぐに送信されます。 |
|
URL パラメーター
|
url_parameters | string |
メールのコンテンツ内のリンクのタグ付け。 |
|
Attachments
|
attachments | string |
添付するファイルを含む URL のコンマ区切りリスト。 最大 5M のファイルを添付できます。 |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
アプリの構成 ID
|
data.app_configuration_id | integer |
アプリの構成 ID |
開始日
|
data.start_date | string |
開始日 |
ドメイン ID
|
data.domain_id | integer |
メールの送信元となる登録済みドメインの ID。 |
送信者の住所 ID
|
data.sender_address_id | integer |
送信者の住所 ID |
送信元
|
data.from | string |
メッセージの送信者。 |
送信者名
|
data.from_name | string |
メッセージを送信する人の名前。 |
有効なメール
|
data.to.valids | array of string |
有効なメール、 |
破棄されたメール
|
data.to.discardeds | array of string |
破棄されたメール、 |
ブラックリストに登録されたメール
|
data.to.blacklisteds | array of string |
ブラックリストに登録済み、 |
件名
|
data.subject | string |
メールの件名。 |
添付ファイル
|
data.attachments | array of string |
添付ファイル |
双方向 SMS の番号を取得する
Mensagia アカウントから双方向 SMS の番号のリストを取得します。
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
データ
|
data | array of object | |
メッセージ ID
|
data.id | integer |
メッセージ ID |
番号
|
data.number | string |
番号 |
コールバック URL
|
data.callback_url | string |
コールバック URL |
作成日
|
data.created_at | string |
作成日 |
合計
|
meta.pagination.total | integer |
合計 |
数
|
meta.pagination.count | integer |
数 |
ページあたり
|
meta.pagination.per_page | integer |
1 ページに表示する結果の数 |
現在のページ
|
meta.pagination.current_page | integer |
現在のページ |
合計ページ数
|
meta.pagination.total_pages | integer |
合計ページ数 |
リンク
|
meta.pagination.links | array of string |
リンク |
双方向 SMS を取得
Mensagia アカウントから双方向 SMS のリストを取得します。
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
メッセージ ID
|
id | integer |
メッセージ ID |
アプリケーション ID
|
application_id | string |
アプリケーション ID |
構成 ID
|
configuration_id | integer |
ヘッダー ID の送信 |
番号
|
number | string |
番号 |
タイプ
|
type | string |
SMS の種類 (MO または MT) |
受信先番号
|
enduser_number | string |
レセプターの番号 |
メッセージの本文
|
message | string |
メッセージの本文 |
作成日
|
created_at | string |
作成日 |
双方向 SMS を送信する
Mensagia アカウントを介して連絡先に双方向 SMS を送信します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
番号
|
number | True | string |
メッセージの送信先の双方向 SMS 番号 |
受信先番号
|
enduser_number | True | string |
受信者の番号 |
メッセージ
|
message | True | string |
送信するテキスト (160 文字以内)。 |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
メッセージ ID
|
id | integer |
メッセージ ID |
アプリケーション ID
|
application_id | string |
アプリケーション ID |
構成 ID
|
configuration_id | integer |
ヘッダー ID の送信 |
番号
|
number | string |
番号 |
タイプ
|
type | string |
SMS の種類 (MO または MT) |
受信先番号
|
enduser_number | string |
レセプターの番号 |
メッセージの本文
|
message | string |
メッセージの本文 |
作成日
|
created_at | string |
作成日 |
連絡先を作成する
Mensagia のアカウント内に連絡先を作成します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
メール ブラックリストにあります
|
in_mail_blacklist | boolean |
連絡先がメール ブラックリストに含まれているかどうかを指定します。 |
|
SMS ブラックリストにあります
|
in_sms_blacklist | boolean |
連絡先が音声ブラックリストに含まれているかどうかを指定します。 |
|
Voice ブラックリストにあります
|
in_voice_blacklist | boolean |
連絡先が Voice ブラックリストに含まれているかどうかを指定します。 |
|
Number
|
number | True | string |
連絡先の携帯電話番号。空白なし、国際プレフィックス付き、+ 記号なし。 |
件名
|
name | string |
Mensagia 内の連絡先の名前。 |
|
メール
|
True | string |
Mensagia 内の連絡先メール アドレス。 |
|
City
|
city | string |
連絡先の場所。 |
|
Language
|
language | string |
ISO コードでの連絡先の言語。 |
|
計画表
|
groups | string |
連絡先をアドレス帳に追加する |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
連絡先 ID
|
data.id | integer |
Mensagia の連絡先の ID |
連絡先の番号
|
data.number | string |
連絡先の番号 |
プッシュ演算子
|
data.push_operator_destination_id | string |
連絡先のプッシュ演算子の宛先 |
連絡先の名前
|
data.name | string |
連絡先の名前 |
連絡先メール
|
data.email | string |
連絡先のメール |
連絡先の場所
|
data.city | string |
連絡先の場所 |
連絡先の言語
|
data.language | string |
連絡先の言語 |
連絡先の国
|
data.country_id | integer |
連絡先の国 ID |
国名
|
data.country_name | string |
連絡先の国名 |
SMS ブラックリストにあります
|
data.in_sms_blacklist | boolean |
連絡先が SMS ブラックリストにあるかどうかを確定します |
Voice ブラックリストにあります
|
data.in_voice_blacklist | boolean |
連絡先が Voice ブラックリストにあるかどうかを確定します |
メール ブラックリストにあります
|
data.in_mail_blacklist | boolean |
連絡先がメール ブラックリストにあるかどうかを確定します |
作成日時
|
data.created_at | string |
連絡先作成日時 |
更新日時
|
data.updated_at | string |
連絡先更新日時 |
データ
|
data.groups.data | array of object |
データ |
グループ ID
|
data.groups.data.id | integer |
グループ ID |
グループ名
|
data.groups.data.name | string |
グループ名 |
グループ全体のユーザー
|
data.groups.data.total_users | integer |
グループ全体のユーザー |
グループはビジーです
|
data.groups.data.busy | integer |
グループはビジーです |
グループ作成日時
|
data.groups.data.created_at | string |
グループ作成日時 |
グループ更新日時
|
data.groups.data.updated_at | string |
グループ更新日時 |