☰ فهرست مستندات · قالب‌های ایمیل
قالب‌های ایمیل
زبان ایمیل‌های تأیید ایمیل، بازیابی رمز و لینک یک‌بارمصرف را انتخاب کنید، موضوع، متن و دکمه‌ی خودتان را بنویسید و رنگ دکمه و مدت اعتبار هر پیوند را تعیین کنید. متن پیش‌فرض انگلیسی و فارسی.
ابرووا احراز هویت سه ایمیل می‌فرستد: تأیید ایمیل، بازیابی رمز و لینک یک‌بارمصرف. هر کدام یک متن پیش‌فرض انگلیسی و فارسی دارد. زبان پروژه را شما انتخاب می‌کنید، اپ می‌تواند آن را برای هر کاربر تعیین کند، و می‌توانید موضوع و متن خودتان را در ابرووا احراز هویت › قالب‌های ایمیل بنویسید.
مرحله ۱: انتخاب زبان#
دو تنظیم زبان هر ایمیل را تعیین می‌کنند، مثل Firebase:
| تنظیم | کجا | چه می‌کند |
|---|---|---|
| زبان قالب | کنسول › ابرووا احراز هویت › قالب‌های ایمیل | زبان همه‌ی ایمیل‌هایی که اپ بدون زبان می‌فرستد. پیش‌فرض انگلیسی. |
| languageCode | SDK، برای هر کاربر | زبان ایمیل‌های این کاربر. بر زبان قالب اولویت دارد. |
پیش از فرستادن لینک یک‌بارمصرف، بازیابی رمز یا تأیید ایمیل، زبان را در اپ تعیین کنید:
// Flutter
await AbrovaAuth.instance.setLanguageCode('fa'); // یا useDeviceLanguage()// iOS AbrovaAuth.shared.languageCode = "fa" // یا AbrovaAuth.shared.useAppLanguage()
// Android AbrovaAuth.shared.languageCode = "fa" // یا AbrovaAuth.shared.useAppLanguage()
// Web و React Native auth.languageCode = 'fa'; // یا auth.useDeviceLanguage()
مقدار یک برچسب زبان است، مثل fa، fa-IR یا en-US. زبانی که ابرووا برایش متن ندارد، زبان قالب را به کار می‌برد. بدون SDK، هدر x-abrova-locale را با درخواست بفرستید.
پیوند داخل ایمیل هم زبان را با خود دارد، پس صفحه‌های تأیید و بازیابی خود ابرووا به همان زبان باز می‌شوند.
languageCode به SDK نسخه‌ی 0.3.0 ابرووا احراز هویت نیاز دارد: Flutter، iOS، Android، Web یا React Native. با SDK قدیمی‌تر زبان قالب به کار می‌رود.
مرحله ۲: نوشتن متن خودتان#
ابرووا احراز هویت › قالب‌های ایمیل را باز کنید، ایمیل و زبان را انتخاب کنید و ویرایش کنید:
| فیلد | چه می‌کند |
|---|---|
| نام فرستنده | نامی که ایمیل از طرف آن می‌آید. خالی: نام پروژه‌ی شما. نشانی همان noreply@abrova.ir می‌ماند. |
| نشانی پاسخ | پاسخ‌ها به این نشانی می‌روند، مثلاً نشانی پشتیبانی شما. خالی: پاسخ‌ها دریافت نمی‌شوند. |
| موضوع | حداکثر ۱۵۰ نویسه، در یک خط. |
| متن | حداکثر ۲٬۰۰۰ نویسه متن ساده. یک خط خالی پاراگراف تازه می‌سازد. |
| نوشته‌ی دکمه | نوشته‌ی روی دکمه، حداکثر ۴۰ نویسه. |
| رنگ دکمه | رنگ برند شما برای دکمه، مثلاً #ff6600. نوشته‌ی روی آن سیاه یا سفید می‌شود، هر کدام خواناتر باشد. خالی: آبی ابرووا. |
این جای‌گذارها را در موضوع و متن به کار ببرید:
| جای‌گذار | به جایش می‌آید |
|---|---|
| %APP_NAME% | نام پروژه‌ی شما |
| %EMAIL% | نشانی ایمیل کاربر |
| %EXPIRES% | مدت اعتبار پیوند، به زبان ایمیل: ۷ دقیقه، ۲۴ ساعت، 15 minutes |
متن پیش‌فرض با «این پیوند یک بار کار می‌کند و تا %EXPIRES% معتبر است. اگر این درخواست از شما نبوده، این ایمیل را نادیده بگیرید.» تمام می‌شود. آن را تغییر دهید یا حذف کنید.
مرحله ۳: تعیین مدت اعتبار هر پیوند#
آن را کنار هر ایمیل، به دقیقه، تعیین کنید. برای هر دو زبان اعمال می‌شود و %EXPIRES% همیشه مقدار واقعی را نشان می‌دهد.
| ایمیل | پیش‌فرض | مجاز |
|---|---|---|
| لینک یک‌بارمصرف | ۱۵ دقیقه | ۵ تا ۶۰ دقیقه |
| بازیابی رمز | ۳۰ دقیقه | ۵ تا ۶۰ دقیقه |
| تأیید ایمیل | ۲۴ ساعت | ۱ ساعت تا ۷ روز |
دست‌کم ۵ دقیقه، چون رسیدن ایمیل ممکن است یکی دو دقیقه طول بکشد. لینک یک‌بارمصرف و پیوند بازیابی حداکثر یک ساعت کار می‌کنند، چون پیوند دزدیده‌شده کسی را وارد حساب می‌کند یا رمزش را عوض می‌کند. هر پیوند همچنان فقط یک بار کار می‌کند و پیوند تازه پیوندهای قبلی را باطل می‌کند.
پیش‌نمایش ایمیل را دقیقاً همان‌طور که فرستاده می‌شود نشان می‌دهد. استفاده از متن پیش‌فرض متن ابرووا را برای آن ایمیل و زبان برمی‌گرداند.
چه چیزی ثابت می‌ماند#
زیر متن شما، ابرووا همیشه دکمه و خود پیوند را اضافه می‌کند (برای برنامه‌های ایمیلی که دکمه را پنهان می‌کنند). این‌ها حذف نمی‌شوند، پس ایمیل ویرایش‌شده همیشه یک پیوند سالم و پیدا دارد. متن ساده است، نه HTML، و ایمیل از noreply@abrova.ir با نام فرستنده‌ی شما فرستاده می‌شود.
قدم‌های بعدی#
به‌روزرسانی: ۱۶ آبان ۱۴۰۵