Warteschlange & Worker
Einstellungen → Erweitert → Warteschlange & Worker zeigt den aktuellen Warteschlangen-Treiber, Verbindungstyp und Worker-Status für Ihre LeadHub-Installation.
Was die Warteschlange macht
Die Warteschlange verarbeitet alle Hintergrundaufgaben in LeadHub:
| Aufgabe | Warteschlangenpriorität |
|---|---|
| E-Mails senden (Transaktional, Sequenzen) | Hoch |
| Eingehende Webhooks von Lead-Quellen verarbeiten | Hoch |
| Ausgehende Integration-APIs aufrufen (CRM-Sync, Zapier usw.) | Standard |
| Automatisierungsschritte ausführen (Verzögerungen, Aktionen) | Standard |
| Berichte und Exporte generieren | Niedrig |
| SMS / WhatsApp-Nachrichten senden | Standard |
Wenn ein Lead ankommt oder eine Automatisierung ausgelöst wird, wird die Aktion in die Warteschlange gestellt, anstatt synchron ausgeführt zu werden. Dies verhindert, dass langsame API-Aufrufe die Web-Anfrage blockieren.
Warteschlangen-Treiber
| Treiber | Beschreibung |
|---|---|
| Datei (Datenbank) | Standard. Jobs werden in der jobs-Datenbanktabelle gespeichert. Vom Cron-Job verarbeitet. Kein Redis, kein Supervisor erforderlich. |
| Redis | Schnellere, In-Memory-Warteschlange. Erfordert Redis und Supervisor (oder Horizon) auf dem Server. Empfohlen für hochvolumige Installationen. |
| Sync | Führt Jobs sofort im Prozess aus. Nur in Testumgebungen verwendet. Nicht in der Produktion verwenden. |
Shared Hosting: LeadHub's dateibasierte Standardwarteschlange funktioniert auf jedem Shared-Hosting-Plan mit einem Cron-Job. Sie benötigen kein Redis, Supervisor oder SSH-Zugang.
Die Warteschlange verarbeiten (Cron-Job)
Die Warteschlange wird von einem einzelnen Cron-Job verarbeitet, der auf Ihrem Server konfiguriert sein muss.
cPanel Shared Hosting
- Melden Sie sich bei cPanel → Cron Jobs an.
- Setzen Sie den Zeitplan auf jede Minute (
* * * * *). - Setzen Sie den Befehl auf:
Ersetzen Sie den Pfad durch den absoluten Pfad zu Ihrer LeadHub-Installation.
php /home/yourusername/public_html/cron.php >> /dev/null 2>&1
VPS / Dedizierter Server (Linux crontab)
* * * * * cd /var/www/leadhub && php artisan queue:work --once --max-time=55 >> /dev/null 2>&1
Oder mit einem Prozessmanager (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
Worker-Statusseite
Die Seite Warteschlange & Worker im Admin-Bereich zeigt:
| Information | Beschreibung |
|---|---|
| Verbindung | Aktueller Warteschlangenverbindungsname (aus config/queue.php) |
| Treiber | Der verwendete Warteschlangen-Treiber (database, redis, sync) |
| Horizon | Ob Laravel Horizon installiert ist (für Redis-basiertes erweitertes Monitoring) |
Diese Seite ist schreibgeschützt. Um den Warteschlangen-Treiber zu ändern, aktualisieren Sie
QUEUE_CONNECTIONin Ihrer.env-Datei.
Fehlgeschlagene Jobs
Wenn ein Job in der Warteschlange fehlschlägt (z. B. gibt eine Integrations-API einen Fehler zurück), versucht LeadHub es bis zu 3 Mal mit exponentiellem Backoff erneut. Nach 3 Fehlern wird der Job als fehlgeschlagen markiert.
Fehlgeschlagene Integrationslieferungen sind sichtbar unter:
- Integrationen → Webhook-Protokoll — für ausgehende Webhook-Fehler
- Integrationen → Integrations-Synchronisierungsprotokolle — für CRM/E-Mail-Marketing-Synchronisierungsfehler
Warteschlangen-Gesundheit prüfen
Zeichen dafür, dass der Warteschlangen-Worker korrekt läuft:
- Automatisierungen werden innerhalb weniger Minuten nach einem Ereignis ausgelöst
- Ausgehende Integrationen werden kurz nach dem Eingang eines Leads ausgeführt
- E-Mail-Sequenzen werden planmäßig gesendet
- Exporte werden abgeschlossen und können heruntergeladen werden
Zeichen dafür, dass die Warteschlange NICHT läuft:
- Automatisierungen werden nie ausgelöst
- Integrations-Synchronisierungen bleiben als "ausstehend" stecken
- E-Mails werden nie gesendet
Lösung: Prüfen Sie, ob Ihr Cron-Job konfiguriert ist und läuft. Verwenden Sie cPanel → Cron Jobs, um zu überprüfen, ob der Eintrag vorhanden ist und den richtigen Pfad hat.
Häufig gestellte Fragen
F: Wie lange dauert es, bis ein neuer Lead mit meinem CRM synchronisiert wird? Die Warteschlange läuft standardmäßig jede Minute. Die meisten Leads werden innerhalb von 60–90 Sekunden nach dem Eingang synchronisiert.
F: Kann ich mehrere Worker für eine schnellere Verarbeitung ausführen?
Ja, auf VPS/dedizierten Servern können Sie mehrere queue:work-Prozesse über Supervisor ausführen. Auf Shared Hosting ist ein einzelner Cron-Job das Maximum.
F: Benötige ich Redis? Nein. Die dateibasierte (Datenbank-)Warteschlange ist für typische Lead-Volumen (bis zu mehreren tausend Leads pro Tag) produktionstauglich. Bei sehr hohen Volumen (10.000+ Leads/Tag) wird Redis empfohlen.