Настройка Email / SMTP
FeedbackPulse отправляет различные транзакционные письма. Правильная настройка email важна для:
- Приветственных писем новым арендаторам
- Ссылок приглашений в команду
- Писем сброса пароля
- Верификации через email OTP (для форм обратной связи)
- Ежедневных/еженедельных дайджестов
- Запланированных отчётов
- Предупреждений об использовании
- Уведомлений об изменении плана
⚙️ Методы настройки
Метод 1: Через панель администратора (рекомендуется)
- Войдите как суперадминистратор
- Перейдите в Администратор → Настройки → Email
- Заполните SMTP-данные
- Нажмите Отправить тестовое письмо для проверки
- Сохраните
Метод 2: Через файл .env
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
[email protected]
MAIL_FROM_NAME="FeedbackPulse"
📮 Настройка для конкретных провайдеров
📧 Gmail
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_app_password
MAIL_ENCRYPTION=tls
⚠️ Важно: Gmail требует Пароль приложения, а не ваш обычный пароль.
- Перейдите в Безопасность аккаунта Google
- Включите двухэтапную верификацию (обязательно)
- Перейдите в Пароли приложений → выберите «Почта» → сгенерируйте
- Используйте сгенерированный 16-символьный пароль
🔴 Лимиты Gmail: 500 писем/день (личный) или 2000/день (Workspace). Не рекомендуется для production SaaS.
🔫 Mailgun
MAIL_HOST=smtp.mailgun.org
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_mailgun_smtp_password
MAIL_ENCRYPTION=tls
- Зарегистрируйтесь на Mailgun
- Добавьте домен → верифицируйте DNS-записи
- Перейдите в Sending → Domain Settings → SMTP credentials
- Скопируйте SMTP-пароль
📦 Amazon SES
MAIL_HOST=email-smtp.us-east-1.amazonaws.com
MAIL_PORT=587
MAIL_USERNAME=your_ses_smtp_username
MAIL_PASSWORD=your_ses_smtp_password
MAIL_ENCRYPTION=tls
- Перейдите в AWS SES Console
- Верифицируйте домен
- Перейдите в SMTP Settings → Create SMTP Credentials
- Выйдите из режима sandbox для production
📨 SendGrid
MAIL_HOST=smtp.sendgrid.net
MAIL_PORT=587
MAIL_USERNAME=apikey
MAIL_PASSWORD=your_sendgrid_api_key
MAIL_ENCRYPTION=tls
💡 Примечание: Имя пользователя буквально
apikey(не ваш email). Пароль — это ваш API-ключ SendGrid.
✉️ Postmark
MAIL_HOST=smtp.postmarkapp.com
MAIL_PORT=587
MAIL_USERNAME=your_postmark_server_api_token
MAIL_PASSWORD=your_postmark_server_api_token
MAIL_ENCRYPTION=tls
🔵 ZOHO Mail
MAIL_HOST=smtp.zoho.com
MAIL_PORT=587
[email protected]
MAIL_PASSWORD=your_zoho_password
MAIL_ENCRYPTION=tls
🧪 Mailtrap (только для тестирования!)
MAIL_HOST=sandbox.smtp.mailtrap.io
MAIL_PORT=587
MAIL_USERNAME=your_mailtrap_username
MAIL_PASSWORD=your_mailtrap_password
MAIL_ENCRYPTION=tls
⚠️ Mailtrap только для разработки/тестирования. Письма перехватываются в вашем inbox Mailtrap и никогда не доставляются реальным получателям.
🧪 Тестирование email
Через панель администратора
- Перейдите в Администратор → Настройки → Email
- Нажмите Отправить тестовое письмо
- Проверьте inbox
Через командную строку
php artisan tinker
Mail::raw('Test email from FeedbackPulse', function ($message) {
$message->to('[email protected]')->subject('SMTP Test');
});
📨 Письма, отправляемые FeedbackPulse
| Письмо | Когда | Получатель |
|---|---|---|
| Приветственное | Регистрация нового арендатора | Администратор арендатора |
| Приглашение в команду | Администратор приглашает участника | Email приглашённого |
| Изменение плана | Изменение подписки | Администратор арендатора |
| Новое обращение | Получена новая обратная связь | Администратор/сотрудник арендатора |
| Email-дайджест | Ежедневное/еженедельное расписание | Администратор арендатора |
| Запланированный отчёт | Ежедневно/еженедельно/ежемесячно | Администратор арендатора |
| Предупреждение об использовании | 90%+ от лимита плана | Администратор арендатора |
| Сброс пароля | Пользователь запрашивает сброс | Запросивший пользователь |
| Верификация email | Новая регистрация | Новый пользователь |
| OTP-код | Форма обратной связи с OTP | Конечный пользователь, отправляющий обратную связь |
🐛 Устранение неполадок email
| Проблема | Решение |
|---|---|
| Письма не отправляются | Проверьте настройки SMTP в .env. Попробуйте MAIL_MAILER=log для теста без SMTP. Проверьте storage/logs/laravel.log. |
| Письма попадают в спам | Добавьте записи SPF, DKIM и DMARC в DNS вашего домена. Используйте надёжного SMTP-провайдера. |
| «Connection timed out» | Порт 587/465 может быть заблокирован вашим хостинг-провайдером. Попробуйте другой порт или провайдера. |
| Ошибка Gmail «Less secure apps» | Используйте Пароль приложения. Смотрите раздел Gmail выше. |
| Задержка писем | Если используете QUEUE_CONNECTION=database, убедитесь, что работник очереди запущен. |