✉️ Email (IMAP / SMTP)
PulseHub utilise SMTP pour envoyer des emails et IMAP pour les recevoir. Cela signifie que PulseHub fonctionne avec tout fournisseur de messagerie exposant un accès IMAP/SMTP standard : Gmail, Outlook, Zoho, votre propre serveur mail, Mailgun, etc.
Prérequis
- Un compte email avec accès IMAP activé
- Identifiants SMTP pour l'envoi
- Pour Gmail : vous devez créer un Mot de Passe d'Application (pas votre mot de passe Google habituel) si la 2FA est activée
Étapes de Configuration
1. Ajouter le Canal dans PulseHub
Allez dans Canaux → Ajouter un Canal, sélectionnez Email, et remplissez :
| Champ | Description |
|---|---|
| SMTP Host | ex. smtp.gmail.com, mail.votredomaine.com |
| SMTP Port | 587 (STARTTLS) ou 465 (SSL) |
| SMTP Username | Généralement votre adresse email complète |
| SMTP Password | Votre mot de passe email ou mot de passe d'application |
| From Email | L'adresse qui apparaît comme expéditeur (peut être un alias) |
| IMAP Host | ex. imap.gmail.com, mail.votredomaine.com |
| IMAP Port | 993 (SSL, recommandé) ou 143 (STARTTLS) |
2. Configurer le Cron pour l'Email Entrant
Contrairement aux autres canaux où les fournisseurs envoient des webhooks à PulseHub, l'email fonctionne à l'inverse : PulseHub interroge votre boîte via IMAP chaque minute en utilisant la tâche cron.
Si l'extension imap est manquante :
- cPanel : Allez dans Select PHP Version → cochez la case
imap→ Enregistrer - Plesk : Allez dans PHP Settings → Extensions → activer
imap - VPS : Exécutez
sudo apt install php-imap
Configuration Gmail
- Activez IMAP dans Paramètres Gmail → Transfert et POP/IMAP → Activer IMAP
- Si la 2FA est activée, créez un Mot de Passe d'Application : Compte Google → Sécurité → Mots de passe d'application
- Utilisez ces paramètres :
| Champ | Valeur |
|---|---|
| SMTP Host | smtp.gmail.com |
| SMTP Port | 587 |
| IMAP Host | imap.gmail.com |
| IMAP Port | 993 |
Problèmes Courants
| Symptôme | Cause Probable |
|---|---|
| Aucun email importé | Extension imap non chargée, ou mauvais identifiants IMAP |
| Erreur « SSL certificate » | Essayez le port 143 avec /tls au lieu de /ssl |
| Les emails envoyés n'arrivent pas | mail() non configuré sur VPS — configurez un MTA local |
| Importation de messages en double | La déduplication via external_id = Message-ID empêche les vrais doublons |