# Олчат: Telegram

## **Виджет «Олчат : Telegram»**

Виджет «Олчат: Telegram» обеспечивает быстрый доступ из карточки любой сущности CRM (системы управления взаимоотношениями с клиентами) к выбору линии, созданию нового чата, переходу в уже созданный чат, а также позволяет отправить сообщение клиенту прямо из карточки CRM, не переходя в основное приложение.

{% hint style="info" %}
По умолчанию виджет «Олчат: Telegram» при открытии карточки сущности отображается в скрытом виде с кнопкой «Обновить виджет».
{% endhint %}

Подробнее о том, как включить и показать виджет в карточке, ознакомьтесь в статье «Как включить и выключить виджеты».

#### **Выбор линии и идентификатора клиента (номер телефона или username)**

Если к вашему порталу подключено несколько коннекторов линий Telegram, вы можете выбрать, с какой именно линии начать диалог с клиентом.

<figure><img src="/files/WcT6H8tp31MiYNU1QsPR" alt=""><figcaption></figcaption></figure>

Если к сущности CRM прикреплено несколько контактов или компаний, в виджет подтянутся все доступные идентификаторы клиента (номера телефонов и/или username (имя пользователя) Telegram), по которым возможен диалог. В виджете отобразится не более 5 идентификаторов. Чтобы увидеть остальные, нажмите кнопку «Показать больше».

#### **Создание нового диалога и переход в уже созданный чат**

Чтобы начать новый диалог с клиентом, выберите нужный идентификатор и нажмите на иконку «Создать чат».

<figure><img src="/files/1Rhip3tABFAazJ04mEmC" alt=""><figcaption></figcaption></figure>

Если диалог с клиентом уже начат и чат был создан ранее, отобразится «Открыть чат». После нажатия на эту кнопку вы перейдёте в существующий чат с клиентом.

<figure><img src="/files/VHVLhKCjU3EVeCY7RKdO" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Через виджет вы можете открыть чат, находясь в любой сущности CRM, даже если он не привязан напрямую к текущей сущности.
{% endhint %}

#### **Отправка сообщений, файлов и голосовых из виджета**

Виджет позволяет отправить сообщение клиенту прямо из карточки CRM без перехода в основное приложение. Для этого нажмите на иконку «Написать в чат». В открывшемся поле введите текст сообщения и нажмите кнопку отправки.<br>

<figure><img src="/files/iYsyVJrogPbEKN1GrWAD" alt=""><figcaption></figcaption></figure>

Кроме обычного текстового сообщения с помощью виджета также можно:

* Отправить файл.
* Записать и отправить голосовое сообщение.

<figure><img src="/files/aBg7ofxaU8aPD5ZSQesv" alt=""><figcaption></figcaption></figure>

#### **Создавать Дело в таймлайне**

Если чекбокс «Создавать Дело в таймлайне» активирован, после отправки сообщения в таймлайне карточки создастся дело с информацией о содержании сообщения.

<figure><img src="/files/rOwotxMR5NNXb8Rm1aFz" alt=""><figcaption></figcaption></figure>

#### **Режим отправки в Открытой линии**

Сообщения можно отправить, используя режимы:

* **Входящее**. Сообщение появляется как будто написал клиент (с пометкой Олчат).
* **Без публикации**. Сообщение не появляется в чате Открытой линии вообще.
* **Исходящее**. Сообщение отображается как ответ оператора (от имени сотрудника, который отправил).

<figure><img src="/files/lacGAJu69iBqBiZbhRPo" alt=""><figcaption></figcaption></figure>

#### **Обновление информации в виджете**

Информация в виджете обновляется автоматически при открытии карточки и не реже, чем раз в несколько минут (точная частота зависит от настроек коннектора).

#### **Что делать, если виджет не работает?**

Необходимо проверить [«Права на приложение»](https://tg.docs.olchat.io/ustanovka-i-nastroika/nastroika-prav-dlya-raboty-s-prilozheniem-olchat#prava-na-prilozhenie).

#### **Что делать при ошибке «Нет данных авторизации от Битрикс24»?**

Возможные причины:

1. У сотрудника нет прав на приложение — виджет не видит авторизацию. Проверьте [«Права на приложение»](https://tg.docs.olchat.io/ustanovka-i-nastroika/nastroika-prav-dlya-raboty-s-prilozheniem-olchat#prava-na-prilozhenie).
2. Временные проблемы с сервером авторизации Битрикс24. В этом случае нужно подождать решения от Битрикс24.


---

# 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://tg.docs.olchat.io/ispolzovanie/vidzhety-v-kartochkakh-crm-i-smart-processakh/olchat-telegram.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.