مهاجرت از Mailgun
از Mailgun
به OpenEmail بیایید.
دامنه‌ها در URL، گزینه‌های o: و متغیرهای v:، با نگاشت فیلد به فیلد و مبدلی که کدتان را بازنویسی می‌کند.
همان ایمیل،
به هر دو شکل نوشته‌شده.
یک پیام با یک نشانی پاسخ و یک برچسب، که از طریق Mailgun و سپس از طریق OpenEmail فرستاده میشود.
import FormData from 'form-data'import Mailgun from 'mailgun.js'const mailgun = new Mailgun(FormData)const mg = mailgun.client({ username: 'api', key: process.env.MAILGUN_API_KEY })const result = await mg.messages.create('mg.acme.com', {from: 'Acme <[email protected]>',to: ['[email protected]'],subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>','h:Reply-To': '[email protected]','o:tag': ['invoice'],})console.log(result.id)
import { init, openemail } from '@openemail/sdk'init({ apiKey: process.env.OPENEMAIL_API_KEY })const email = await openemail.emails.send({from: 'Acme <[email protected]>',to: ['[email protected]'],subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>',replyTo: '[email protected]',tags: { tag: 'invoice' },})console.log(email.id)
فیلد به فیلد،
چه چیزی کجا میرود.
هر گزینه‌ای که Mailgun می‌پذیرد، و جای آن در OpenEmail.
| Mailgun | OpenEmail | یادداشت‌ها |
|---|---|---|
messages.create(domain, …) | from | دامنهٔ نشانی from تعیین می‌کند. |
h:Reply-To | replyTo | یک نشانی برای هر پیام. |
h:X-* | headers | یک شیء از نام‌ها و مقدارها. |
o:tag, v:* | tags | تا 10 جفت کلید و مقدار. |
o:deliverytime | scheduledAt | یک زمان ISO به‌جای تاریخ RFC 2822. |
o:tracking-opens, o:tracking-clicks | tracking: { opens, clicks } | مقدارهای بولی به‌جای yes و no. |
template, t:variables | template: { id, props } | اول قالب را در OpenEmail دوباره بسازید. |
attachment | attachments | بایت یا Base64، در مجموع 5 مگابایت. |
recipient-variables | emails.sendBatch | یک ورودی برای هر گیرنده، با مقدارهای پرشده. |
مبدل
کد Mailgun خود را بچسبانید،
و نسخهٔ OpenEmail آن را بگیرید.
مشخص کنید کد از کجا میآید و به چه زبانی است. کلیدهای شناساییشده در مرورگر خودتان حذف میشوند و هیچ چیزی از آنچه میچسبانید نگه داشته نمیشود.
فراتر از کد،
چهار گام دیگر.
- 01
دامنهٔ فرستنده را اضافه کنید
آن را در OpenEmail اضافه کنید و رکوردهای DNS فهرست‌شده را منتشر کنید. ارسال وقتی شروع میشود که رکورد امضا پاسخ دهد.
- 02
یک کلید API بسازید
کلیدها با oe_live_ شروع میشوند و فقط محدوده‌هایی را دارند که به آن‌ها می‌دهید.
- 03
وب‌هوک‌هایتان را منتقل کنید
برای رویدادهای فهرست‌شده در زیر یک نقطهٔ پایانی بسازید و سرآیند X-OpenEmail-Signature را در هر درخواست بررسی کنید.
- 04
مخاطبان و نشانی‌های مسدود را بیاورید
مخاطبان خود را به‌صورت CSV در صفحهٔ یک گروه مخاطب وارد کنید، و نشانی‌هایی را که Mailgun مسدود کرده بود به فهرست مسدودی اضافه کنید.
رویدادهای وب‌هوک،
با نام‌های تازه.
هر رویداد Mailgun و رویداد OpenEmail که جای آن را می‌گیرد. هر درخواست یک رویداد امضاشده دارد.
| Mailgun | OpenEmail |
|---|---|
accepted | email.sent |
delivered | email.delivered |
failed (temporary) | email.delivery_delayed |
failed (permanent) | email.bounced |
complained | email.complained |
opened | email.opened |
clicked | email.clicked |
unsubscribed | suppression.added |
مهاجرت از Mailgun،
پرسش و پاسخ.
از جای دیگری
مهاجرت می‌کنید؟
هر راهنما همان مبدل، نگاشت فیلدها و چک‌لیست را دارد.
کدتان تبدیل شد؟
کلیدی را که می‌خواند بسازید.
ساختن یک فضای کاری یک دقیقه طول می‌کشد. دامنه‌تان را اضافه کنید، یک کلید API بسازید و OPENEMAIL_API_KEY را تنظیم کنید.