✉️ Email (IMAP / SMTP)
PulseHub использует SMTP для отправки и IMAP для получения электронной почты. Это означает, что PulseHub работает с любым почтовым провайдером, предоставляющим стандартный доступ IMAP/SMTP: Gmail, Outlook, Zoho, ваш собственный почтовый сервер, Mailgun и др.
Предварительные требования
- Учётная запись электронной почты с включённым доступом IMAP
- Учётные данные SMTP для отправки
- Для Gmail: необходимо создать пароль приложения (не обычный пароль Google), если включена двухфакторная аутентификация
Шаги настройки
1. Добавьте канал в PulseHub
Перейдите в Channels → Add Channel, выберите Email и заполните:
| Поле | Описание |
|---|---|
| SMTP Host | например, smtp.gmail.com, mail.yourdomain.com |
| SMTP Port | 587 (STARTTLS) или 465 (SSL) |
| SMTP Username | Обычно ваш полный адрес электронной почты |
| SMTP Password | Ваш пароль электронной почты или пароль приложения |
| From Email | Адрес, отображаемый как отправитель (может быть псевдонимом) |
| IMAP Host | например, imap.gmail.com, mail.yourdomain.com |
| IMAP Port | 993 (SSL, рекомендуется) или 143 (STARTTLS) |
2. Настройте Cron для входящей почты
В отличие от других каналов, где провайд еры отправляют webhooks в PulseHub, электронная почта работает наоборот: PulseHub опрашивает ваш почтовый ящик через IMAP каждую минуту с помощью cron-задачи.
Если расширение imap отсутствует:
- cPanel: Перейдите в Select PHP Version → отметьте
imap→ Сохранить - Plesk: Перейдите в PHP Settings → Extensions → включите
imap - VPS: Выполните
sudo apt install php-imap
Настройка Gmail
- Включите IMAP в Gmail Settings → Forwarding and POP/IMAP → Enable IMAP
- Если включена двухфакторная аутентификация, создайте пароль приложения: Google Account → Security → App Passwords
- Используйте следующие настройки:
| Поле | Значение |
|---|---|
| SMTP Host | smtp.gmail.com |
| SMTP Port | 587 |
| IMAP Host | imap.gmail.com |
| IMAP Port | 993 |
Частые проблемы
| Симптом | Вероятная причина |
|---|---|
| Письма не импортируются | Расширение imap не загружено или неверные учётные данные IMAP |
| Ошибка "SSL certificate" | Попробуйте порт 143 с /tls вместо /ssl |
| Отправленные письма не доходят | mail() не настроен на VPS — настройте локальный MTA |
| Импорт дублированных сообщений | Дедупликация через external_id = Message-ID предотвращает настоящие дубли |