# LiveChat

## General information

Channel Livechat is online-chat by Blinger.io

## Connect LiveChat?

### Step 1. Open the tab Apps and click on "Add new app"

![](/files/-LlqAvctzb5OCngjsdci)

### **Step 2. Select LiveChat channel and click on "Add LiveChat"**

![](/files/-Lm4hZg0sfoRm3-i-U2l)

### Step 3. Click on "Add"

![](/files/-Lm9BGsycNf4KnwoDYxt)

{% hint style="success" %}

### **The integration is completed!**

{% endhint %}

## **Set up** Livechat for authorized zone?

This function enables you to transmit the data of a logged in account directly in Blinger.io.

### Step 1. **Get Secret key**

To get Secret key, proceed to the tab "Apps", click on "Edit" in Livechat box and copy on the settings page the value in **Secret key** field&#x20;

{% hint style="warning" %}
If the field **Secret key** is empty, then you should delete and re-add LiveChat again
{% endhint %}

![](/files/-LoV7jQBkD300zJYh95r)

### Step 2. Place the additional code on the widget page

Before the  js-code of the Widget, you must place the following code on the same page:&#x20;

{% hint style="info" %}
You can pass any quantity of parameters
{% endhint %}

```javascript
<script>
 var customBlingerConfig = {
   customLivechatFields: {
     your_custom_param_1: 123,
     your_custom_param_2: 'my value',
     your_custom_param_n: 999,
     sign: 'ff127a29530759df7752f6ffab2a78fd'
   }
 };
</script>
```

### Step 3. Calculate the value of parameter `sign`

The value of parameter `sign` depends on the values, passed parameters - that's hash of the parameter values. Hash is calculated on your server side and is needed to secure the parameters passed from changes made by third parties.

It is calculated as follows:

1. concatenation of all values of the parameters passed + **Secret key**
2. calculation of MD5 hash from the line received

{% hint style="info" %}
**Example:**

1. let's take any parameters, for example, **`Rdr9ucDi19nixmpevci5EiOvlFVyXbCT`**
2. doing concatenation of the values of the parameters: **`“123my value999Rdr9ucDi19nixmpevci5EiOvlFVyXbCT”`**
3. calculating hash: **`md5(“123my value999Rdr9ucDi19nixmpevci5EiOvlFVyXbCT”)`**
4. pasting the obtained hash as a value\
   \&#xNAN;**`sign: 'ff127a29530759df7752f6ffab2a78fd'`**
   {% endhint %}

### Step 4. Calculation of the parameter on the side of Blinger.io

On the side of Blinger.io an analogous operation will be performed. After that the obtained hash will be matched with the one which arrived from your side. If there is a match the client will be tagged with the following icon in Blinger.io <img src="/files/-LoVBzInCLRCLq3GtM7-" alt="" data-size="original"> . Example below:&#x20;

![](/files/-LoVC8y8-gnMKdIHUhCV)

When you click on <img src="/files/-LoVBzInCLRCLq3GtM7-" alt="" data-size="original"> or the client's avatar, you can see in the table Сustom Fields the values of the parameters, which have been added at step 2.

![](/files/-LoVCjIbv3bH2qP2XSd0)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.blinger.io/documentation/section-apps/adding-accounts/livechat.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
