> 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="https://2065239246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRMTOPu2XofX4vERECjya%2Fuploads%2FLlCUxE6S0xKyydppnWCr%2Fimage%20(11).png?alt=media&amp;token=283d837c-fc30-4e57-b324-b564f4ea20cd" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2065239246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRMTOPu2XofX4vERECjya%2Fuploads%2FgNnB66ht4RyKqOhRjD0L%2FScreenshot_13.png?alt=media&amp;token=0208df71-a22f-440b-b20b-18f613541b8b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2065239246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRMTOPu2XofX4vERECjya%2Fuploads%2FHgNdRe6MGmbLuqDu6LFG%2FScreenshot_14.png?alt=media&amp;token=53889aef-2cba-4914-a1fa-df2756c6b97a" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2065239246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRMTOPu2XofX4vERECjya%2Fuploads%2FawMwKjRF37fFnusaehbf%2FScreenshot_12.png?alt=media&amp;token=7de9a7d9-b66b-41aa-945f-d7b72524d369" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2065239246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRMTOPu2XofX4vERECjya%2Fuploads%2F1PJ2IwfksOmB3smA1iQI%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA.JPG?alt=media&amp;token=7b1ad9c1-2860-4a26-a864-d7da09b89356" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://2065239246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRMTOPu2XofX4vERECjya%2Fuploads%2FQqsUMX09suUFrqFHSpYk%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA5.JPG?alt=media&amp;token=3a0cb209-b526-4b3a-97d7-4c68dc8e838f" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2065239246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRMTOPu2XofX4vERECjya%2Fuploads%2FMli7AhxKfPCRgEFcBz6l%2Fimage%20(1).jpg?alt=media&amp;token=2e102169-e686-4954-8e77-5434813602ad" 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.