میل جت API

میل جت API

ستکا با API میل جت برای ارسال انبوه سازگار است. با پیکربندی تنظیمات در حساب میل جت و پایگاه داده ستکا، یک سرور پستی انبوه اختصاصی از طریق میل جت راه اندازی کنید. در برخی شرایط، تنظیمات باید روی تنظیمات DNS دامنه سفارشی نیز پیکربندی شوند.

در میل جت راه اندازی کنید

اعتبارنامه API را ایجاد کنید

برای شروع، وارد صفحه اطلاعات حساب میل جت شوید. سپس به بخش فرستنده ها و دامنه ها بروید و روی SMTP و ارسال تنظیمات API کلیک کنید.

سپس، تنظیمات پیکربندی SMTP را در یک دفترچه یادداشت کپی کنید. آنها را می توان در بخش پیکربندی (فقط SMTP) یافت. تنظیمات پیکربندی SMTP شامل آدرس سرور، گزینه امنیتی مورد نیاز (استفاده از SSL/TLS) و شماره پورت است. تنظیمات برای پیکربندی میل جت در ستکا مورد نیاز است که در بخش آخر پوشش داده شده است.

مهم

ستکا پورت 25 را در پایگاه داده های ستکا آنلاین و satkaerp.com مسدود می کند.

در مرحله بعد، روی دکمه با عنوان اعتبار API خود را بازیابی کنید کلیک کنید تا اعتبارنامه میل جت API را بازیابی کنید.


سپس، روی نماد چشم کلیک کنید تا کلید API نمایان شود. این کلید را در یک دفترچه یادداشت کپی کنید، زیرا به عنوان نام کاربری در پیکربندی ستکا عمل می کند. سپس بر روی دکمه ایجاد کلید مخفی کلیک کنید تا کلید مخفی تولید شود. این کلید را در یک دفترچه یادداشت کپی کنید، زیرا به عنوان رمز عبور در پیکربندی ستکا عمل می کند.

افزودن آدرس(های) فرستنده تایید شده

مرحله بعدی این است که یک آدرس فرستنده یا یک دامنه به تنظیمات حساب میل جت اضافه کنید تا آدرس ایمیل یا دامنه برای ارسال ایمیل با استفاده از سرورهای میل جت تأیید شود. ابتدا به صفحه اطلاعات حساب میل جت بروید. در مرحله بعد، روی پیوند افزودن دامنه فرستنده یا آدرس در زیر بخش فرستنده و دامنه کلیک کنید.

تعیین کنید که آیا آدرس ایمیل فرستنده یا کل دامنه باید به تنظیمات میل جت اضافه شود. اگر دسترسی DNS در دسترس باشد، ممکن است پیکربندی دامنه به طور کلی آسان تر باشد. برای مراحل افزودن دامنه به بخش یک دامنه اضافه کنید بروید.

توجه

یا تمام آدرس‌های ایمیل کاربران پایگاه داده ستکا که با استفاده از سرورهای میل جت ایمیل ارسال می‌کنند باید پیکربندی شوند یا دامنه(های) آدرس ایمیل کاربران را می‌توان پیکربندی کرد.

به‌طور پیش‌فرض، آدرس ایمیلی که در ابتدا در حساب میل جت تنظیم شده بود، به‌عنوان یک فرستنده مطمئن اضافه می‌شود. برای افزودن آدرس ایمیل دیگر، روی دکمه افزودن آدرس فرستنده کلیک کنید. سپس، آدرس ایمیلی را که برای ارسال از دامنه سفارشی پیکربندی شده است، اضافه کنید.


حداقل آدرس‌های ایمیل زیر باید در ارائه‌دهنده تنظیم و در میل جت تأیید شوند:

توجه
دامنه خود را با دامنه سفارشی پایگاه داده ستکا جایگزین کنید. اگر موردی وجود ندارد، از پارامتر سیستم satkaerp.com استفاده کنید.

پس از آن، فرم اطلاعات ایمیل را پر کنید و مطمئن شوید که نوع ایمیل مناسب را انتخاب کنید: ایمیل تراکنشی یا ایمیل های انبوه. پس از تکمیل فرم، ایمیل فعال سازی به آدرس ایمیل ارسال می شود و فرستنده مورد اعتماد می تواند فعال شود.


توصیه می شود تنظیمات SPF/DKIM/DMARC را در دامنه فرستنده تنظیم کنید.

مهم

اگر پایگاه داده از یک دامنه سفارشی استفاده نمی کند، برای تأیید آدرس فرستنده، باید یک نام مستعار موقت (از سه آدرس ایمیل ذکر شده در بالا) در ستکا معاملات برای ایجاد یک سرنخ تنظیم شود. سپس پایگاه داده قادر به دریافت ایمیل تایید و تایید اکانت ها می باشد.

یک دامنه اضافه کنید

با افزودن یک دامنه کامل به حساب میل جت، تمام آدرس های فرستنده مربوط به آن دامنه به طور خودکار برای ارسال ایمیل با استفاده از سرورهای میل جت تایید می شوند. ابتدا به صفحه اطلاعات حساب میل جت بروید. سپس روی یک دامنه فرستنده اضافه کنید یا آدرس لینک زیر قسمت فرستنده ها و دامنه ها کلیک کنید. سپس روی دامنه اضافه کنید کلیک کنید تا دامنه سفارشی اضافه شود.

توجه

دامنه باید به حساب میل جت اضافه شود و سپس از طریق DNS تأیید شود.

پس از آن، صفحه یک دامنه جدید اضافه کنید را در میل جت پر کنید و روی ادامه دهید کلیک کنید.


پس از افزودن دامنه، یک صفحه اعتبار سنجی پر می شود. مگر اینکه پایگاه داده ستکا روی فرض باشد (در این صورت، گزینه 1 را انتخاب کنید)، گزینه 2: ایجاد یک رکورد DNS را انتخاب کنید. اطلاعات رکورد TXT را در یک دفترچه یادداشت کپی کنید و سپس به ارائه دهنده DNS دامنه بروید تا اعتبار سنجی کامل شود.

راه اندازی در DNS دامنه

پس از دریافت اطلاعات رکورد TXT از حساب میل جت، یک رکورد TXT به DNS دامنه اضافه کنید. این فرآیند بسته به ارائه دهنده DNS متفاوت است. برای فرآیندهای پیکربندی خاص با ارائه دهنده مشورت کنید. اطلاعات رکورد TXT شامل میزبان و ارزش است. اینها را در فیلدهای مربوطه در رکورد TXT قرار دهید.

به اطلاعات حساب میل جت برگردید

پس از افزودن رکورد TXT به DNS دامنه، به حساب میل جت برگردید. سپس، به اطلاعات حساب  افزودن دامنه یا آدرس فرستنده، روی نماد چرخ دنده در کنار دامنه کلیک کنید و اعتبارسنجی را انتخاب کنید.


این عمل را نیز می توان با رفتن به صفحه دامنه و آدرس فرستنده در اطلاعات حساب میل جت و کلیک بر روی مدیریت کنید انجام داد.


در مرحله بعد، روی اکنون بررسی کنید کلیک کنید تا رکورد TXT که به دامنه اضافه شده است تأیید شود. اگر دامنه به درستی پیکربندی شود، یک صفحه موفقیت ظاهر می شود.

پس از راه اندازی موفقیت آمیز دامنه، گزینه ای برای احراز هویت این دامنه (SPF/DKIM) وجود دارد. این دکمه ارائه دهنده SPF و DKIM را پر می کند.

راه اندازی در ستکا

برای تکمیل تنظیمات، به پایگاه داده ستکا بروید و به تنظیمات بروید. با روشن بودن حالت برنامه‌نویس (حالت اشکال‌زدایی)، به منوی فنی  ایمیل  سرورهای ایمیل خروجی بروید. سپس با کلیک بر روی دکمه ایجاد یک پیکربندی سرور خروجی جدید ایجاد کنید.


سپس، سرور SMTP (satkaerp.com)، شماره پورت (587 یا 465)، و امنیت (SSL/TLS) را که قبلاً از حساب میل جت کپی شده بود، وارد کنید. آنها همچنین می توانند در اینجا پیدا شوند. توصیه می شود از SSL/TLS استفاده کنید حتی اگر میل جت به آن نیاز نداشته باشد.


برای نام کاربری، کلید API را وارد کنید. برای رمز عبور، کلید راز را که قبلاً از حساب میل جت در دفترچه یادداشت کپی شده بود وارد کنید. این تنظیمات را می‌توانید در میل جت  تنظیمات حساب  تنظیمات SMTP و ارسال API پیدا کنید.


سپس، اگر از سرور میل جت برای ارسال ایمیل انبوه استفاده می شود، مقدار اولویت را بالاتر از هر سرور یا سرور ایمیل تراکنشی قرار دهید. در نهایت تنظیمات را ذخیره کرده و اتصالات را تست کنید.

توجه



برای اینکه ویژگی اعلان ها با استفاده از میل جت کار کند، سه تنظیمات وجود دارد که باید در ستکا تنظیم شوند.


فیلتر From باید روی پیکربندی سرور تنظیم شود. توصیه می شود آن را به عنوان یک دامنه و نه یک آدرس ایمیل کامل تنظیم کنید. در دو مرحله بعدی باید با دامنه مطابقت داشته باشد. برای اطلاعات بیشتر، اسناد فیلتر FROM را بررسی کنید.


پارامتر سیستم satkaerp.com باید دارای مقدار satkaerp.com باشد.


پارامتر سیستم satkaerp.com باید مقدار satkaerp.com را داشته باشد. دامنه خود را با دامنه سفارشی پایگاه داده ستکا جایگزین کنید. اگر موردی وجود ندارد، از پارامتر سیستم satkaerp.com استفاده کنید.


برای اطلاعات بیشتر، اسناد "استفاده از یک آدرس ایمیل منحصر به فرد" را بررسی کنید.


با فعال کردن حالت توسعه دهنده (حالت اشکال زدایی) می توان به پارامترهای سیستم دسترسی داشت.

پس از تکمیل تنظیمات، پایگاه داده ستکا آماده استفاده از سرور ایمیل میل جت برای ارسال انبوه یا ایمیل های تراکنشی است.