# LiveChat

Это руководство поможет вам шаг за шагом настроить интеграцию между платформой «Лия» и сервисом [**LiveChat**](https://www.livechat.com/).

## Этап 1: Создание приложения в LiveChat

Начнем с создания серверного приложения в консоли разработчика LiveChat, чтобы получить ключи для интеграции.

<details>

<summary>Шаг 1. Создание приложения и получение ключей</summary>

1. Перейдите в [**консоль разработчика LiveChat**](https://developers.livechat.com/console) и нажмите **«Create new app»**.
2. Введите имя для вашего приложения (например, `Лия Бот`) и нажмите **«Continue»**.
3. Выберите тип приложения **«Server-side»** и снова нажмите **«Continue»**.
4. На следующем экране вы увидите **Client ID** и **Client Secret**.

{% hint style="warning" %}
**Обязательно скопируйте и сохраните Client Secret!** Это значение отображается только один раз и больше не будет доступно.
{% endhint %}

</details>

## Этап 2: Настройка канала в «Лие»

Теперь создадим канал в «Лие», используя полученные ключи, и получим URL для обратной связи.

<details>

<summary>Шаг 2. Создание и настройка канала</summary>

1. В личном кабинете «Лия» перейдите в раздел **Интеграции**.
2. Нажмите **«Добавить»** и выберите из списка **LiveChat**.
3. Вставьте скопированные **Client ID** и **Client Secret** в соответствующие поля.
4. Активируйте **«Включить канал»** и нажмите **«Сохранить»**.

{% hint style="info" %}
**Скопируйте ссылку для LiveChat!** После сохранения в настройках канала появится поле **«Ссылка для LiveChat»**. Скопируйте этот URL — он понадобится нам на финальном этапе.
{% endhint %}

</details>

## Этап 3: Финальная настройка в LiveChat

Осталось вернуться в консоль разработчика LiveChat и завершить настройку, указав URL из «Лии» и необходимые права доступа.

<details>

<summary>Шаг 3. Настройка URI и прав доступа</summary>

1. Вернитесь в [**консоль разработчика LiveChat**](https://developers.livechat.com/console) в настройки вашего приложения.
2. В поле **«Redirect URI whitelist»** вставьте URL, скопированный из «Лии».
3. В поле **«Direct installation URL»** вставьте тот же самый URL.
4. В разделе **«Access scopes»** добавьте следующие права:
   * `chats--all:rw`
   * `chats--access:rw`
   * `agents--my:rw`
   * `agents--all:rw`
   * `agents-bot--my:rw`
   * `agents-bot--all:rw`
   * `webhooks.configuration:rw`
5. Сохраните все изменения.

</details>

<details>

<summary>Шаг 4. Установка и активация бота</summary>

1. В меню слева перейдите в раздел **«Private installation»**.
2. Нажмите **«Install app»**. Вы должны увидеть сообщение об успешной установке.
3. Теперь перейдите в ваш основной личный кабинет LiveChat в раздел **«Agents»**.
4. На вкладке **«Chatbots»** вы увидите вашего бота. Активируйте его, переключив тумблер **«Accepts chats»**.

</details>

{% hint style="info" %}
**Готово!** Теперь ваш бот активен и будет принимать все новые диалоги в LiveChat. Вы можете управлять его работой так же, как и работой живого оператора.
{% endhint %}

## Удаление интеграции

<details>

<summary>Как удалить приложение</summary>

1. Перейдите в [**консоль разработчика LiveChat**](https://developers.livechat.com/console) и откройте ваше приложение.
2. В правом верхнем углу нажмите **«Manage app»** и выберите **«Delete this app»**.
3. Подтвердите удаление, введя `DELETE` в поле.

</details>