Mailgun

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

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

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

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

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

パラメータ	型	必須	説明
`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	追加されたメンバーの詳細