Viber Chat-Integration: Einrichtung und Hilfe

Schnellstart

  1. Wählen Sie unter Modul > "Module Manager" die Option "Upload a module" und installieren Sie die ZIP-Datei mprviberchatintegration.
  2. Klicken Sie auf "Configure".
  3. Geben Sie unter Viber-Verbindung bei Telefonnummer beispielsweise +48600123456 ein.
  4. Lassen Sie Viber Chat aktivieren auf Ja und wählen Sie die Ecke unter Button-Erscheinungsbild > Position.
  5. Lassen Sie unter Anzeigeverhalten für den ersten Test Auf Seiten anzeigen auf Alle Seiten und Fallback Delay (seconds) auf 0.
  6. Klicken Sie auf Speichern. Öffnen Sie eine zulässige Shopseite mit aktiviertem JavaScript.
  7. 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.

Button-Erscheinungsbild

Einstellung Standard Was Sie tun
Position bottom-right Wählen Sie Unten rechts oder Unten links, um andere schwebende Bedienelemente zu vermeiden.
Button-Stil icon Wählen Sie Schwebendes Symbol für die runde Schaltfläche oder Leiste mit Text für eine Textschaltfläche.
Buttontext Chat on Viber Legen Sie die Beschriftung im Leistenmodus fest. Sie dient auch als barrierefreie Beschriftung einer Symbolschaltfläche.
Schaltflächenfarbe #7360F2 Legen Sie die Hintergrundfarbe mit der Farbauswahl fest.
Schaltflächengröße (px) 60 Ändern Sie den Durchmesser des runden Symbols. Der Leistenmodus verwendet eigene Innenabstände.
Abstand vom Rand (px) 20 Legen Sie den Abstand nach unten und zur Seite in Pixeln fest.
Tooltip anzeigen Ja Deaktivieren Sie den Tooltip beim Darüberfahren, wenn Sie ihn nicht benötigen.
Tooltip-Text Chat with us on Viber Schreiben Sie die beim Darüberfahren angezeigte Nachricht.
Animation pulse Wählen Sie pulse, bounce oder none. Wählen Sie none, um die wiederholte Animation zu stoppen.

Sie können Buttontext und Tooltip-Text über die Sprachauswahl des Formulars übersetzen. Eine leere Übersetzung verwendet die Standardsprache. Derselbe Sprachfallback gilt für Vorausgefüllte Nachricht. Klicken Sie nach der Bearbeitung auf Speichern.

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 displayHeader aufruft und das Stylesheet des Moduls lädt.
  • Wenn die Vorlage nie erscheint, prüfen Sie displayFooter unter PrestaShop 1.6 oder displayBeforeBodyClosingTag ab 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

GelöstAktualisiert:
Behoben in: 1.1.18
Screenreader konnten einen Chat-Link-Namen vorlesen, der nicht dem sichtbaren Text oder der Shopsprache entsprach.

Installationsstatus blieb nach dem Speichern veraltet

GelöstAktualisiert:
Behoben in: 1.1.18
Das Installationsstatus-Banner konnte weiterhin die Einstellungen von vor dem letzten Speichern widerspiegeln.

Verwaltungsmeldungen blieben auf Englisch

GelöstAktualisiert:
Behoben in: 1.1.18
Einige Verwaltungsmeldungen nutzten die installierten Übersetzungen nicht.

Modulverwaltung ließ sich nicht öffnen

GelöstAktualisiert:
Behoben in: 1.1.14
Eine fehlende mitgelieferte Kompatibilitätsabhängigkeit konnte beim Öffnen der Modulverwaltung einen schwerwiegenden Fehler verursachen.

Kombinierte Ressourcen konnten den Kontaktbutton stören

GelöstAktualisiert:
Behoben in: 1.1.14
Ressourcen des Kontaktbuttons waren nicht im für die PrestaShop-Ressourcenkombination erforderlichen Format registriert.

Ältere Chat-Einstellungen wurden nicht migriert

GelöstAktualisiert:
Behoben in: 1.1.12
Ein Update konnte Chat-Einstellungen im alten Speicher belassen, sodass es schien, als hätte das Modul seine Konfiguration verloren.

Funktionsanfragen

5

Implementiert

Viber-Kontaktschaltfläche

Implementiert
Ermöglichen Sie Besuchern, den Shop über Viber zu kontaktieren, mit konfigurierbarer Telefonnummer und vorausgefüllter Nachricht.

Chat-Konfiguration prüfen

Implementiert
Prüfen Sie erforderliche Viber-Einstellungen und den Zustand der Modulinstallation.

Modulupdates im Backoffice

Implementiert
Prüfen und installieren Sie Modulupdates in der Verwaltung.

Zusätzliche Verwaltungssprachen

Implementiert
Nutzen Sie übersetzte Modultexte auf Französisch, Deutsch, Spanisch, Italienisch und Polnisch.

Mehrsprachige Besuchertexte

Implementiert
Konfigurieren Sie die für Besucher sichtbaren Chattexte für jede Shopsprache separat.

Ä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.
Demo-Shop starten

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.

Lade ...
Nach oben