uWebChat

By uWebChat

10+ active installationsVersion 1.1.1

Live chat for your website, answered from Microsoft Teams. Send each part of your site to its own team, such as support or sales.

Description

uWebChat puts a chat button on your website. Your visitors chat with your own employees, who answer from Microsoft Teams. There is no separate inbox to watch and no extra app to install for your team.

This plugin adds the chat button to your WordPress site. You need the free uWebChat app for Microsoft Teams: get uWebChat from Microsoft AppSource.

A group per part of your site

In uWebChat, a group is a team of employees that receives chats. With this plugin you decide which group gets the chats of which pages:

  • One default group for the whole site.
  • Another group for a part of your site, by address: /support/* to your support team, /shop/* to sales.
  • Another group for a single page or post, chosen in the editor.
  • A link or button that opens the chat with a group of your choice: “Chat with sales”.
  • No chat button on pages where you do not want one.

Also in this plugin

  • Works with any theme, with the block editor and the classic editor, and with WooCommerce.
  • The chat button is loaded from your own site. Only the chat window itself comes from uWebChat.
  • Show or hide the chat button for users who are logged in.
  • Translated into Dutch and German.

Some uWebChat features need a paid license. See uwebchat.com/pricing.

External services

This plugin shows the chat window of uWebChat, a service of Universal IT B.V. (uwebchat.com). Without this service the plugin has no function.

When the chat button is shown on a page, the browser of the visitor loads the chat window from https://pool01.uwebchat.com/uwebchat.html. This happens only after you have entered your IDs and ticked the consent box on the settings page. The following is sent to uWebChat:

  • The customer ID and group ID from the settings page, and the address of your site, when the chat window loads.
  • The IP address and browser details of the visitor, as with any web request.
  • The messages and details the visitor enters in the chat, when the visitor chats.

The chat window stores cookies in the browser of the visitor to keep a conversation going while the visitor browses your site.

The chat button itself (image, stylesheet and script) is loaded from your own site.

Installation

  1. Install uWebChat in Microsoft Teams from Microsoft AppSource.
  2. Install and activate this plugin.
  3. Go to Settings > uWebChat.
  4. Enter your customer ID. Type debug in the uWebChat chat in Microsoft Teams to see it.
  5. Enter your default group ID. Type show groups in the uWebChat chat in Microsoft Teams to see your group IDs.
  6. Tick the consent box and save.

To send a part of your site to another group:

  1. Under “More groups”, add the group with a name and its group ID, and save.
  2. Under “Group per part of your site”, enter an address such as /support/* and choose the group.

To choose the group for one page, open the page in the editor and use the “uWebChat” box.

FAQ

Is the plugin free?

Yes. The plugin is free and licensed under the GPL, version 2 or later.

Do I need a paid uWebChat license?

No. You can start with the free version of uWebChat. Paid licenses add features such as group settings, automatic translation, opening hours and Meet now. See uwebchat.com/pricing.

Can I use the plugin without Microsoft Teams?

Your employees answer chats in Microsoft Teams, so you need Microsoft Teams with the uWebChat app.

How do I send the support pages to my support team?

Add your support group under “More groups” and save. Then add a row under “Group per part of your site” with the address /support/* and choose the support group. /support/* covers the page /support and every page below it.

My site has more than one language. How do I write the address?

Start the address with a star: */support/* covers /en/support, /nl/support and the pages below them.

How do I make a “Chat with sales” button?

Give any link or button the address #uwebchat-sales, where sales is the name shown in the “Link that opens this chat” column on the settings page. In the block editor: add a Button block and enter #uwebchat-sales as its link. In text you can use the shortcode [uwebchat_link group="sales"]Chat with sales[/uwebchat_link].

The address #uwebchat opens the chat with the group of the page itself.

Can I hide the chat button on some pages?

Yes. Choose “No chat button” for an address on the settings page, or for a single page in the editor.

What happens to a chat when the visitor goes to a page with another group?

The chat window remembers a conversation for 30 minutes. A visitor who is already chatting keeps talking to the same employee, also on a page that belongs to another group.

Can logged-in users see the chat button?

That is your choice, on the settings page. Sites that updated from version 1.0 keep the old behavior, in which logged-in users do not see the button, until you change the setting.

Can I change the color and image of the chat button?

Yes, with CSS in your theme. The button has the class uwebchat-open-button. Use a selector such as body .uwebchat-open-button and mark your rules !important.

Can I change how the chat window looks?

The colors of the chat window are set in uWebChat itself, per group. Type help in the uWebChat chat in Microsoft Teams.

Can I use the same customer ID and group ID on more than one site?

That depends on your uWebChat license, which sets the number of domains you can use.

For developers

  • Filter uwebchat_group_id changes the group of the page being viewed.
  • Filter uwebchat_show_chat decides whether the chat is shown on a view.
  • JavaScript: uWebChat.open( 'sales' ), uWebChat.close() and uWebChat.toggle().

Screenshots

Changelog

1.1.1

  • Fixed: on Dutch and German sites that had version 1.0, the new texts showed in English.

1.1.0

  • New: send chats to another group per part of your site, by address.
  • New: choose the group for a single page or post in the editor, or hide the chat button there.
  • New: links and buttons that open the chat with a group of your choice, and the shortcode [uwebchat_link].
  • New: setting to show the chat button to logged-in users. Sites that update keep the old behavior until the setting is changed.
  • Changed: the chat button, its stylesheet and its script are now loaded from your own site instead of uwebchat.com.
  • Changed: the chat button is added in the footer, so it also shows in themes that do not support wp_body_open.
  • Fixed: all settings are checked when saved and escaped when shown.
  • Fixed: notices on PHP 8.2 and newer.
  • Tested with WordPress 7.1. Requires WordPress 5.9 and PHP 7.4.

1.0

  • First version.