File d'Attente et Workers
Paramètres → Avancé → File d'Attente et Workers affiche le pilote de file d'attente actuel, le type de connexion et le statut des workers de votre installation LeadHub.
Rôle de la File d'Attente
La file d'attente traite tout le travail en arrière-plan dans LeadHub :
| Tâche | Priorité de File |
|---|---|
| Envoi d'e-mails (transactionnels, séquences) | Haute |
| Traitement des webhooks entrants des sources de prospects | Haute |
| Appel des APIs d'intégration sortantes (sync CRM, Zapier, etc.) | Par défaut |
| Exécution des étapes d'automatisation (délais, actions) | Par défaut |
| Génération de rapports et exports | Basse |
| Envoi de SMS / messages WhatsApp | Par défaut |
Lorsqu'un prospect arrive ou qu'une automatisation se déclenche, l'action est mise en file d'attente plutôt qu'exécutée de façon synchrone. Cela empêche les appels API lents de bloquer la requête web.
Pilotes de File d'Attente
| Pilote | Description |
|---|---|
| Fichier (base de données) | Par défaut. Les tâches sont stockées dans la table jobs de la base de données. Traitées par la tâche cron. Pas de Redis, pas de Supervisor nécessaire. |
| Redis | File d'attente en mémoire plus rapide. Nécessite Redis et Supervisor (ou Horizon) sur le serveur. Recommandé pour les installations à fort volume. |
| Sync | Exécute les tâches immédiatement dans le processus. Utilisé uniquement dans les environnements de test. Ne pas utiliser en production. |
Hébergement mutualisé : La file d'attente par fichiers de LeadHub fonctionne sur n'importe quel plan d'hébergement mutualisé avec une tâche cron. Vous n'avez pas besoin de Redis, Supervisor ou d'accès SSH.
Traitement de la File d'Attente (Tâche Cron)
La file d'attente est traitée par une seule tâche cron qui doit être configurée sur votre serveur.
Hébergement Mutualisé cPanel
- Connectez-vous à cPanel → Tâches Cron.
- Définissez le planning sur chaque minute (
* * * * *). - Définissez la commande sur :
Remplacez le chemin par le chemin absolu vers votre installation LeadHub.
php /home/votrenomdutilisateur/public_html/cron.php >> /dev/null 2>&1
Consultez le Guide Hébergement Mutualisé pour les instructions cPanel complètes.
VPS / Serveur Dédié (Linux crontab)
* * * * * cd /var/www/leadhub && php artisan queue:work --once --max-time=55 >> /dev/null 2>&1
Ou avec un gestionnaire de processus (Supervisor) :
[program:leadhub-worker]
command=php /var/www/leadhub/artisan queue:work --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
user=www-data
Page de Statut des Workers
La page File d'Attente et Workers dans le panneau d'administration affiche :
| Information | Description |
|---|---|
| Connexion | Nom de la connexion de file d'attente actuelle (depuis config/queue.php) |
| Pilote | Le pilote de file d'attente utilisé (database, redis, sync) |
| Horizon | Si Laravel Horizon est installé (pour la surveillance avancée basée sur Redis) |
Cette page est en lecture seule. Pour changer le pilote, mettez à jour
QUEUE_CONNECTIONdans votre fichier.env.
Tâches Échouées
Si une tâche en file d'attente échoue (ex. une API d'intégration renvoie une erreur), LeadHub réessaie jusqu'à 3 fois avec un backoff exponentiel. Après 3 échecs, la tâche est marquée comme échouée.
Les livraisons d'intégration échouées sont visibles dans :
- Intégrations → Journal Webhook — pour les échecs de webhook sortant
- Intégrations → Journaux de Sync — pour les échecs de sync CRM/marketing par e-mail
Vérification de l'État de la File d'Attente
Signes que le worker fonctionne correctement :
- Les automatisations se déclenchent dans les quelques minutes suivant un événement
- Les intégrations sortantes s'exécutent peu après l'arrivée d'un prospect
- Les séquences d'e-mails s'envoient selon le planning
- Les exports se complètent et deviennent téléchargeables
Signes que la file d'attente ne fonctionne PAS :
- Les automatisations ne se déclenchent jamais
- Les synchronisations d'int égration sont bloquées en « en attente »
- Les e-mails ne sont jamais envoyés
Correction : Vérifiez que votre tâche cron est configurée et active. Utilisez cPanel → Tâches Cron pour vérifier que l'entrée existe avec le bon chemin.
Questions Fréquentes
Q : Combien de temps faut-il pour qu'un nouveau prospect se synchronise avec mon CRM ? La file d'attente tourne par défaut chaque minute. La plupart des prospects se synchronisent dans les 60 à 90 secondes suivant leur arrivée.
Q : Puis-je faire tourner plusieurs workers pour un traitement plus rapide ?
Oui, sur les serveurs VPS/dédiés vous pouvez faire tourner plusieurs processus queue:work via Supervisor. Sur l'hébergement mutualisé, une seule tâche cron est le maximum.
Q : Ai-je besoin de Redis ? Non. La file d'attente par fichiers (base de données) est prête pour la production pour des volumes de prospects typiques (jusqu'à plusieurs milliers de prospects par jour). Pour des volumes très élevés (10 000+ prospects/jour), Redis est recommandé.