MailCare を Laravel アプリケーションと統合する方法

このチュートリアルでは、MailCare を Laravel アプリケーションと統合して、Webhook 経由で受信メールを処理する方法を説明します。このアプローチは、カスタマー サポート リクエストの管理、フィードバックの処理、その他の電子メール ベースの自動化などのタスクを自動化する場合に役立ちます。

前提条件

• 基本的な Laravel アプリケーションのセットアップ。 (そうでない場合は、Laravel ドキュメントの指示に従ってください。)
• メール受信と Webhook 自動化を設定するための MailCare のアカウント。

MailCare は、毎月最大 100 通の電子メールを無料で受信できる一時ドメインを提供します。

使用事例

ユーザーがメールで支援を求める自動サポート システムを構築していると想像してください。各メールを手動で処理する代わりに、Laravel アプリ内で直接メールをキャプチャして処理したいと考えるでしょう。 MailCare は電子メールを受信するための一時ドメインを提供し、Webhook を使用して電子メールのメタデータを JSON として Laravel アプリに転送できます。

ステップ 1: MailCare をセットアップする

1. MailCare.io に移動し、アカウントにサインアップまたはログインします。
2. MailCare は一時的なドメイン (例: v9w3fyarsq.mailcare.dev) を提供します。必要に応じてカスタマイズできます。
3. オートメーションセクションに移動し、オートメーションの追加をクリックします。
4. 自動化フォーム内:
   • Catch All のような名前を付けます。
   • フィールド 呼び出し先の Webhook URL に、Webhook を処理する Laravel アプリの URL を入力します。例: https://mylaravelapp.com/api/incoming-emails.
   • ペイロード形式フィールドは、デフォルトのオプションであるJSONメタデータ電子メールにすでに設定されているため、変更する必要はありません。
5. オートメーションを保存します。

MailCare のセットアップは以上です。次に、Laravel 側に移りましょう。

ステップ 2: 受信メールを処理するために Laravel をセットアップする

2.1 ルートを定義する

物事を簡単にするために、個別のコントローラーを作成せずに受信 Webhook を直接処理する POST ルートを Routes/api.php に定義します。

routes/api.php ファイルに次のコードを追加します:

use Illuminate\Support\Facades\Route;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;

Route::post('/incoming-emails', function (Request $request) {
    // Extract email data from the JSON payload
    $emailData = $request->json('data');

    // Log specific details of the email for better clarity
    Log::info('Email received from:', ['sender' => $emailData['sender']['email'] ?? 'Unknown']);
    Log::info('Email received to:', ['inbox' => $emailData['inbox']['email'] ?? 'Unknown']);
    Log::info('Email subject:', ['subject' => $emailData['subject'] ?? 'No Subject']);
    // Extract email data from the JSON payload
    $emailData = $request->json()->all();

    // Log the email data for debugging and verification
    Log::info('Received email webhook from MailCare:', $emailData);

    // You can also handle the email data here (e.g., store in database, trigger actions, etc.)

    // Here, you could add further processing, such as:
    // - Storing the email in your database
    // - Triggering a notification or action based on the email content

    return response()->noContent();
});

他に何ができるでしょうか?

この統合を拡張するには多くの方法があります:

• オートメーションのフィルター: MailCare で送信者や件名ベースのルールなどのフィルターを設定して、特定のメールのみを転送します。
• シークレット トークンによるセキュリティ: シークレット トークンを追加し、Laravel でそれを検証して、リクエストが MailCare から送信されていることを確認することで Webhook を保護します。
• 電子メール本文の取得: Webhook 形式を変更して電子メール本文を HTML またはプレーン テキストに含め、コンテンツを直接処理できるようにします。
• 添付ファイルの処理: MailCare の API を使用して添付ファイルを取得し、Laravel アプリで処理します。
• リンクを解析してデータを抽出: メール本文からリンクや特定のキーワードなどの有用な情報を抽出し、その後のアクションを自動化します。

詳細については、MailCare Webhook のドキュメントを参照してください。

結論

この記事では、Webhook 経由で受信メールを処理するために MailCare を Laravel 11 アプリケーションと統合することに成功しました。私たちは、電子メールの詳細をログに記録し、より高度な使用例の基礎を確立する方法を検討しました。メールのフィルタリングから添付ファイルの処理やコンテンツの解析まで、可能性は多岐にわたります。

MailCare と Laravel を使用すると、ニーズに合わせた強力な電子メール主導のワークフローを構築できます。基本のセットアップが完了したので、特定の使用例に合わせて拡張してカスタマイズします。

以上がMailCare を Laravel アプリケーションと統合する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。