الانتقال من 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.