Viber Chat-Integration: Einrichtung und Hilfe
Schnellstart
- Wählen Sie unter Modul > "Module Manager" die Option "Upload a module" und installieren Sie die ZIP-Datei
mprviberchatintegration. - Klicken Sie auf "Configure".
- Geben Sie unter Viber-Verbindung bei Telefonnummer beispielsweise
+48600123456ein. - Lassen Sie Viber Chat aktivieren auf Ja und wählen Sie die Ecke unter Button-Erscheinungsbild > Position.
- Lassen Sie unter Anzeigeverhalten für den ersten Test Auf Seiten anzeigen auf Alle Seiten und Fallback Delay (seconds) auf
0. - Klicken Sie auf Speichern. Öffnen Sie eine zulässige Shopseite mit aktiviertem JavaScript.
- Scrollen oder klicken Sie auf der Seite oder warten Sie 10 Sekunden. Prüfen Sie, ob die Schaltfläche erscheint, und kontrollieren Sie ihr Ziel:
+48600123456. Klicken Sie auf einem Gerät darauf, das Viber öffnen kann, und bestätigen Sie den richtigen Kontakt.
Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.
Einrichtungsanleitung
Installation und Erstkonfiguration
Verwenden Sie bei älteren PrestaShop-Versionen die entsprechende Seite zur Modulinstallation. Öffnen Sie dieses Modul über "Configure", wenn Sie zu seinen Einstellungen zurückkehren möchten.
Viber-Verbindung
| Einstellung | Standard | Was Sie tun |
|---|---|---|
| Viber Chat aktivieren | Ja | Deaktivieren Sie diese Option, um die Ausgabe im Shop zu stoppen und die gespeicherte Konfiguration beizubehalten. |
| Telefonnummer | Leer | Geben Sie 7-20 Ziffern mit einem optionalen vorangestellten + ein. Geben Sie die Landesvorwahl an. Verwenden Sie keine Leerzeichen, Klammern, Bindestriche oder Einladungs-URL zu einer Community. |
| Vorausgefüllte Nachricht | Leer | Speichern Sie optionalen Text; {url} wird durch die aktuelle Shop-URL ersetzt. Der Link enthält den codierten Text in ?draft=. Der Kontaktlink erfordert mit oder ohne vorausgefüllte Nachricht ein registriertes Viber Business-Konto. |
Verwenden Sie nach dem Speichern einer Telefonnummer den Testlink auf der Konfigurationsseite, um den richtigen Viber-Kontakt zu bestätigen. Geänderte Telefonnummern werden beim Speichern auf das erforderliche Format geprüft. Eine abgelehnte Änderung behält die bisherige Konfiguration bei. Eine unveränderte Telefonnummer wird nicht erneut geprüft.
Anzeigeverhalten
| Einstellung | Standard | Was Sie tun |
|---|---|---|
| Auf Mobilgeräten anzeigen | Ja | Erlauben Sie die Schaltfläche für Besucher, die PrestaShop als mobile Nutzer erkennt. Deaktivieren Sie die Option, um sie auf diesen Geräten auszublenden. |
| Fallback Delay (seconds) | 0 |
Laden Sie beim ersten Scrollen, Klicken, Berühren oder Tastendruck. Ein positiver Wert legt die maximale passive Wartezeit in Sekunden fest. 0 verwendet eine Ausweichwartezeit von 10 Sekunden. |
| Auf Seiten anzeigen | all |
Wählen Sie Alle Seiten, Nur Produktseiten, Nur Kategorieseiten oder Nur Bestellseiten. |
Nur Bestellseiten umfasst den Warenkorb und die Bestellseiten. Prüfen Sie bei einem anderen Checkout-Modul, ob dessen Seiten erfasst werden. Die Ausweichwartezeit beginnt beim Öffnen der Seite. Sie ist keine zusätzliche Verzögerung nach einer Interaktion.
Verhalten im Shop und Überprüfung
Die Schaltfläche erscheint nur, wenn Viber Chat aktiviert ist, eine Telefonnummer gespeichert ist und die Einstellungen für Mobilgeräte und Seiten dies zulassen. Das Format der Telefonnummer wird beim Speichern einer geänderten Nummer geprüft. Ihr Theme muss displayHeader für das Stylesheet sowie unter PrestaShop 1.6 displayFooter oder ab 1.7 displayBeforeBodyClosingTag für das Widget ausgeben.
Nach der ersten Interaktion oder der Ausweichwartezeit erscheint eine feste Schaltfläche in der gewählten Ecke. Ihr Link öffnet sich in einem neuen Tab und verwendet dieses Ziel:
https://viber.me/48600123456
Sie konfigurieren einen einzelnen Telefonkontakt. Werte wie 48600123456 und 0048600123456 bestehen ebenfalls die Formatprüfung, Sie müssen aber testen, ob Ihr genauer Wert in Viber korrekt aufgelöst wird. Das Gerät muss Viber-Links öffnen können. Das Modul bietet keinen Chatverlauf, keine Analysen, Bots, Rundsendungen oder Business-API-Automatisierung.
Testen Sie bei eingeschränkten Seitentypen eine zulässige und eine ausgeschlossene Seite. Testen Sie die mobile Sichtbarkeit auf einem echten Gerät. Prüfen Sie bei mehreren Sprachen den übersetzten Schaltflächentext und Tooltip.
Konfigurationsbeispiele und Theme-Anpassungen
Setzen Sie für eine Textschaltfläche auf Produktseiten Button-Stil auf Leiste mit Text, Buttontext auf Ask us on Viber, Auf Seiten anzeigen auf Nur Produktseiten und Animation auf none. Sie können Unten links wählen, wenn ein anderes Widget die rechte Ecke belegt.
Wenn Sie das Widget über ein anderes festes Bedienelement verschieben müssen, ergänzen Sie eine Regel im Stylesheet Ihres Themes:
#mprviber-widget.mprviber-bottom-right {
bottom: 90px;
right: 24px;
}
#mprviber-widget.mprviber-bar a span {
font-size: 15px;
}
Verwenden Sie für eine Vorlagenüberschreibung im Theme:
themes/your-theme/modules/mprviberchatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl
Die Vorlage erhält $mprviber mit position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation und delay sowie die vorbereitete chat_url. Die URL enthält die Telefonnummer ohne vorangestelltes + und gegebenenfalls den codierten Nachrichtenentwurf. Behalten Sie Änderungen in Ihrem Theme, damit ein Modulupdate sie nicht überschreibt.
Fehlerbehebung
- Wenn keine Schaltfläche erscheint, prüfen Sie den Aktivierungsschalter, die gespeicherte Kennung sowie die Seiten- und Mobilgeräteregel. Lösen Sie eine Interaktion aus oder warten Sie auf die Ausweichwartezeit.
- Wenn eine Änderung abgelehnt wird, verwenden Sie das oben angegebene Kennungsformat. Fügen Sie keinen vollständigen Kontaktlink ein.
- Wenn das Widget unformatiert ist, prüfen Sie, ob Ihr Theme
displayHeaderaufruft und das Stylesheet des Moduls lädt. - Wenn die Vorlage nie erscheint, prüfen Sie
displayFooterunter PrestaShop 1.6 oderdisplayBeforeBodyClosingTagab 1.7 und die Hook-Registrierung des Moduls im Backoffice. - Wenn die Schaltfläche ein anderes Bedienelement überlappt, ändern Sie Position oder Abstand vom Rand (px).
- Wenn die Schaltfläche erscheint, das Ziel aber nicht funktioniert, testen Sie den gespeicherten Kontakt und die Verarbeitung externer App-Links auf dem Gerät.
Eine Änderung von Vorausgefüllte Nachricht ergänzt oder ändert den Teil ?draft= des Shoplinks. {url} wird vor der Codierung durch die aktuelle Seiten-URL ersetzt. Bei einer leeren Nachricht entfällt ?draft=. Der Kontaktlink erfordert mit oder ohne vorausgefüllte Nachricht ein registriertes Viber Business-Konto; testen Sie die Schaltfläche im Shop, da der Testlink auf der Konfigurationsseite nur die Telefonnummer enthält.
Verwenden Sie die Modulseite "Integrity" für Einrichtungs- und Hook-Diagnosen. Lizenz, Support und Aktualisieren sind Wartungsseiten und keine Einstellungen für die Shopdarstellung.
Deaktivieren oder deinstallieren
Deaktivieren Sie Viber Chat aktivieren und speichern Sie, um Ihre Konfiguration beizubehalten. Das Hauptformular erfordert beim Speichern weiterhin eine nicht leere Kennung. Sie können das Modul auch über die Modulliste deaktivieren.
Verwenden Sie "Uninstall" im Modulmanager, um die Modulkonfiguration und ihre Admin-Menüeinträge zu entfernen. Ihr externes Messaging-Konto wird nicht gelöscht.
Fragen
Noch keine Fragen zu diesem Modul
Fragen Sie alles zu Installation, Kompatibilität oder Einrichtung. Die Antworten erscheinen hier.
Bekannte Probleme
6
Chat-Link hatte eine falsche barrierefreie Beschriftung
Installationsstatus blieb nach dem Speichern veraltet
Verwaltungsmeldungen blieben auf Englisch
Modulverwaltung ließ sich nicht öffnen
Kombinierte Ressourcen konnten den Kontaktbutton stören
Ältere Chat-Einstellungen wurden nicht migriert
Funktionsanfragen
5
Implementiert
Viber-Kontaktschaltfläche
Chat-Konfiguration prüfen
Modulupdates im Backoffice
Zusätzliche Verwaltungssprachen
Mehrsprachige Besuchertexte
Änderungsprotokoll
v1.1.132026-09-28
- Addedcomplete FR/DE/ES/IT/PL translations
- FixedMigrate chat config from ps_configuration to ConfigTable
Ältere Versionen
v1.3.02026-04-20
- Addedadmin menu management via MenuInstaller for streamlined module setup
- AddedLicense management tab with key management and renewal options
- Addedself-healing integrity checks for automatic diagnostics and repair
- Addedcomplete FR/DE/ES/IT/PL translations
v1.2.02026-02-01
- AddedPS 9 / Hummingbird theme compatibility
- Addedpre-filled message option for common customer queries
- Improvedbutton rendering in Eastern European multilingual stores
- Fixeddeep-link not opening Viber app on Android 12+ due to URI scheme changes
v1.1.02025-06-20
- Addedavailability schedule — button hidden outside configured hours
- Addeddesktop hide option — target mobile-heavy CIS/SEA audiences
v1.0.02025-05-19
- Initialrelease: Viber messenger chat button for PrestaShop
- InitialFloating Viber button linking to configured phone number
- InitialBack-office phone number, position, and colour configuration
- InitialCompatible with PS 1.7.x and PS 8.x
Demo
Testen Sie das vollständige Modul vor dem Kauf
Kaufen Sie die Lizenz später, Ihre Einstellungen bleiben erhalten.
- Ihre 30-Tage-Demo Testen Sie es 30 Tage ab der ersten Installation in Ihrem eigenen Shop.
- Fertiger Demo-Shop Entdecken Sie einen fertigen Demo-Shop im Browser.
- Ohne Registrierung Kein Konto, keine E-Mail-Adresse und keine Shop-Domain nötig.
Mit dem Download akzeptieren Sie die Demo-Bedingungen und die Datenschutzerklärung.
Mit dem Öffnen dieser Demo akzeptieren Sie die Demo-Nutzungsbedingungen und die Datenschutzerklärung.