---
title: "قالب‌های ایمیل"
description: "زبان ایمیل‌های تأیید ایمیل، بازیابی رمز و لینک یک‌بارمصرف را انتخاب کنید، موضوع، متن و دکمه‌ی خودتان را بنویسید و رنگ دکمه و مدت اعتبار هر پیوند را تعیین کنید. متن پیش‌فرض انگلیسی و فارسی."
product: auth
language: fa
url: https://abrova.ir/docs/auth/email-templates
updated: 2026-11-07
---

# قالب‌های ایمیل

زبان ایمیل‌های تأیید ایمیل، بازیابی رمز و لینک یک‌بارمصرف را انتخاب کنید، موضوع، متن و دکمه‌ی خودتان را بنویسید و رنگ دکمه و مدت اعتبار هر پیوند را تعیین کنید. متن پیش‌فرض انگلیسی و فارسی.

> **زبان کاربران شما**
>
> ابرووا احراز هویت سه ایمیل می‌فرستد: **تأیید ایمیل**، **بازیابی رمز** و **لینک یک‌بارمصرف**. هر کدام یک متن پیش‌فرض انگلیسی و فارسی دارد. زبان پروژه را شما انتخاب می‌کنید، اپ می‌تواند آن را برای هر کاربر تعیین کند، و می‌توانید موضوع و متن خودتان را در **ابرووا احراز هویت › قالب‌های ایمیل** بنویسید.

## مرحله 1: انتخاب زبان

دو تنظیم زبان هر ایمیل را تعیین می‌کنند، مثل Firebase:

| تنظیم | کجا | چه می‌کند |
| --- | --- | --- |
| `زبان قالب` | کنسول › ابرووا احراز هویت › قالب‌های ایمیل | زبان همه‌ی ایمیل‌هایی که اپ بدون زبان می‌فرستد. پیش‌فرض انگلیسی. |
| `languageCode` | SDK، برای هر کاربر | زبان ایمیل‌های این کاربر. بر زبان قالب اولویت دارد. |

پیش از فرستادن لینک یک‌بارمصرف، بازیابی رمز یا تأیید ایمیل، زبان را در اپ تعیین کنید:

```dart
// Flutter
await AbrovaAuth.instance.setLanguageCode('fa'); // یا useDeviceLanguage()
```

```swift
// iOS
AbrovaAuth.shared.languageCode = "fa" // یا AbrovaAuth.shared.useAppLanguage()
```

```kotlin
// Android
AbrovaAuth.shared.languageCode = "fa" // یا AbrovaAuth.shared.useAppLanguage()
```

```typescript
// Web و React Native
auth.languageCode = 'fa'; // یا auth.useDeviceLanguage()
```

مقدار یک برچسب زبان است، مثل `fa`، `fa-IR` یا `en-US`. زبانی که ابرووا برایش متن ندارد، زبان قالب را به کار می‌برد. بدون SDK، هدر `x-abrova-locale` را با درخواست بفرستید.

پیوند داخل ایمیل هم زبان را با خود دارد، پس صفحه‌های تأیید و بازیابی خود ابرووا به همان زبان باز می‌شوند.

> **نسخه‌ی SDK**
>
> `languageCode` به SDK نسخه‌ی **0.3.0** ابرووا احراز هویت نیاز دارد: Flutter، iOS، Android، Web یا React Native. با SDK قدیمی‌تر زبان قالب به کار می‌رود.

## مرحله 2: نوشتن متن خودتان

**ابرووا احراز هویت › قالب‌های ایمیل** را باز کنید، ایمیل و زبان را انتخاب کنید و ویرایش کنید:

| فیلد | چه می‌کند |
| --- | --- |
| `نام فرستنده` | نامی که ایمیل از طرف آن می‌آید. خالی: نام پروژه‌ی شما. نشانی همان noreply@abrova.ir می‌ماند. |
| `نشانی پاسخ` | پاسخ‌ها به این نشانی می‌روند، مثلاً نشانی پشتیبانی شما. خالی: پاسخ‌ها دریافت نمی‌شوند. |
| `موضوع` | حداکثر ۱۵۰ نویسه، در یک خط. |
| `متن` | حداکثر ۲٬۰۰۰ نویسه متن ساده. یک خط خالی پاراگراف تازه می‌سازد. |
| `نوشته‌ی دکمه` | نوشته‌ی روی دکمه، حداکثر ۴۰ نویسه. |
| `رنگ دکمه` | رنگ برند شما برای دکمه، مثلاً #ff6600. نوشته‌ی روی آن سیاه یا سفید می‌شود، هر کدام خواناتر باشد. خالی: آبی ابرووا. |

این جای‌گذارها را در موضوع و متن به کار ببرید:

| جای‌گذار | به جایش می‌آید |
| --- | --- |
| `%APP_NAME%` | نام پروژه‌ی شما |
| `%EMAIL%` | نشانی ایمیل کاربر |
| `%EXPIRES%` | مدت اعتبار پیوند، به زبان ایمیل: ۷ دقیقه، ۲۴ ساعت، 15 minutes |

متن پیش‌فرض با «این پیوند یک بار کار می‌کند و تا %EXPIRES% معتبر است. اگر این درخواست از شما نبوده، این ایمیل را نادیده بگیرید.» تمام می‌شود. آن را تغییر دهید یا حذف کنید.

## مرحله 3: تعیین مدت اعتبار هر پیوند

آن را کنار هر ایمیل، به دقیقه، تعیین کنید. برای هر دو زبان اعمال می‌شود و %EXPIRES% همیشه مقدار واقعی را نشان می‌دهد.

| ایمیل | پیش‌فرض | مجاز |
| --- | --- | --- |
| `لینک یک‌بارمصرف` | ۱۵ دقیقه | ۵ تا ۶۰ دقیقه |
| `بازیابی رمز` | ۳۰ دقیقه | ۵ تا ۶۰ دقیقه |
| `تأیید ایمیل` | ۲۴ ساعت | ۱ ساعت تا ۷ روز |

دست‌کم ۵ دقیقه، چون رسیدن ایمیل ممکن است یکی دو دقیقه طول بکشد. لینک یک‌بارمصرف و پیوند بازیابی حداکثر یک ساعت کار می‌کنند، چون پیوند دزدیده‌شده کسی را وارد حساب می‌کند یا رمزش را عوض می‌کند. هر پیوند همچنان فقط یک بار کار می‌کند و پیوند تازه پیوندهای قبلی را باطل می‌کند.

پیش‌نمایش ایمیل را دقیقاً همان‌طور که فرستاده می‌شود نشان می‌دهد. **استفاده از متن پیش‌فرض** متن ابرووا را برای آن ایمیل و زبان برمی‌گرداند.

## چه چیزی ثابت می‌ماند

زیر متن شما، ابرووا همیشه دکمه و خود پیوند را اضافه می‌کند (برای برنامه‌های ایمیلی که دکمه را پنهان می‌کنند). این‌ها حذف نمی‌شوند، پس ایمیل ویرایش‌شده همیشه یک پیوند سالم و پیدا دارد. متن ساده است، نه HTML، و ایمیل از [noreply@abrova.ir](mailto:noreply@abrova.ir) با نام فرستنده‌ی شما فرستاده می‌شود.

## قدم‌های بعدی

- [لینک یک‌بارمصرف](https://abrova.ir/docs/auth/magic-link)
- [ایمیل و رمز عبور](https://abrova.ir/docs/auth/email-password)