# Website Chat Widget Quick Start

A Growth Widget allows you to embed a single channel or multichannel widget on your website so visitors can connect with you via their preferred messaging apps.

{% hint style="info" %}
If you are looking to add a Website Chat Widget, learn more [here](https://docs.is-messenger.com/ismessenger/messaging-channels/website-chat-widget).
{% endhint %}

## Getting Here

{% hint style="warning" %}
This setting is accessible by Owners and Managers only!
{% endhint %}

This setting can be accessed from the **Settings** navigation menu under the **Workspace Settings** sub-menu item, **Growth Widgets**.

Under the Growth Widget Settings section, you can see a list of existing widgets in your Workspace. Here, you can edit and manage these widgets or create new ones

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FrQTuNsPtiXJ9Sej01yJU%2FGrowth%20Widgets%20-%20Main%20Page.png?alt=media&#x26;token=ad8964d2-fd14-4fef-baa2-31e1964873ce" alt=""><figcaption></figcaption></figure>

In this setting, you can:

* [Create a new widget](#creating-new-widget)
* [Manage existing widgets](#managing-widgets)
* [Delete a widget](#delete-the-widget)

## Creating New Widget

**Step 1: Open the Explore Widget page**

Click the **Add Widget** button on the top left of the Growth Widget module to explore all the available widgets.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FxBFicYpVMWEvno3ig2qO%2Fimage_2022-12-16_162850946.png?alt=media&#x26;token=6381ce04-9c44-4631-8658-d215116e1812" alt=""><figcaption></figcaption></figure>

**Step 2: Select a Widget**

Select the widget you would like to create and click the **Create Widget** button on the top right corner of the page.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2Fj3tCxXiVxpQix1b3f2Ak%2Fgain-conversation-context-merge-suggest-1.png?alt=media&#x26;token=462df79f-362c-4fde-9376-72c51e648691" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can only select single-channel widgets if the channel is connected to the Workspace.
{% endhint %}

**Step 3: Configure Widget**

Configure the selected widget according to the required fields. Click the **Generate Widget** button on the top right corner once done.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FWeZGD1KKDqeDkSTKJiZ1%2FScreenshot%202022-12-07%20at%209.22.23%20AM.png?alt=media&#x26;token=05c87e27-72a3-4b04-b23f-193eab7df828" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can only select single-channel widgets if the channel is connected to the Workspace
{% endhint %}

**Step 3: Configure Widget**

Configure the selected widget according to the required fields. Click the **Generate Widget** button on the top right corner once done.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FmW7UDVB7py1wnkfJvKsU%2F11.jpg?alt=media&#x26;token=ace25046-3208-4b8c-a66d-eab82d8dff10" alt=""><figcaption></figcaption></figure>

**Step 3.1: Specify Website**

Fill in the website(s) where the Widget will be added in the Website Domains field. Refer to the following on how websites can be whitelisted.

* If the user adds `https://app.is-global.com` then only `https://app.is-global.com` will be whitelisted. Any other subdomain or root should not work.
* If the user adds `https://*.is-global.com` , then all subdomains including the root domain will be whitelisted.
* If the user adds `https://is-global.com` , then only the root domain will be whitelisted.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2Fhktqkk8pCjzsqS5c7HG7%2FWebsite%20Domain.gif?alt=media&#x26;token=c3c2f758-fffd-4233-a3ff-4ca37f9a031b" alt=""><figcaption></figcaption></figure>

**Step 3.2: Select Channel**

Select the channel you want to create a widget for from the dropdown list of available channels. You may click the **Advanced Settings** button to further configure the optional fields.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2Fpj1FnqsgYBr7dTbk76uw%2FSelect%20Channel%20-%20Step%203.2.gif?alt=media&#x26;token=d4220ddb-b7ae-44bf-85db-28d9ed6b2e37" alt=""><figcaption></figcaption></figure>

**Step 4: Install the Script**

Copy the generated script to install it on your website and click the **Done** button. Alternatively, forward the installation instructions via email.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2F4khds5ksPP47BxpyuuGb%2FScreenshot%202023-06-28%20105610.png?alt=media&#x26;token=2f2f67f1-0bcb-410e-b422-9c25f7f56c9e" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Refer [here](https://docs.is-messenger.com/ismessenger/messaging-channels/website-chat-widget) to learn how to install the script on your website
{% endhint %}

## Managing Widgets

Once you have created a widget, you can manage it as below

### Open the Installation Code

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FuuoeevhR0FQUTTjmmFiq%2FWidget%20Installation%20Code%20Button.png?alt=media&#x26;token=3b09224e-80f5-4f6c-a40a-ccc9cefaa2e2" alt=""><figcaption></figcaption></figure>

To see or copy the installation code (script) of the created widget, click the **Installation Code** button and follow the instructions on the screen.

{% hint style="warning" %}
This function is not applicable to the QR Code Generator.
{% endhint %}

### Download the QR Code

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FWc3Qw1kIulSftOceJUXr%2FScan%20Code%20Button.png?alt=media&#x26;token=88f6d6b6-9ac1-436a-b295-b1a811f5a49d" alt=""><figcaption></figcaption></figure>

To download the generated QR Code, click the **Scan Code** button, then the **Download** button and select your desired pixel dimensions for your scannable code.

{% hint style="success" %}
This is only applicable to the QR Code Generator, not the other messaging widgets
{% endhint %}

## QR Code Generator&#x20;

The QR code generator has been upgraded and relocated! It’s been moved from the Channels Module to the Growth Widgets Module for more intuitive access. As part of the upgrade, QR codes for all connected channels can be generated quickly by just selecting the channels from a dropdown list instead of having to reconfigure the ID for each channel.

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FU8fiWQRtaNrzkHFg554w%2F1.gif?alt=media&#x26;token=e7e1386d-272b-4b66-a043-38a15df4e9f2" alt=""><figcaption></figcaption></figure>

### Customize the Widget

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2F7jAGUnvf5hLIO1fEaoI0%2Fspaces_-L8qsmIDw5_reabURkaE_uploads_492PG2l5vcR1EyaVkyCp_Widget%20Customize%20Button.webp?alt=media&#x26;token=0ad22317-0b7e-4498-823b-65fc91f75ad5" alt=""><figcaption></figcaption></figure>

To customize existing widgets, click the **Customize** button to open the customization page.

There are 5 sections you can customize depending on the type of widget:

1. **General**\
   You may configure the following general settings:
   * **Widget Name**: Name used internally to identify the widget
   * **Website Domains**: The websites on which the widget is to be installed. If you do not add your website to this list, your widget will not load. You can enter multiple URLs if you plan on installing the widget on multiple websites.
2. **Channels**\
   You may customize the following to define the behavior of the widget based on the selected channel:
   * **Hover Text**: The hover text is shown in a tooltip when hovering over the widget
   * **Pre-Filled Text**: The pre-filled text is an input suggestion when a Contact starts a conversation
   * **Reference**: The reference will appear when a conversation is opened and allow you to track the source of the contact
   * **Colors**: Choose the channel icon’s background color and icon appearance in the widget
3. **Display & Appearance**\
   You may customize the following to change the display appearance of the widget on your website:
   * **Popup Message**: The popup message is shown to website visitors once per day 5 seconds after the page loads. If it’s not defined, no popup message will appear.
   * **Widget Size**: Choose from the Large, Standard or Small widget size
   * **Display Options**: Choose to display this widget on desktop, mobile devices or both.
4. **Position**\
   You may change the position of the widget on your website based on the following settings:
   * **Alignment**: Specify if you’d like to display the widget on the bottom **left** or **right** of the website
   * **Vertical Spacing**: Specify the amount of vertical spacing between the widget and the bottom of the screen
   * **Horizontal Spacing**: Specify the amount of horizontal spacing between the widget and the edge of the screen
5. **Additional Settings**\
   Additional customization for widgets:
   * **Hide IS-Messenger Branding**: Remove the IS-Messenger branding from your widget

## **Delete The Widget**

<figure><img src="https://3688769499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mbui1HRO4dGghy5ITOz%2Fuploads%2FN6llMyaG8HTFrB39AOQp%2FWidget%20Delete%20Button.png?alt=media&#x26;token=d4c6881f-0296-40f3-837c-7b072e34012c" alt=""><figcaption></figcaption></figure>

To delete an existing Widget, click the **Delete** button and follow the instructions on the screen. Doing so will completely remove the widget from your Workspace.

{% hint style="danger" %}
Be careful when deleting a widget from your Workspace. when a Widget is deleted, all its configurations will be deleted. Deletion cannot be undone.
{% endhint %}

##