Teams Chat-Integration: Einrichtung und Hilfe

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.

Skype wurde am 5. Mai 2025 eingestellt. Diese Version ersetzt das alte Skype-Widget durch Teams Chat-Integration und verwendet einen Microsoft Teams Free-Einladungslink. Die Modulkennung bleibt mprskypechatintegration. Siehe Microsofts Hinweis zur Einstellung von Skype.

Diese Version hat weder ein Feld "Pre-filled Message" noch eine Nachrichtenverarbeitung in ihrem Shop-Hook.

Die Konfigurationsseite bietet nach dem Speichern eines Einladungslinks einen Testlink. Bei jedem Speichern im Hauptformular wird das Linkformat geprüft, auch bei unveränderten Werten. Eine abgelehnte Änderung behält die bisherige Konfiguration bei.

Der aktuelle Konfigurationsbereich heißt Teams-Verbindung. Hauptformular, Bereitschaftshinweis und Shop verwenden dieselbe Formatprüfung: https://teams.live.com/l/invite/<code>, optional gefolgt von ?v=<value>. Code und optionaler Wert dürfen nur Buchstaben, Zahlen, Bindestriche und Unterstriche enthalten.

Sie können Button-Text und Tooltip-Text über die Sprachauswahl des Formulars übersetzen. Eine leere Übersetzung verwendet die Standardsprache. Klicken Sie nach der Bearbeitung auf Speichern.

Nur Checkout-Seiten entspricht cart, order, order-opc, orderopc und checkout. Andere Checkout-Module können andere Controllernamen verwenden. Die Ausweichwartezeit beginnt auf der Seite. Sie ist keine zusätzliche Verzögerung nach einer Interaktion.

Ihr Theme muss displayHeader für das Stylesheet sowie unter PrestaShop 1.6 displayFooter oder ab 1.7 displayBeforeBodyClosingTag für das Widget ausgeben. Vor der Ausgabe prüft das Modul den Aktivierungsschalter, einen gültigen Teams Free-Einladungslink sowie die Mobilgeräte- und Seitenregeln.

Nach der ersten Interaktion oder der Ausweichwartezeit erscheint eine feste Schaltfläche in der gewählten Ecke. Ihr Link öffnet sich mit noopener noreferrer in einem neuen Tab und verwendet dieses Ziel:

https://teams.live.com/l/invite/AbC123_-?v=1

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.

Setzen Sie für eine Textschaltfläche auf Produktseiten Button-Stil auf Leiste mit Text, Button-Text auf Ask us on Teams, 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:

#mprskype-widget.mprskype-bottom-right {
  bottom: 90px;
  right: 24px;
}

#mprskype-widget.mprskype-bar a span {
  font-size: 15px;
}

Verwenden Sie für eine Vorlagenüberschreibung im Theme:

themes/your-theme/modules/mprskypechatintegration/views/templates/hook/displayBeforeBodyClosingTag.tpl

Die Vorlage erhält $mprskype mit position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation und delay sowie link und die Ersatzbeschriftung label für die Barrierefreiheit. Behalten Sie Änderungen in Ihrem Theme, damit ein Modulupdate sie nicht überschreibt.

• Wenn keine Schaltfläche erscheint, prüfen Sie den Aktivierungsschalter, den gespeicherten Teams-Einladungslink sowie die Seiten- und Mobilgeräteregel. Lösen Sie eine Interaktion aus oder warten Sie auf die Ausweichwartezeit.
• Wenn eine Änderung abgelehnt wird, kopieren Sie den vollständigen Teams Free-Einladungslink im oben angegebenen Format.
• 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 Einladungslink und melden Sie sich bei Aufforderung bei Teams an.

Fügen Sie nach einem Update einen Teams Free-Einladungslink ein und prüfen Sie den Button-Text und den Tooltip. Zuvor gespeicherte Kontaktdaten können nicht in einen Teams-Einladungslink umgewandelt werden.

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 Sie Teams Chat aktivieren und speichern Sie, um Ihre Konfiguration beizubehalten. Das Hauptformular erfordert beim Speichern weiterhin einen gültigen Teams Free-Einladungslink. 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.