مهاجرت از 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 را تنظیم کنید.