sim/apps/docs/content/docs/ja/tools/mailgun.mdx

---
title: Mailgun
description: Mailgunでメールを送信し、メーリングリストを管理する
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="mailgun"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Mailgun](https://www.mailgun.com)は、開発者やビジネス向けに設計された強力なメール配信サービスで、メールの送受信やトラッキングを簡単に行うことができます。Mailgunを使用すると、信頼性の高いトランザクションメールやマーケティングメール、柔軟なメーリングリスト管理、高度なイベントトラッキングのための堅牢なAPIを活用できます。

Mailgunの包括的な機能セットにより、主要なメール操作を自動化し、配信可能性や受信者のエンゲージメントを緊密に監視することができます。これにより、コミュニケーション、通知、キャンペーンメールがワークフローの中核となるプロセスの理想的なソリューションとなります。

Mailgunの主な機能には以下が含まれます：

- **トランザクションメール送信：** アカウント通知、領収書、アラート、パスワードリセットなどの大量メールを配信。
- **リッチメールコンテンツ：** プレーンテキストとHTMLの両方のメールを送信し、タグを使用してメッセージを分類・追跡。
- **メーリングリスト管理：** メーリングリストとメンバーを作成、更新、管理して、グループコミュニケーションを効率的に送信。
- **ドメイン情報：** 送信ドメインに関する詳細を取得して、構成と健全性を監視。
- **イベントトラッキング：** 送信メッセージに関する詳細なイベントデータで、メールの配信可能性とエンゲージメントを分析。
- **メッセージ取得：** コンプライアンス、分析、またはトラブルシューティングのニーズのために保存されたメッセージにアクセス。

MailgunをSimに統合することで、エージェントはプログラムによるメール送信、メーリングリスト管理、ドメイン情報へのアクセス、自動化されたワークフローの一部としてリアルタイムイベントの監視を行うことができます。これにより、AIを活用したプロセスから直接ユーザーとインテリジェントでデータ駆動型のエンゲージメントが可能になります。
{/* MANUAL-CONTENT-END */}

## 使用手順

Mailgunをワークフローに統合します。トランザクションメールの送信、メーリングリストとメンバーの管理、ドメイン情報の表示、メールイベントの追跡が可能です。テキストメールとHTMLメール、追跡用のタグ、包括的なリスト管理をサポートしています。

## ツール

### `mailgun_send_message`

Mailgun APIを使用してメールを送信する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Mailgun APIキー |
| `domain` | string | はい | Mailgunドメイン（例：mg.example.com） |
| `from` | string | はい | 送信者のメールアドレス |
| `to` | string | はい | 受信者のメールアドレス（複数の場合はカンマ区切り） |
| `subject` | string | はい | メールの件名 |
| `text` | string | いいえ | メールのプレーンテキスト本文 |
| `html` | string | いいえ | メールのHTML本文 |
| `cc` | string | いいえ | CCメールアドレス（複数の場合はカンマ区切り） |
| `bcc` | string | いいえ | BCCメールアドレス（複数の場合はカンマ区切り） |
| `tags` | string | いいえ | メールのタグ（カンマ区切り） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | メッセージが正常に送信されたかどうか |
| `id` | string | メッセージID |
| `message` | string | Mailgunからのレスポンスメッセージ |

### `mailgun_get_message`

キーによって保存されたメッセージを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Mailgun APIキー |
| `domain` | string | はい | Mailgunドメイン |
| `messageKey` | string | はい | メッセージストレージキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | リクエストが成功したかどうか |
| `recipients` | string | メッセージの受信者 |
| `from` | string | 送信者のメールアドレス |
| `subject` | string | メッセージの件名 |
| `bodyPlain` | string | プレーンテキスト本文 |
| `strippedText` | string | 整形されたテキスト |
| `strippedSignature` | string | 整形された署名 |
| `bodyHtml` | string | HTML本文 |
| `strippedHtml` | string | 整形されたHTML |
| `attachmentCount` | number | 添付ファイルの数 |
| `timestamp` | number | メッセージのタイムスタンプ |
| `messageHeaders` | json | メッセージヘッダー |
| `contentIdMap` | json | コンテンツIDマップ |

### `mailgun_list_messages`

Mailgunを通じて送信されたメッセージのイベント（ログ）を一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Mailgun APIキー |
| `domain` | string | はい | Mailgunドメイン |
| `event` | string | いいえ | イベントタイプでフィルタリング（accepted、delivered、failed、opened、clickedなど） |
| `limit` | number | いいえ | 返すイベントの最大数（デフォルト：100） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | リクエストが成功したかどうか |
| `items` | json | イベント項目の配列 |
| `paging` | json | ページング情報 |

### `mailgun_create_mailing_list`

新しいメーリングリストを作成する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Mailgun APIキー |
| `address` | string | はい | メーリングリストアドレス（例：list@example.com） |
| `name` | string | いいえ | メーリングリスト名 |
| `description` | string | いいえ | メーリングリストの説明 |
| `accessLevel` | string | いいえ | アクセスレベル：readonly、members、またはeveryone |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | リストが正常に作成されたかどうか |
| `message` | string | レスポンスメッセージ |
| `list` | json | 作成されたメーリングリストの詳細 |

### `mailgun_get_mailing_list`

メーリングリストの詳細を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Mailgun APIキー |
| `address` | string | はい | メーリングリストアドレス |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | リクエストが成功したかどうか |
| `list` | json | メーリングリストの詳細 |

### `mailgun_add_list_member`

メーリングリストにメンバーを追加する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Mailgun APIキー |
| `listAddress` | string | はい | メーリングリストアドレス |
| `address` | string | はい | メンバーのメールアドレス |
| `name` | string | いいえ | メンバー名 |
| `vars` | string | いいえ | カスタム変数のJSON文字列 |
| `subscribed` | boolean | いいえ | メンバーが購読しているかどうか |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | メンバーが正常に追加されたかどうか |
| `message` | string | レスポンスメッセージ |
| `member` | json | 追加されたメンバーの詳細 |

### `mailgun_list_domains`

Mailgunアカウントのすべてのドメインを一覧表示する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Mailgun APIキー |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | リクエストが成功したかどうか |
| `totalCount` | number | ドメインの総数 |
| `items` | json | ドメインオブジェクトの配列 |

### `mailgun_get_domain`

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

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | はい | Mailgun APIキー |
| `domain` | string | はい | ドメイン名 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `success` | boolean | リクエストが成功したかどうか |
| `domain` | json | ドメインの詳細 |

## 注意事項

- カテゴリー: `tools`
- タイプ: `mailgun`