> For the complete documentation index, see [llms.txt](https://tg.docs.olchat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tg.docs.olchat.io/ispolzovanie/vidzhet-v-kartochke-crm-i-smart-processakh/olchat-telegram.md).

# Олчат: Telegram

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

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

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

Подробнее о том, как включить и показать виджет в карточке, ознакомьтесь [по ссылке](/ispolzovanie/vidzhet-v-kartochke-crm-i-smart-processakh.md).

#### **Выбор линии и идентификатора клиента (номер телефона или 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/HAjN1BWtuHJmNP5kRbf7" 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.