Mailgun (プレビュー)

Mailgun は、電子メールの送信、受信、追跡、保存を行う強力な API を提供します。 このコネクタを使用して、コードを記述せずに電子メールの配信と通信のワークフローを自動化します。

このコネクタは、次の製品とリージョンで使用できます。

Service クラス リージョン
コピロット スタジオ Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
ロジック アプリ Standard 次を除くすべての Logic Apps リージョン :
     - Azure Government リージョン
     - Azure China リージョン
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべての Power Apps リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate（パワーオートメート） Premium 次を除くすべての Power Automate リージョン :
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
連絡先
名前 サポート チャネル
URL https://help.mailgun.com/hc/en-us
Email support@mailgun.com
コネクタ メタデータ
Publisher シンチ スウェーデン AB
Website https://www.mailgun.com
プライバシー ポリシー https://www.mailgun.com/legal/privacy-policy/
カテゴリ マーケティング;売上と CRM

コネクタ名

Mailgun

コネクタの概要

Mailgun コネクタを使用すると、ユーザー Power Automate電子メールの送信、Mailgun ドメイン情報の取得、個々のメール アドレスの検証、一括メール検証ジョブの送信、Mailgun アカウントを使用した一括検証結果の取得を行うことができます。

連絡先

連絡先 URL: https://help.mailgun.com/hc/en-us

サポート/お問い合わせメール: support@mailgun.com

サインアップ URL: https://signup.mailgun.com/

Requirements

  • Mailgun アカウント。 お持ちでない場合は、 https://signup.mailgun.com/にサインアップしてください。
  • Mailgun API キーまたはドメイン送信キー。
  • アカウントの正しい Mailgun API リージョン (米国または EU)。
  • メールを送信する場合は、Mailgun の送信ドメイン。 運用環境の送信には、確認済みのドメインが必要です。
  • 検証アクションの場合は、Mailgun Validate にアクセスします。

サンドボックス ドメインは初期テストに使用できますが、承認された受信者に限定されます。

資格情報を取得する方法

このコネクタでは、Mailgun API キー認証が使用されます。 Mailgun コントロール パネルにサインインし、API Security から API キーを作成するか、送信ドメイン設定からドメイン固有の送信 API キーを作成します。

コネクタでは、ユーザー名として api を使用する基本認証と、パスワードとして Mailgun API キーを使用します。 接続のセットアップ中に、アカウントに一致する Mailgun API リージョンを選択します。

サポートされている操作

このコネクタは、次の操作をサポートしています。

  • Send Email: Mailgun の送信ドメインを使用して電子メールを送信します。
  • Get Domain Information: Mailgun ドメイン情報を取得します。
  • Validate Email Address: 個々のメール アドレスを検証します。
  • Submit Bulk Validation Job: 一括電子メール検証ジョブを送信します。
  • Get Bulk Validation Results: 電子メールの一括検証結果を取得します。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。
デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有できません

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前 タイプ 形容 必須
API キー securestring Mailgun 秘密 API キー True
Mailgun リージョン 文字列 Mailgun US または Mailgun EU を選択する True

アクション

ドメインの詳細を取得する

ドメインの状態と設定に関する詳細を含むドメインの JSON 表現をフェッチします。
ドメインを取得する

ドメインの一覧を取得します。 状態または権限でフィルター処理できます。 リストはページ分割され、1 ページあたり 1000 項目に制限されます。
メールを送信する

Mailgun のメッセージ API と互換性のあるマルチパート フォーム フィールドを使用して、Mailgun アカウントを使用して電子メールを送信します。
一括検証の結果を取得する

以前に送信されたジョブの一括検証ジョブの状態と概要結果を取得します。
電子メールの一括検証

メール ヘッダー列を含む CSV をアップロードし、Mailgun の V4 API を使用して一括検証ジョブを開始します。
電子メールの検証

Mailgun の検証サービスを使用してメール アドレスを検証し、配信可能性の結果を返します。

ドメインの詳細を取得する

操作 ID:
Get_Domain

ドメインの状態と設定に関する詳細を含むドメインの JSON 表現をフェッチします。

パラメーター

名前 キー 必須 型 説明
ドメイン名
 name True string

フェッチするドメインの名前

返品

名前 パス 型 説明
識別子
 domain.id string

ドメインの一意識別子
名前
 domain.name string

Mailgun に登録されている完全修飾ドメイン名
状態
 domain.state string

ドメインの現在の検証状態
型
 domain.type string

ドメインの分類。 指定できる値はカスタムまたはサンドボックスです
作成日時
 domain.created_at string

ドメインがRFC1123形式で作成された日時を示すタイムスタンプ
is_disabled
 domain.is_disabled boolean

ドメインが現在無効になっているかどうかを示します
require_tls
 domain.require_tls boolean

True の場合、Mailgun は TLS 接続経由でのみメッセージを送信します
skip_verification
 domain.skip_verification boolean

True の場合、Mailgun は TLS 接続の設定時に証明書とホスト名を確認しません
smtp_login
 domain.smtp_login string

ドメインの SMTP ログイン ユーザー名
smtp_password
 domain.smtp_password string

SMTP 認証に使用されるドメインのオプションの SMTP パスワード
spam_action
 domain.spam_action string

メッセージにスパムのフラグが設定されたときに実行するアクション。 オプションが無効、タグ、またはブロック
ワイルドカード
 domain.wildcard boolean

ドメインがワイルドカード ドメインであり、任意のサブドメインの電子メールを受信できるかどうかを示します
subaccount_id
 domain.subaccount_id string

ドメインが属するサブアカウント ID
tracking_host
 domain.tracking_host string

追跡に使用するドメインのカスタム追跡ホストが開き、クリック
use_automatic_sender_security
 domain.use_automatic_sender_security boolean

True Mailgun が DKIM キーの生成と DNS レコードの構成を自動的に管理する場合
web_prefix
 domain.web_prefix string

オープンとクリックの追跡に使用されるサブドメイン プレフィックス
web_scheme
 domain.web_scheme string

追跡に使用されるプロトコル スキーム
archive_to
 domain.archive_to string

正常に配信された各メッセージのコピーが投稿される URL
encrypt_incoming_message
 domain.encrypt_incoming_message boolean

このドメインへの真の受信メッセージが暗号化される場合
message_ttl
 domain.message_ttl integer

受信メッセージと送信メッセージの両方を取得するための Time to Live (TTL) を秒単位で指定します
receiving_dns_records
 receiving_dns_records array of object

電子メールの受信に必要な DNS レコードの一覧
is_active
 receiving_dns_records.is_active boolean

DNS レコードが現在アクティブかどうかを示します
キャッシュ
 receiving_dns_records.cached array of string

DNS レコードの Mailgun キャッシュ値の一覧
名前
 receiving_dns_records.name string

DNS レコードの名前 (該当する場合)
優先権
 receiving_dns_records.priority string

MX DNS レコードの優先度値
record_type
 receiving_dns_records.record_type string

MX、TXT、CNAME などの DNS レコードの種類
有効な
 receiving_dns_records.valid string

DNS レコードが有効かどうかを示します
value
 receiving_dns_records.value string

DNS レコードの期待値
sending_dns_records
 sending_dns_records array of object

電子メールの送信に必要な DNS レコードの一覧
is_active
 sending_dns_records.is_active boolean

DNS レコードが現在アクティブかどうかを示します
キャッシュ
 sending_dns_records.cached array of string

DNS レコードの Mailgun キャッシュ値の一覧
名前
 sending_dns_records.name string

DNS レコードの名前 (該当する場合)
優先権
 sending_dns_records.priority string

MX DNS レコードの優先度値
record_type
 sending_dns_records.record_type string

MX、TXT、CNAME などの DNS レコードの種類
有効な
 sending_dns_records.valid string

DNS レコードが有効かどうかを示します
value
 sending_dns_records.value string

DNS レコードの期待値

ドメインを取得する

操作 ID:
Get_Domains

ドメインの一覧を取得します。 状態または権限でフィルター処理できます。 リストはページ分割され、1 ページあたり 1000 項目に制限されます。

パラメーター

名前 キー 必須 型 説明
制限
 limit integer

アイテムの最大数。 最大: 1000。 既定値は100
スキップ
 skip integer

n 番目の要素から始まる項目の一覧を取得します。 既定値は0
State
 state string

特定の状態のドメインのみを取得します。 アクティブ、未確認、または無効にできます。
並べ替え
 sort string

有効な並べ替えオプションは、名前 (asc)、name:asc、または name:desc です。
権威
 authority string

特定の権限を持つドメインのみを取得します。
Search
 search string

指定された部分または完全な名前でドメインを検索します。 ワイルドカードはサポートされていません。
サブアカウントを含める
 include_subaccounts boolean

このアカウントのサブアカウントに属するすべてのドメインを検索します。 既定値は false です。

返品

名前 パス 型 説明
total_count
 total_count integer

ドメインの合計数
items
 items array of object

ドメインの一覧
識別子
 items.id string

ドメインの一意識別子
名前
 items.name string

Mailgun に登録されている完全修飾ドメイン名
状態
 items.state string

ドメインの現在の検証状態
型
 items.type string

ドメインの分類。 指定できる値はカスタムまたはサンドボックスです
作成日時
 items.created_at string

ドメインがRFC1123形式で作成された日時を示すタイムスタンプ
is_disabled
 items.is_disabled boolean

ドメインが現在無効になっているかどうかを示します
require_tls
 items.require_tls boolean

True の場合、Mailgun は TLS 接続経由でのみメッセージを送信します
skip_verification
 items.skip_verification boolean

True の場合、Mailgun は TLS 接続の設定時に証明書とホスト名を確認しません
smtp_login
 items.smtp_login string

ドメインの SMTP ログイン ユーザー名
smtp_password
 items.smtp_password string

SMTP 認証に使用されるドメインのオプションの SMTP パスワード
spam_action
 items.spam_action string

メッセージにスパムのフラグが設定されたときに実行するアクション。 オプションが無効、タグ、またはブロック
ワイルドカード
 items.wildcard boolean

ドメインがワイルドカード ドメインであり、任意のサブドメインの電子メールを受信できるかどうかを示します
subaccount_id
 items.subaccount_id string

ドメインが属するサブアカウント ID
tracking_host
 items.tracking_host string

追跡に使用するドメインのカスタム追跡ホストが開き、クリック
use_automatic_sender_security
 items.use_automatic_sender_security boolean

True Mailgun が DKIM キーの生成と DNS レコードの構成を自動的に管理する場合
web_prefix
 items.web_prefix string

オープンとクリックの追跡に使用されるサブドメイン プレフィックス
web_scheme
 items.web_scheme string

追跡に使用されるプロトコル スキーム
archive_to
 items.archive_to string

正常に配信された各メッセージのコピーが投稿される URL
encrypt_incoming_message
 items.encrypt_incoming_message boolean

このドメインへの真の受信メッセージが暗号化される場合
message_ttl
 items.message_ttl integer

受信メッセージと送信メッセージの両方を取得するための Time to Live (TTL) を秒単位で指定します

メールを送信する

操作 ID:
Send_Email

Mailgun のメッセージ API と互換性のあるマルチパート フォーム フィールドを使用して、Mailgun アカウントを使用して電子メールを送信します。

パラメーター

名前 キー 必須 型 説明
ドメイン名
 domain_name True string

メールを送信するドメイン
電子メール アドレスから
 from True string

メッセージの送信先の電子メール アドレス。
電子メール アドレスへ
 to True string

受信者のメール アドレス。
サブジェクト
 subject True string

メールの件名。
電子メール本文 (テキスト)
 text string

メールのプレーンテキスト本文。
電子メール本文 (HTML)
 html html

電子メールの HTML 本文。
CC メール アドレス
 cc string

カーボン コピーの受信者の電子メール アドレス。
BCC メール アドレス
 bcc string

ブラインド カーボン コピーの受信者のメール アドレス。
Reply-To メール アドレス
 h:Reply-To string

応答を配信する場所。
添付ファイル
 attachment file

メッセージに含める添付ファイル。
Tags
 o:tag array

Mailgun でメールをグループ化およびフィルター処理するための 1 つ以上のタグ (メッセージあたり最大 10 個)。

返品

名前 パス 型 説明
メッセージ ID
 id string

キューに登録されたメッセージに割り当てられた一意の識別子
ステータス メッセージ
 message string

Mailgun から人間が判読できる状態 (たとえば、Queued。ありがとうございます。)

一括検証の結果を取得する

操作 ID:
Get_Bulk_Validation_Results

以前に送信されたジョブの一括検証ジョブの状態と概要結果を取得します。

パラメーター

名前 キー 必須 型 説明
職務 ID
 list_id True string

一括検証要求から返されるジョブ識別子。

返品

名前 パス 型 説明
職務 ID
 id string

ジョブ識別子
職務 ID
 list_id string

ジョブ リスト名
ジョブの状態
 status string

現在のジョブの状態
作成日時
 created_at integer

ジョブが作成されたとき (Unix タイムスタンプ)
CSV ダウンロード URL
 download_url.csv string

すべての結果を CSV ファイルとしてダウンロードする URL
キュレーションされた CSV ダウンロード URL
 download_url.curated_csv string

キュレーションされた結果を CSV ファイルとしてダウンロードする URL
JSON ダウンロード URL
 download_url.json string

すべての結果を JSON ファイルとしてダウンロードする URL
キュレーションされた JSON ダウンロード URL
 download_url.curated_json string

キュレーションされた結果を JSON ファイルとしてダウンロードする URL
合計数量
 quantity integer

ジョブ内のレコードの合計数
処理されたレコード
 records_processed integer

これまでに処理されたレコードの数
成果物の数
 summary.result.deliverable integer

成果物アドレスの数
配信不能数
 summary.result.undeliverable integer

配信不能アドレスの数
すべてのカウントをキャッチ
 summary.result.catch_all integer

キャッチオール アドレスの数
送信しない数
 summary.result.do_not_send integer

送信しないフラグが設定されたアドレスの数
すべてのカウントを受け入れる
 summary.result.accept_all integer

Accept-all アドレスの数
不明な数
 summary.result.unknown integer

配信可能性が不明なアドレスの数
高リスク数
 summary.risk.high integer

リスクの高いアドレスの数
中リスク数
 summary.risk.medium integer

中リスク アドレスの数
低リスク数
 summary.risk.low integer

リスクの低いアドレスの数
不明なリスク数
 summary.risk.unknown integer

リスクが不明なアドレスの数
非常に魅力的な数
 summary.engagement.highly_engaged integer

非常に魅力的なアドレスの数
エンゲージカウント
 summary.engagement.engaged integer

エンゲージされたアドレスの数
Disengaged Count
 summary.engagement.disengaged integer

解放されたアドレスの数
ボット数
 summary.engagement.bot integer

ボット アドレスの数
申し立て者数
 summary.engagement.complainer integer

苦情担当者アドレスの数
データカウントなし
 summary.engagement.no_data integer

エンゲージメント データのないアドレスの数

電子メールの一括検証

操作 ID:
Bulk_Validate_Email

メール ヘッダー列を含む CSV をアップロードし、Mailgun の V4 API を使用して一括検証ジョブを開始します。

パラメーター

名前 キー 必須 型 説明
ジョブ リスト名
 list_id True string

一括検証ジョブを識別するパス パラメーター。
CSV ファイル
 file True file

アップロードする CSV ファイル。 ファイルには、email という名前のヘッダーを含める必要があります。

返品

名前 パス 型 説明
ジョブ ID (リスト名)
 id string

ジョブ識別子 (リスト名)
サーバー メッセージ
 message string

Mailgun からのステータス メッセージ

電子メールの検証

操作 ID:
Validate_Email

Mailgun の検証サービスを使用してメール アドレスを検証し、配信可能性の結果を返します。

パラメーター

名前 キー 必須 型 説明
メール アドレス
 address True string

検証する電子メール アドレス。

返品

名前 パス 型 説明
メール アドレス
 address string

検証された電子メール アドレス
有効
 is_valid boolean

Mailgun がアドレスを有効と見なすかどうか
メールボックスの検証
 mailbox_verification string

メールボックスの確認の状態
破棄可能なアドレス
 is_disposable_address boolean

アドレスが破棄可能なプロバイダーからのものかどうか
ロール アドレス
 is_role_address boolean

アドレスがロールベースのアドレスかどうか
検証の理由
 reason array of string

Mailgun によって返される検証の理由 (有効な場合は空)
リスク レベル
 risk string

Mailgun によって割り当てられるリスク レベル
Result
 result string

Mailgun の配信可能性の結果 (成果物や配信不能など)
ルート アドレス
 root_address string

正規化されたルート アドレス
表示される名前
 parts.display_name string

アドレスの表示名部分
[ドメイン]
 parts.domain string

アドレスのドメイン部分
ローカル パーツ
 parts.local_part string

アドレスのローカル部分