Teams Chat Integration: setup and help

Quick start

  1. In Modules > Module Manager, choose Upload a module and install the mprskypechatintegration ZIP.
  2. Click Configure.
  3. In Teams Connection, paste your Teams Free invitation link copied from Invite to Teams in Microsoft Teams Free.
  4. Leave Enable Teams Chat set to Yes and choose the corner in Button Appearance > Position.
  5. In Display Behavior, leave Show on Pages at All Pages and Fallback Delay (seconds) at 0 for the first test.
  6. Click Save. Open an allowed storefront page with JavaScript enabled.
  7. Scroll or click the page, or wait 10 seconds. Check that the button appears, then click it to open your saved Teams Free invitation link. Customers may need to sign in to Teams.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.

Setup manual

Installation and first configuration

On older PrestaShop versions, use the equivalent module installation page. Open this module through Configure whenever you need to return to its settings.

Service availability

Skype retired on 5 May 2025. This release replaces the legacy Skype widget with Teams Chat Integration, using a Microsoft Teams Free invitation link. The module identifier remains mprskypechatintegration. See Microsoft’s Skype retirement notice.

Teams Connection

Setting Default What you do
Enable Teams Chat Yes Turn off to stop storefront output while retaining the saved configuration.
Teams Free invitation link Empty Paste the complete https://teams.live.com/l/invite/ link copied from Teams Free. Other contact formats are not accepted.

This version has no Pre-filled Message field or message processing in its storefront hook.

The configuration page provides a test link after you save an invitation link. Every main-form save checks the link's format, including unchanged values. A rejected edit keeps the previous configuration.

The current configuration section is Teams Connection. The main form, readiness notice and storefront use the same format check: https://teams.live.com/l/invite/<code>, optionally followed by ?v=<value>. The code and optional value contain only letters, numbers, hyphens and underscores.

Button Appearance

Setting Default What you do
Position bottom-right Choose Bottom Right or Bottom Left to avoid other floating controls.
Button Style icon Choose Floating Icon for the round button or Bar with Text for a text button.
Button Text Chat on Teams Set the label shown in bar mode. The template also uses it as the accessible label for an icon button.
Button Color #00AFF0 Set the background color with the color picker.
Button Size (px) 60 Change the round icon diameter. Bar mode uses its own padding.
Margin from Edge (px) 20 Set the bottom and side distance in pixels.
Show Tooltip Yes Turn off the hover tooltip if you do not need it.
Tooltip Text Chat with us on Teams Write the hover message.
Animation pulse Choose pulse, bounce, or none. Choose none to stop the repeating animation.

You can translate Button Text and Tooltip Text using the form language controls. An empty translation follows the default language. Use Save after editing.

Display Behavior

Setting Default What you do
Show on Mobile Yes Allow the button for visitors detected as mobile by PrestaShop. Turn off to hide it on those devices.
Fallback Delay (seconds) 0 Load on the first scroll, click, touch, or key press. A positive value sets the maximum passive wait in seconds. 0 uses a 10-second fallback.
Show on Pages all Choose All Pages, Product Pages Only, Category Pages Only, or Checkout Pages Only.

Checkout Pages Only matches cart, order, order-opc, orderopc, and checkout. Other checkout modules can use different controller names. The fallback wait starts on the page. It is not an additional delay after an interaction.

Storefront behavior and verification

Your theme must render displayHeader for the stylesheet and displayFooter on PrestaShop 1.6, or displayBeforeBodyClosingTag on 1.7 and later, for the widget. The module checks the enable switch, a valid Teams Free invitation link, the mobile rule and the page rule before returning output.

After the first interaction or fallback, you see a fixed button in the selected corner. Its link opens in a new tab with noopener noreferrer and uses this destination:

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

Test one allowed page and one excluded page if you restrict page types. Test mobile visibility on a real device. If you use multiple languages, check the translated button text and tooltip.

Configuration examples and theme adjustments

For a text button on product pages, set Button Style to Bar with Text, Button Text to Ask us on Teams, Show on Pages to Product Pages Only, and Animation to none. You can choose Bottom Left when another widget uses the right corner.

If you need to move the widget above another fixed control, add a rule to your theme stylesheet:

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

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

For a theme template override, use:

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

The template receives $mprskype with position, style, cta_text, color, size, margin, show_tooltip, tooltip, animation, and delay, plus link and the fallback accessible label. Keep changes in your theme so a module update does not overwrite them.

Troubleshooting

  • If you see no button, check the enable switch, saved Teams invitation link, page rule, and mobile rule. Trigger an interaction or wait for the fallback.
  • If an edit is rejected, copy the complete Teams Free invitation link in the format listed above.
  • If the widget has no styling, check that your theme calls displayHeader and loads the module stylesheet.
  • If the template never appears, check displayFooter on PrestaShop 1.6 or displayBeforeBodyClosingTag on 1.7 and later, and the module’s hook registration in the back office.
  • If the button overlaps another control, change Position or Margin from Edge (px).
  • If the button appears but the destination fails, test the saved invitation link and sign in to Teams if prompted.

After updating, paste a Teams Free invitation link and check your button text and tooltip. Previously saved contact details cannot be converted into a Teams invitation link.

Use the module’s Integrity page for setup and hook diagnostics. License, Support, and Update are maintenance pages rather than storefront appearance settings.

Disable or uninstall

Turn off Enable Teams Chat and save to retain your configuration. The main form still requires a valid Teams Free invitation link when you save. You can also disable the module from the module list.

Use Uninstall in the module manager to remove the module configuration and its admin menu entries. Your external messaging account is not deleted.

Questions

5

Which pages can show the Teams button?

Choose one display mode in the back office: all pages, product pages only, category pages only or checkout pages only. The checkout option covers the cart and supported order and checkout controllers.

Can I show or hide the Teams button on mobile?

Yes. The mobile visibility switch lets you allow the button or hide it for visitors whom PrestaShop detects as using a mobile device. When shown, tapping the button opens the same saved Teams Free invitation link in a new tab.

How do I set up my Teams Free invitation link?

In Microsoft Teams Free, select "Invite to Teams" and copy your invitation link. Paste the complete https://teams.live.com/l/invite/ link into the module’s connection settings and save. The module checks the link format and provides a configuration status and test link. Open the test link to check the destination yourself.

What do customers need to use the Teams contact button?

The button opens your Teams Free invitation link in a new tab. Customers may be asked to sign in. Microsoft states that signing in to Teams Free requires a Microsoft account.

Does the module manage privacy or consent?

The module adds a contact button that opens your Teams Free invitation link when clicked. It has no consent banner or consent-management settings. Microsoft operates the service reached through the link.

Known Issues

5

Setup warning remains after saving valid settings

ResolvedUpdated:
Fixed in: 1.1.18
The setup banner could continue to show the previous warning after settings were successfully saved.

Chat link is not named correctly for screen readers

ResolvedUpdated:
Fixed in: 1.1.18
The chat link did not consistently expose its visible text in the current shop language to screen readers.

Module labels remain untranslated

ResolvedUpdated:
Fixed in: 1.1.18
Some module labels continued to appear in English despite an available translation.

Module back office fails to open

ResolvedUpdated:
Fixed in: 1.1.14
Opening the module administration pages could stop with an error instead of displaying the page.

Chat assets fail with asset combining

ResolvedUpdated:
Fixed in: 1.1.14
Chat assets could fail to load correctly when PrestaShop combined and cached storefront assets.

Feature Requests

3

Implemented

Chat setup checks

Implemented
Check whether the chat integration has the required settings.

One-click module updates

Implemented
Install available module updates from the back office.

Chat text for each language

Implemented
Set visitor-facing chat text separately for each shop language.

Changelog

v1.1.132026-05-27

  • Addedcomplete FR/DE/ES/IT/PL translations
  • FixedMigrate chat config from ps_configuration to ConfigTable
Older releases

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-02

  • AddedPS 9 / Hummingbird theme compatibility
  • Addedscreen-sharing link generation option for technical support use cases
  • Improvedbutton label customisation — separate labels for chat and call actions
  • FixedSkype URI scheme not opening app on Android 13+

v1.1.02025-07-24

  • Addedcall/chat/video action selector in back office
  • Addedmobile-only button visibility toggle

v1.0.02025-06-04

  • Initialrelease: Skype chat/call/video button for PrestaShop
  • InitialFloating button with configurable Skype username
  • InitialBack-office position and colour configuration
  • InitialCompatible with PS 1.7.x and PS 8.x

Demo

Test the full module before you buy

Buy a licence later and keep your settings.

  • Your 30-day demo Test it on your own shop for 30 days from the first install.
  • Ready demo shop Explore a ready demo shop in your browser.
  • No registration No account, email or store domain needed.
Launch demo shop

By downloading, you accept the demo terms and privacy policy.

By opening this demo you accept the demo terms and the privacy policy.

Loading...
Back to top