الانتقال من SendGrid
انتقل من SendGrid
إلى OpenEmail.
التخصيصات والقوالب الديناميكية والفئات وخطاف الويب للأحداث، وما يقابلها حقلًا بحقل، مع محوّل يعيد كتابة شيفرتك.
الرسالة نفسها،
مكتوبة بالطريقتين.
رسالة واحدة بعنوان رد ووسم، تُرسَل عبر SendGrid ثم عبر OpenEmail.
import sgMail from '@sendgrid/mail'sgMail.setApiKey(process.env.SENDGRID_API_KEY)try {const [response] = await sgMail.send({from: { email: '[email protected]', name: 'Acme' },to: '[email protected]',replyTo: '[email protected]',subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>',categories: ['invoice'],})console.log(response.statusCode)} catch (error) {console.error(error.response?.body ?? error)}
import { init, openemail } from '@openemail/sdk'init({ apiKey: process.env.OPENEMAIL_API_KEY })try {const email = await openemail.emails.send({from: { email: '[email protected]', name: 'Acme' },to: '[email protected]',replyTo: '[email protected]',subject: 'Your invoice is ready',html: '<p>Thanks for your order.</p>',tags: { category: 'invoice' },})console.log(email.status)} catch (error) {console.error(error.message)}
حقلًا بحقل،
أين يذهب كل شيء.
كل خيار يقبله SendGrid، ومكانه في OpenEmail.
| SendGrid | OpenEmail | ملاحظات |
|---|---|---|
personalizations[].to | to | رسالة واحدة لكل تخصيص. |
reply_to | replyTo | عنوان واحد لكل رسالة. |
content[] | html, text | حقل واحد لكل نوع محتوى. |
template_id, dynamic_template_data | template: { id, props } | أعد إنشاء القالب في OpenEmail أولًا. |
categories, custom_args | tags | حتى 10 أزواج من المفاتيح والقيم. |
send_at | scheduledAt | تاريخ بدل ثواني Unix. |
tracking_settings | tracking: { opens, clicks } | مفتاحا تبديل في كل رسالة. |
attachments[].type | attachments[].contentType | بايتات أو Base64، بإجمالي 5 ميغابايت. |
batch_id | emails.cancel(id) | ألغِ كل رسالة بمعرّفها. |
asm.group_id | suppressions.add | تذهب إلغاءات الاشتراك إلى قائمة حظر واحدة. |
المحوّل
الصق شيفرة SendGrid لديك،
واستعدها مكتوبة لـ OpenEmail.
اختر مصدر الشيفرة ولغتها. تُزال المفاتيح المكتشفة في متصفحك، ولا يُحتفظ بشيء مما تلصقه.
إلى جانب الشيفرة،
أربع خطوات أخرى.
- 01
أضف نطاق الإرسال
أضفه في OpenEmail وانشر سجلات DNS التي يعرضها. يبدأ الإرسال حين يستجيب سجل التوقيع.
- 02
أنشئ مفتاح API
تبدأ المفاتيح بـ oe_live_ ولا تحمل إلا الصلاحيات التي تمنحها لها.
- 03
انقل خطافات الويب
أنشئ نقطة نهاية للأحداث المذكورة أدناه، وتحقّق من ترويسة X-OpenEmail-Signature في كل طلب.
- 04
انقل جهات الاتصال وقوائم الحظر
استورد جهات اتصالك كملف CSV في صفحة جمهور، وأضف العناوين التي حظرها SendGrid إلى قائمة الحظر.
أحداث خطافات الويب،
بأسماء جديدة.
كل حدث في SendGrid وحدث OpenEmail الذي يحل محله. يحمل كل طلب حدثًا واحدًا، موقّعًا.
| SendGrid | OpenEmail |
|---|---|
processed | email.sent |
delivered | email.delivered |
deferred | email.delivery_delayed |
bounce | email.bounced |
dropped | email.suppressed |
spamreport | email.complained |
open | email.opened |
click | email.clicked |
unsubscribe | suppression.added |
الانتقال من SendGrid،
أسئلة وأجوبة.
تنتقل من
مكان آخر؟
في كل دليل المحوّل نفسه وخريطة الحقول وقائمة التحقق.
حوّلت شيفرتك؟
أنشئ المفتاح الذي تقرؤه.
إنشاء مساحة عمل يستغرق دقيقة. أضف نطاقك، وأنشئ مفتاح API، وعيّن OPENEMAIL_API_KEY.