رفتن به محتوای اصلی
سندک
شروع رایگان

مستنداتشروع

شروع سریع

از ساخت حساب تا اولین ایمیل، در چند قدم.

آخرین ویرایش: ۲۱ آبان ۱۴۰۵

برای اولین ارسال به سه چیز نیاز دارید: یک دامنه‌ی تأییدشده، یک کلید، و یک درخواست. هر قدم چند دقیقه است؛ بیشترین زمان معمولاً صرف رسیدن رکوردهای DNS می‌شود.

۱. دامنه را اضافه کنید

در پنل، «دامنه‌ها» را باز کنید و نام دامنه‌ای که از آن ایمیل می‌فرستید را وارد کنید. اگر از shop.ir می‌فرستید، همان را بنویسید؛ اگر از mail.shop.ir می‌فرستید، زیردامنه را جدا اضافه کنید.

پنل سه رکورد CNAME نشان می‌دهد. آن‌ها را در DNS دامنه‌تان بگذارید و «بررسی» را بزنید. جزئیات در افزودن دامنه آمده است.

۲. کلید بسازید

در «کلیدها» یک کلید تازه بسازید. راز آن با sd_live_ شروع می‌شود و فقط یک بار نشان داده می‌شود؛ همان لحظه جایی امن نگهش دارید. همین راز هم رمز SMTP است و هم توکن API.

نکته: اگر راز را گم کردید، بازیابی ندارد. کلید را بچرخانید یا کلید تازه بسازید. برای جزئیات ببینید کلیدها.

۳. بفرستید

با API:

cURL
curl https://api.sendak.ir/v1/emails \
  -H "Authorization: Bearer sd_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@shop.ir",
    "to": ["you@example.com"],
    "subject": "اولین ایمیل",
    "text": "سلام از سندک"
  }'

نشانی from باید روی دامنه‌ی تأییدشده‌ی شما باشد. پاسخ موفق 202 است و یعنی ایمیل در صف قرار گرفت:

202 Accepted
{
  "data": [
    { "to": "you@example.com", "id": "01JCX9…", "status": "queued" }
  ]
}

یا با SMTP؛ تنظیمات در SMTP آمده است.

۴. تحویل را ببینید

در «فعالیت» ایمیل را پیدا کنید. هر ایمیل یک خط زمانی دارد: در صف، ارسال، تحویل، و اگر ردیابی روشن باشد باز شدن و کلیک. همان رویدادها را می‌توانید با وب‌هوک به سرور خودتان بگیرید.

قدم بعدی