Cloudflare 経由のサポートメール。運用するメールサーバーは不要。

概要

お客様のメッセージがチームに届くまで

1. 1お客様がサポート用アドレスのいずれか(例: support@example.com)にメールを送ります。
2. 2Cloudflare Email Routing がメッセージを受信し、Yuva Email Worker に渡します。
3. 3Worker は、生のメッセージ、2 つのエンベロープアドレス、タイムスタンプに、Yuva と共有するシークレットで HMAC-SHA256 署名を行い、Yuva サーバーの /ingress/email に送信します。
4. 4Yuva は、メッセージを読む前に署名を確認し、タイムスタンプが 5 分以内であることを確認します。署名が正しくないリクエストは拒否されます。
5. 5Yuva は宛先アドレスのメールチャネルを見つけ、In-Reply-To と References をもとに、メッセージが属する会話にスレッド化します。それ以外は新しい会話になります。返信があると、会話は再び開きます。
6. 6チームはパネルで返信します。返信は、Amazon SES、Postmark、自前のリレーなど、メールチャネル独自の SMTP アカウントから、同じアドレス、同じスレッドで送信されます。返信が Worker を通ることはありません。

数ステップでセットアップ

Yuva サーバーと、ドメインを管理している Cloudflare アカウントが必要です。

1. 1

   Yuva で、設定 → 対象の受信トレイ → チャネル → メールを開き、サポート用アドレスを追加します。サーバーにシークレットを設定して再起動します。

   YUVA_INGRESS_SECRET=<openssl rand -hex 32>
   YUVA_INGRESS_AUTHSERV_ID=mx.cloudflare.net

2. 2

   同じシークレットを使って、Cloudflare アカウントに Worker をデプロイします。

   cd edge
   bun install
   bunx wrangler login
   bunx wrangler secret put INGRESS_SECRET
   bunx wrangler deploy --var YUVA_URL:https://support.example.com

3. 3

   Cloudflare ダッシュボードで、ドメイン → Email → Email Routing を開いて有効にします。Cloudflare が MX と SPF のレコードを追加します。

4. 4

   Routing rules で、各サポート用アドレスを Worker の yuva-edge に送ります。キャッチオールのチャネルでは、キャッチオールのルールを yuva-edge に向けます。

5. 5

   テストメッセージを送信して、パネルに会話が現れるのを確認します。

6. 6

   任意: デプロイコマンドにフォールバック用アドレスを追加すると、障害中もメールを保持できます。

   bunx wrangler deploy --var YUVA_URL:https://support.example.com --var FALLBACK_FORWARD:you@example.org

Email Routing はドメインの MX になるため、ほかのメールサーバーが扱っていないドメインまたはサブドメインを使ってください。

Cloudflare に縛られません

Worker は /ingress/email を呼び出す方法のひとつです。どのメールサーバーやリレーでも、同じ署名付きヘッダーで生のメッセージを POST できます。コマンドに配信できるメールサーバーなら、メッセージを yuva ingest-email にパイプすることもできます。リクエスト形式は Worker の README に記載されています。

Q&A