Manage widget keys

A widget key connects the web messenger on a website to your workspace. It’s part of the code you paste into your site. Widget keys are public, so it’s safe for them to appear in your website’s code.

Use one key per website, or one for your test site and one for your live site. Then you can turn one off without affecting the others.

Before you start

Every planNeeds: Widget keys: Write

Create a key

1. Go to Settings›Channels›Web Messenger and open the Widget keys tab.

2. Click Generate widget key. If you have none yet, click Generate your first key.

3. Type a Key Name that says where you’ll use it, such as “Main website”, and click Generate.

   You should see Widget Key Created, with the new key.

4. Click Done.

To install the web messenger with this key, choose it under Install with key on the Overview tab. See Install the web messenger on your website.

Turn a key off or on

Open the key’s More actions menu and choose Deactivate key. It takes effect straight away: the web messenger stops working on sites that use this key, and the key shows Inactive. Choose Activate key to turn it back on.

Delete a key

Open the key’s More actions menu, choose Delete key, and confirm with Delete.

You can only delete a key that has never had a conversation. Once a key has chats, deactivate it instead. Its conversations stay in your inbox.

See when a key was last used

Each key shows when it was created and when it was Last used. A key marked Never used hasn’t loaded on any website yet.

What happens next

To recognise visitors who are signed in to your website, see Verify logged-in visitors.