Callback-Anfragen: Einrichtung und Hilfe

Laden Sie die ZIP-Datei über "Modules" > "Module Manager" > "Upload a module" hoch und installieren Sie sie. Sie können das entpackte Modul auch in /modules/mprcallback ablegen und über die Modulliste installieren. Die Installation erstellt die Warteschlangentabellen, registriert die verfügbaren Hooks und fügt Rückrufanfragen unter dem für Ihre PrestaShop-Version verfügbaren Menü "Customer Service" oder "Customers" hinzu.

Prüfen Sie das Widget in Ihrem tatsächlichen Theme, da die Platzierungen im Kopfbereich und auf Produktseiten Theme-Hooks verwenden.

Wählen Sie den zu konfigurierenden Shop. Öffnen Sie Rückrufanfragen > Einstellungen > Konfiguration. Die Registerkarten sind Zeitplanung, Platzierung, Texte, Benachrichtigungen und Datenschutz und Missbrauch. Auch Ihr Wochenplan und die Anfragewarteschlange sind auf diesen Shop beschränkt.

Zeitzone und Rückrufziel bestätigen

Prüfen Sie in Zeitplanung diese Einstellungen, bevor Sie Öffnungszeiten hinzufügen:

Klicken Sie auf Speichern. Eine falsche oder nicht verfügbare Zeitzone kann verhindern, dass die Zeitplanung Zeitfenster anbietet.

Wochenplan eingeben

Öffnen Sie Rückrufanfragen > Geschäftszeiten. Fügen Sie für jeden Arbeitstag ein oder mehrere Intervalle mit Uhrzeiten im Format HH:MM hinzu. Lassen Sie einen Tag leer, wenn Sie geschlossen haben. Speichern Sie den Plan.

Verwenden Sie für eine Mittagspause zwei Intervalle, etwa 09:00 bis 12:00 und 13:00 bis 17:00. Die angebotenen Zeitfenster bleiben innerhalb eines Öffnungsintervalls. Aktivieren Sie über Mitternacht für ein Intervall wie 22:00 bis 02:00, das am nächsten Tag endet.

Solange kein gültiges zukünftiges Öffnungsintervall besteht, kann das Formular kein Zeitfenster anbieten und nimmt keine Rückrufanfrage an. Prüfen Sie die Verfügbarkeitsanzeige unter dem Plan, um zu sehen, was einem Besucher jetzt angeboten würde.

Ausnahmen und Feiertage hinzufügen

Verwenden Sie ein Ausnahmedatum, um einen Tag zu schließen oder sein Öffnungsintervall zu ersetzen. Eine Ausnahme überschreibt diesen Kalendertag, einschließlich des Intervallteils, der vom Vorabend hineinreicht. Prüfen Sie nach dem Hinzufügen einer Ausnahme die über Mitternacht laufenden Zeitpläne.

Wählen Sie ein Land und ein Jahr, um gesetzliche Feiertage als geschlossene Ausnahmedaten zu importieren. Gleichen Sie die importierten Daten mit den Feiertagen ab, die Ihr Team tatsächlich einhält. Entfernen oder bearbeiten Sie eine Ausnahme, wenn wieder der normale Wochenplan gelten soll.

Das Widget bietet konkrete Zeitfenster statt eines Countdowns. Jedes Zeitfenster hat einen Beginn, ein Ende und eine Frist, die in UTC gespeichert werden. Die Zeitzone des Plans bestimmt die lokale Formulierung. Eine spätere Änderung dieser Zeitzone verschiebt die Frist einer bestehenden Anfrage nicht.

Zeitfenster außer ASAP benötigen mindestens 15 Minuten nutzbare Öffnungszeit. Außerhalb der Geschäftszeiten erklärt der Dialog, dass Rückrufe während der Geschäftszeiten erfolgen. Die Zeile „normalerweise innerhalb von ... Minuten“ erscheint nur, wenn der Shop geöffnet ist.

Prüfen Sie nach einer Änderung der Zeiten sowohl die aktuelle Verfügbarkeitsvorschau als auch eine Anfrage im Frontoffice. Ein Shop, der nur am frühen Nachmittag geöffnet ist, bietet möglicherweise keine Auswahl Vormittag oder Später heute für denselben Tag, da diese Optionen die festen Grenzen Mittag und 16:00 verwenden.

Schaltflächen konfigurieren

Öffnen Sie Einstellungen > Konfiguration > Platzierung.

Wählen Sie für gezielte Seiten Nur auf den ausgewählten Produkten, Kategorien und Seiten oder Überall außer auf den ausgewählten Produkten, Kategorien und Seiten. Speichern Sie und wählen Sie anschließend die Produkte, Kategorien oder Inhaltsseiten in der Eintragsauswahl unter dem Formular aus. Prüfen Sie eine ausgewählte und eine nicht ausgewählte Seite, um das Ergebnis zu bestätigen.

Eine eigene Schaltfläche platzieren

Aktivieren Sie Eigener Theme-Hook, speichern Sie und fügen Sie anschließend Folgendes in die vorgesehene Smarty-Vorlage Ihres Themes ein:

{hook h='displayMprCallback'}

Prüfen Sie, ob das Theme weiterhin die Frontend-Dateien und die Dialogausgabe des Moduls einbindet. Ein eigener Hook ändert die Platzierung; er umgeht weder die Seitenauswahl noch die Prüfung der Geschäftszeiten.

Übersetzte Texte bearbeiten

Bearbeiten Sie auf der Registerkarte Texte jede Shop-Sprache:

Ersatzbestätigung wird verwendet, wenn die Erfolgsantwort das gewählte Zeitfenster nicht nennen kann. Normalerweise beschreibt die Bestätigung das gewählte Zeitfenster.

Empfänger für Benachrichtigungen auswählen

Tragen Sie in Benachrichtigungen unter Diese Adressen benachrichtigen eine durch Kommas getrennte Liste ein und speichern Sie. Die Installation übernimmt die E-Mail-Adresse des ausgewählten Shops. Im Betrieb wird bei einer leeren oder unbrauchbaren Empfängerliste auf die E-Mail-Adresse dieses Shops zurückgegriffen, sofern sie gültig ist.

Eine neu angenommene Anfrage stellt eine Benachrichtigung in die Warteschlange und versucht, sie zuzustellen. Erinnerungen für überfällige Anfragen bearbeitet die geplante Aufgabe nach Ablauf der Karenzzeit. Die E-Mail-Zustellung hängt vom ausgehenden E-Mail-Dienst von PrestaShop ab; eine gespeicherte Anfrage ist der maßgebliche Nachweis für den erfolgreichen Eingang.

Datenschutz und Missbrauch konfigurieren

Das Formular prüft außerdem einen Honeypot, den Übermittlungszeitpunkt, signierte Formulardaten und die Herkunft. Das Modul speichert zur Missbrauchskontrolle schlüsselbasierte IP-Hashes statt vollständiger IP-Adressen. Es prüft nicht, ob eine Telefonnummer der Person gehört, die sie eingibt.

Das Zusammenfassen von Duplikaten ist an Bedingungen gebunden. Die bestehende Anfrage muss noch Neu sein, innerhalb des Duplikatzeitraums liegen und ihre Frist darf noch nicht abgelaufen sein. Die Kundenidentität muss übereinstimmen, sodass zwei registrierte Kunden mit derselben Nummer getrennt bleiben. Eine verkürzte Zusage kann eine separate Benachrichtigung über die Friständerung erzeugen.

Öffnen Sie Rückrufanfragen. Jede Zeile zeigt Status, Überfällig, Telefon, Name, Gewünschtes Zeitfenster, Anrufen bis, Herkunft, Notizen und Eingegangen sowie die Anfrage-ID. Die Telefonnummer ist ein Link zum direkten Anrufen. Die Herkunft kann die Seite oder das Produkt angeben, auf der oder bei dem der Besucher den Anruf angefordert hat.

Verwenden Sie Neu, Angerufen, Keine Antwort und Erledigt, um Ihre Arbeit nachzuverfolgen. Sie können Status und Notizen direkt in der Zeile ändern, die Zeilenaktionen verwenden oder Anfragen für Als angerufen markieren, Als keine Antwort markieren oder Als erledigt markieren auswählen. Auswahl löschen entfernt die personenbezogenen Daten der ausgewählten Anfragen dauerhaft.

Überfällig wird beim Laden der Liste berechnet. Es gilt für Anfragen mit dem Status Neu oder Keine Antwort, deren gespeicherte Frist abgelaufen ist. Dafür muss kein Cronjob eine Überfälligkeitsmarkierung setzen. Grenzen Sie die Liste mit den Spaltenfiltern ein. CSV exportieren exportiert das aktuell gefilterte Ergebnis.

Die Kennzahlen sind Heute neu, Jetzt überfällig, Heute angerufen und Median der Zeit bis zum Anruf. Verwenden Sie diese bei der Aufgabenverteilung zusammen mit den tatsächlichen Zeiten unter Anrufen bis. Eine Statusänderung führt keinen Anruf aus; Ihre Mitarbeitenden kontaktieren den Besucher über ihren Telefondienst.

Der Mitarbeiterzugriff richtet sich nach den Backoffice-Berechtigungen. Anzeigen und Exportieren, Bearbeiten von Status oder Notizen sowie Löschen von Anfragen erfordern die entsprechenden Rechte. Änderungen an Geschäftszeiten und Konfiguration erfordern ebenfalls Bearbeitungsrechte.

Die Installation registriert Erinnerungen für überfällige Rückrufe senden alle fünf Minuten und Abgelaufene Rückrufanfragen löschen täglich. Verbinden Sie diese gemeinsamen MPR-Aufgaben mit einem funktionierenden, authentifizierten Scheduler-Einstiegspunkt in Ihrer Installation. Verwenden Sie dessen tatsächliche URL oder CLI-Befehl und Token und prüfen Sie dann, ob beide Aufgabennamen in den Ergebnissen erscheinen.

Dieses Modul enthält weder eine eigene cron.php noch einen Cron-Frontcontroller. Wenn Ihre Installation keinen funktionierenden gemeinsamen Scheduler-Einstiegspunkt hat, richten Sie diesen ein, bevor Sie sich auf Erinnerungen oder Aufbewahrungsfristen verlassen. Ein Befehl, der auf eine nicht vorhandene /modules/mprcallback/cron.php verweist, führt diese Aufgaben nicht aus.

Verlassen Sie sich für diese Aufgaben nicht auf Besuche im Frontoffice. Der mitgelieferte Scheduler schließt den durch Besucher ausgelösten Fallback für Aufgaben ohne ausdrücklich erlaubten Ursprung aus, und diese Aufgabendefinitionen erlauben diesen Fallback nicht. Ohne regelmäßige zulässige Ausführung können Erinnerungen und automatische Löschungen ausstehen, obwohl die Überfälligkeitsanzeige der Warteschlange korrekt ist.

Die offiziellen PrestaShop-GDPR-Hooks unterstützen das Exportieren und Löschen von Anfragen, die mit einem registrierten Kunden verknüpft sind. Gastanfragen benötigen eine gesonderte Suche, da ein Gast über eine Telefonnummer statt über ein Kundenkonto identifiziert wird.

Verwenden Sie unter Einstellungen > Konfiguration die Funktion Gastanfragen nach Telefonnummer. Geben Sie Telefonnummer ein, klicken Sie auf Anfragen suchen, prüfen Sie die Treffer und verwenden Sie anschließend die benötigte Export- oder Löschaktion. Die Validierung akzeptiert dasselbe Nummernformat wie das öffentliche Formular. Prüfen Sie die Nummer vor dem Löschen sorgfältig; auch eine falsch eingegebene Nummer kann gültig sein.

Der ausgewählte Shop bestimmt, auf welche Anfragen diese Ansichten zugreifen können. Konfigurieren Sie Zeitzone, Empfänger, Platzierungen und Aufbewahrung für jeden Shop separat.

Die erste Testanfrage senden

1. Speichern Sie die Shop-Zeitzone und mindestens ein Öffnungsintervall.
2. Öffnen Sie eine aktivierte Platzierung im Frontoffice und warten Sie, bis die verfügbaren Zeitfenster geladen sind.
3. Geben Sie eine Telefonnummer mit Landes- oder internationaler Vorwahl ein, wählen Sie ein Zeitfenster und akzeptieren Sie den Einwilligungstext. Der Name ist optional.
4. Senden Sie die Anfrage und lesen Sie das zugesagte Zeitfenster in der Bestätigung.
5. Suchen Sie die Anfrage in Rückrufanfragen. Vergleichen Sie Telefonnummer, Herkunft und die Zeit unter Anrufen bis und prüfen Sie dann das Benachrichtigungspostfach.
6. Ändern Sie den Status und fügen Sie eine Notiz hinzu. Bestätigen Sie, dass Listenfilter und CSV exportieren den vorgesehenen Testdatensatz anzeigen.
7. Prüfen Sie in den Scheduler-Ergebnissen die Ausführung der Erinnerungs- und Bereinigungsaufgaben.

Häufige Probleme beheben

• Die Schaltfläche fehlt: Prüfen Sie Schwebende Schaltfläche, Produktseiten, Kopfbereich oder Eigener Theme-Hook, die Seitenauswahl, den ausgewählten Shop und die Hooks des aktiven Themes.
• Rückrufe sind nicht verfügbar: Prüfen Sie Zeitzone des Shops, Wochenzeiten und Ausnahmedaten. Ohne gültiges Öffnungszeitfenster innerhalb des Suchzeitraums sind keine Einsendungen möglich.
• Ein Zeitfenster für denselben Tag fehlt: Prüfen Sie die festen Vormittags- und Nach-16:00-Grenzen sowie das erforderliche nutzbare Intervall. Ein ASAP-Ziel muss vor der Schließzeit liegen.
• Das Formular läuft ab: Öffnen Sie es erneut oder aktualisieren Sie die angebotenen Zeiten, bevor Sie es nochmals absenden.
• Eine Nummer wird abgelehnt: Verwenden Sie eine unterstützte Landesvorwahl oder eine gültige internationale Nummer. Ein akzeptiertes Format bestätigt nicht die Erreichbarkeit der Nummer.
• Es kommt keine E-Mail an: Prüfen Sie zuerst die gespeicherte Anfrage, dann Diese Adressen benachrichtigen und den E-Mail-Versand von PrestaShop. Für Erinnerungen sind außerdem die Karenzzeit und eine zulässige Cron-Ausführung erforderlich.
• Zeiten wirken falsch: Prüfen Sie Zeitzone des Shops und vergleichen Sie die gespeicherte Zusage. Bestehende Anfragen verschieben sich nicht, wenn Sie die Zeitplanung ändern.
• Alte Anfragen bleiben erhalten: Prüfen Sie Anfragen löschen nach und die Ergebnisse der Bereinigungsaufgabe. Die Aufbewahrungsbereinigung erfolgt in begrenzten Stapeln, sodass ein Rückstand mehrere Durchläufe erfordern kann.

Exportieren Sie benötigte Anfragen, bevor Sie das Modul über "Module Manager" deinstallieren. Die Deinstallation entfernt Rückrufanfragen, wöchentliche Geschäftszeiten, Ausnahmedaten, Benachrichtigungsverlauf und Moduleinstellungen. Sie entfernt auch die geplanten Aufgaben und Menüeinträge des Moduls. Durch eine Neuinstallation lässt sich die gelöschte Warteschlange nicht wiederherstellen.