メンサジア (プレビュー)

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 アカウントのポータルに入力することで取得できます。

コネクタの使用を開始する

  • Mensagia に登録する
  • アカウントに残高を追加する
  • API クライアント アカウントを追加する
  • 次の手順 に従う

既知の問題と制限事項

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 内の連絡先の名前。

メール
email 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

グループ更新日時