Листи в підтримку через Cloudflare.Не потрібно запускати поштовий сервер.

Що це

Як повідомлення доходить від клієнта до вашої команди

1. 1Клієнт пише на одну з ваших адрес підтримки, наприклад support@example.com.
2. 2Cloudflare Email Routing приймає повідомлення й передає його Yuva Email Worker.
3. 3Worker підписує вихідне повідомлення, обидві адреси конверта та мітку часу за допомогою HMAC-SHA256 спільним з Yuva секретом і надсилає їх на /ingress/email вашого сервера Yuva.
4. 4Перш ніж прочитати повідомлення, Yuva перевіряє підпис і те, що мітка часу в межах 5 хвилин. Запит із хибним підписом відхиляється.
5. 5Yuva знаходить поштовий канал за адресою одержувача й за In-Reply-To та References додає повідомлення до розмови, до якої воно належить. Усе інше починає нову розмову. Відповідь знову відкриває розмову.
6. 6Ваша команда відповідає в панелі. Відповідь надсилається через власний SMTP-обліковий запис поштового каналу, наприклад Amazon SES, Postmark або ваш релей, з тієї самої адреси й у тому самому ланцюжку. Відповіді не проходять через Worker.

Налаштуйте за кілька кроків

Вам потрібні сервер Yuva і обліковий запис Cloudflare, який керує доменом.

1. 1

   У Yuva відкрийте Налаштування → ваша скринька → Канали → Пошта й додайте адресу підтримки. Задайте на сервері секрет і перезапустіть його:

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

2. 2

   Розгорніть Worker у своєму обліковому записі Cloudflare з тим самим секретом:

   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. Для універсального каналу спрямуйте на нього універсальне правило.

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. Будь-який поштовий сервер або релей може надіслати вихідне повідомлення з тими самими підписаними заголовками, а поштовий сервер, що доставляє в команду, може передати повідомлення через конвеєр у yuva ingest-email. Формат запиту описано в README Worker.

Запитання та відповіді