✉️ Email (IMAP / SMTP)
O PulseHub usa SMTP para enviar emails e IMAP para receber. Isso significa que o PulseHub funciona com qualquer provedor de email que exponha acesso padrao IMAP/SMTP: Gmail, Outlook, Zoho, seu proprio servidor de email, Mailgun, etc.
Pre-requisitos
- Uma conta de email com acesso IMAP habilitado
- Credenciais SMTP para envio
- Para Gmail: voce deve criar uma Senha de Aplicativo (nao sua senha normal do Google) se a verificacao em duas etapas estiver ativada
Passos de Configuracao
1. Adicionar o Canal no PulseHub
Va ate Channels → Add Channel, selecione Email e preencha:
| Campo | Descricao |
|---|---|
| SMTP Host | ex: smtp.gmail.com, mail.yourdomain.com |
| SMTP Port | 587 (STARTTLS) ou 465 (SSL) |
| SMTP Username | Geralmente seu endereco de email completo |
| SMTP Password | Sua senha de email ou senha especifica do aplicativo |
| From Email | O endereco que aparece como remetente (pode ser um alias) |
| IMAP Host | ex: imap.gmail.com, mail.yourdomain.com |
| IMAP Port | 993 (SSL, recomendado) ou 143 (STARTTLS) |
2. Configurar Cron para Email de Entrada
Diferente de outros canais onde os provedores enviam webhooks para o PulseHub, o email funciona ao contrario: o PulseHub consulta sua caixa de entrada via IMAP a cada minuto usando o cron job.
Se a extensao imap estiver ausente:
- cPanel: Va ate Select PHP Version → marque a caixa
imap→ Salvar - Plesk: Va ate PHP Settings → Extensions → habilite
imap - VPS: Execute
sudo apt install php-imap
Configuracao do Gmail
- Habilite IMAP em Gmail Settings → Forwarding and POP/IMAP → Enable IMAP
- Se a verificacao em duas etapas estiver ativada, crie uma Senha de Aplicativo: Google Account → Security → App Passwords
- Use estas configuracoes:
| Campo | Valor |
|---|---|
| SMTP Host | smtp.gmail.com |
| SMTP Port | 587 |
| IMAP Host | imap.gmail.com |
| IMAP Port | 993 |
Problemas Comuns
| Sintoma | Causa Provavel |
|---|---|
| Emails nao importados | Extensao imap nao carregada ou credenciais IMAP incorretas |
| Erro "SSL certificate" | Tente a porta 143 com /tls em vez de /ssl |
| Emails enviados nao chegam | mail() nao configurado no VPS — configure um MTA local |
| Importacao de mensagens duplicadas | A deduplicacao via external_id = Message-ID evita duplicatas reais |