# Знакомство с Олчат Telegram ### Подключайте Telegram к Битрикс24 за 5 минут! ✅ Пишите первыми клиентам в Telegram прямо из карточки CRM (системы управления взаимоотношениями с клиентами). ✅ Отправляйте сообщения, изображения, документы, аудиофайлы. ✅ Получайте сообщения от клиентов, которые пишут в Telegram, прямо в Открытые линии Битрикс24. ✅ Записывайте, прослушивайте и отправляйте голосовые прямо из Битрикс24. ✅ Подключайте групповые чаты и Telegram-каналы. ✅ Добавляйте виджет на сайт. ✅ Получайте статусы отправки сообщений. ✅ Автоматизируйте различные процессы и сделайте общение с клиентами в мессенджерах быстрым и эффективным! ### Преимущества: 👍 Нет ограничений тарифа по количеству чатов, сообщений, количеству пользователей и переподключениям аккаунтов. 👍 Простое подключение через QR-код или авторизация по номеру телефона. 👍 Роботы и активити бизнес-процессов для настройки любой логики автоматизации. 👍 Подробная документация по настройкам и функционалу. 👍 Отзывчивая техподдержка, которая всегда на связи. **Есть вопросы? Напишите нам.** Чат поддержки: [Bitrix24.Network](https://auth2.bitrix24.net/oauth/select/?preset=im\&IM_DIALOG=networkLines7c380c91ab28dacab02d3af93fecdbf9) ### Как открыть чат поддержки из Битрикс24?
# Важная информация ## Общая информация Мы подключаем ваш личный аккаунт Telegram через его клиент (аналогично тому, как работает веб-версия или десктоп-приложение) и передаём сообщения между Telegram и Битрикс24 в обе стороны. {% hint style="warning" %} Убедитесь, что вы осознаёте риски использования личного аккаунта для автоматизации. Это относится к любому приложению, которое подключается к вашему личному аккаунту Telegram. {% endhint %} #### Риски 1. Автоматизированные действия нарушают правила Telegram. Сервис может это воспринимать как спам или подозрительную активность. 2. При нарушении правил аккаунт может получить временные ограничения или полную блокировку. Вероятность успешной разблокировки низкая. 3. Telegram регулярно обновляет механизмы защиты от спама — в такие периоды интеграция может работать нестабильно. 4. Telegram в любой момент может ужесточить политику и ограничить работу сторонних клиентов. ## Рекомендации по безопасному использованию Мы настоятельно не рекомендуем использовать интеграцию Олчат для массовых рассылок в Telegram. В Telegram высок риск блокировки аккаунта при автоматизированных и массовых сообщениях, а вероятность успешной разблокировки очень низкая. **Рекомендации:** * Перед подключением интеграции обязательно прогрейте аккаунт. * Избегайте массовых рассылок и резкого добавления большого количества контактов. * Минимизируйте риски жалоб. * Начинайте работу с небольших объёмов, постепенно увеличивая активность. Соблюдение этих правил значительно снижает вероятность ограничений и блокировок со стороны Telegram. Перед установкой и настройкой нашего приложения ознакомьтесь с данной информацией. {% hint style="warning" %} Если вы только недавно зарегистрировали аккаунт в Telegram, в течение последующих нескольких дней используйте Telegram только с телефона и через веб-версию. Мы не рекомендуем сразу подключаться к нашему сервису. Игнорирование данной рекомендации может привести к блокировке вашего аккаунта. {% endhint %} # Блокировка номера Наличие номера телефона в CRM не всегда означает, что вы сможете отправить сообщение через интеграцию. Telegram имеет несколько уровней защиты от спама и жёсткие настройки приватности. Ниже описаны основные причины, по которым сообщение может не отправляться. ## Блокировка аккаунта Для предотвращения фишинга, спама и других видов злоупотреблений и нарушений Условий обслуживания Telegram ваш аккаунт может быть ограничен от контактов с незнакомыми людьми — временно или навсегда. Чтобы отправить апелляцию, узнать заблокирован ли номер, используя **@Spambot**. Также вы можете ознакомиться с часто задаваемыми вопросами о [спаме](https://telegram.org/faq_spam?setln=ru), прочитать [условия предоставления услуг ](https://telegram.org/tos/eu)и ознакомится с политикой [конфиденциальности](https://telegram.org/privacy/eu) на официальном сайте документации Telegram. {% hint style="info" %} Новый аккаунт надо «прогревать» перед подключением. Первые несколько дней используйте аккаунт в обычном режиме (личные диалоги, подписка на каналы, реакции, комментарии). Избегайте резких всплесков: массового добавления контактов, массовых первых сообщений, одинаковых шаблонов. Подключайте Олчат, когда аккаунт уже выглядит «живым» (есть переписка, нормальная активность). {% endhint %} ## Настройки конфиденциальности В отличие от WhatsApp, в Telegram номер телефона **не является обязательным** публичным идентификатором для всех пользователей. Это важный момент, который нужно учитывать при попытках написать клиенту по номеру. В Telegram есть система настроек конфиденциальности, которая позволяет пользователю контролировать кто видит его номер телефона. По логике Telegram, можно сделать чтобы номер был виден всем пользователям Telegram, моим контактам или никому. По умолчанию при регистрации номера в Telegram ставится «Мои контакты». Разберём, при каких настройках написать по номеру не получится.
* «Кто видит мой номер телефона»: **никто.** * «Кто может найти меня по номеру»: **мои контакты.** При таких настройках отправить сообщение пользователю по номеру не выйдет, так как Telegram не раскрывает номер. Поэтому наличие номера телефона не гарантирует, что вы сможете написать пользователю по этому номеру через интеграцию. Даже если номер есть в CRM, всё зависит от настроек приватности самого пользователя в Telegram. {% hint style="warning" %} Рекомендуем обязательно сохранить номер телефона пользователя себе в телефонную книгу. Лучше всего синхронизировать контакты через телефонную книгу (и/или другим привычным способом обновления контактов), без «заливки базы» рывком. Если нужно добавлять вручную, то делайте это маленькими порциями, без серий «пакетом». Если после добавления контактов появляются ограничения/ошибки — остановитесь, дайте аккаунту «остыть» 24-48 часов и снизьте темп. {% endhint %} ### Настройки конфиденциальности Premium-аккаунта Если у пользователя, которому вы хотите написать, включён **Telegram Premium** и в настройках конфиденциальности установлено: **«Кто может отправлять мне сообщения? → Контакты и Premium-подписчики»**, а ваш аккаунт не является Premium, то: * В интерфейсе Олчат напротив контакта будет отображаться зелёная точка (система считает, что писать можно). * При попытке отправить сообщение появится стандартная ошибка: «Не удалось отправить сообщение. На данный момент отправка сообщения недоступна».
В таком случае рекомендуется проверить возможность написать с телефона (через обычное приложение Telegram). Скорее всего, там вы увидите сообщение:
Это ограничение Telegram, и обойти его через интеграцию нельзя. ## Лимиты Вы узнали, что у пользователя номер виден всем, но написать все равно не получается? Помимо настроек конфиденциальности, существует также ограничение Telegram на отправку сообщений новым контактам. Telegram специально встроил механизмы защиты от спама, которые ограничивают возможность писать первыми незнакомым людям. #### Возможные причины ограничения * вы часто пишете людям, которые не добавили ваш номер в свои контакты; * вы отправляете много сообщений за короткое время; * на ваш аккаунт жалуются пользователи. В связи с этим может появиться временное ограничение на возможность «писать первым» новым контактам. При этом вы можете отвечать тем, кто вам написал первым, вы можете писать людям, которые уже взаимно добавили вас в контакты. Обычно такие ограничения снимаются через некоторое время, 24–48 часов при отсутствии дальнейших подозрительных действий. Но в зависимости от ситуации (аккаунт новый, много жалоб на спам, частые попытки написать многим незнакомцам) Telegram может продлевать ограничения на несколько дней или дольше. #### Что можно сделать в такой ситуации? Попробуйте, написать изначально с телефона (через мобильное приложение Telegram) — поскольку ограничения действуют чаще на уровне API (интрегации), но это не даёт 100% гарантии. ## Первый контакт Вы создаете контакт с номером телефона и сразу хотите написать, ранее вы не писали данному клиенту из CRM, в таком случае данные о контакте могут не сразу подгрузиться. Поэтому, когда вы пишете клиенту впервые, подождите около 5 минут — за это время информация может прогрузиться и появится возможность отправить сообщения, если нет других ограничений. ## Нет аккаунта При переходе к отправке сообщения из карточки напротив имени контакта/лида отображается цветная точка-индикатор: * **Зелёная точка** — аккаунт Telegram найден, можно отправлять сообщения. * **Серая точка** — номер телефона указан, но аккаунт Telegram по данному номеру не обнаружен.\ Рекомендуется попробовать отправить сообщение по имени пользователя (username). Если пользователь скрыл свой номер телефона, отправка сообщения по номеру в любом случае завершится ошибкой, тогда как по известному имени сообщение может быть успешно доставлено. При попытке отправить сообщение при серой точке система выдаёт стандартную ошибку:
# Тарифы приложения ### Бесплатный демо-период 3 дня После установки приложения вам сразу доступно подключение бесплатного демонстрационного периода. Демо-период активируется в настройках коннектора. Подробнее в статье Подключение открытой линии и коннектора. ### Стоимость коннектора (приложения, линии, номера) Стоимость коннектора составляет **3 600 рублей** за одну подключённую Открытую линию (приложение Telegram) **на 30 дней.** Для пользователей из Казахстана стоимость составляет **25 000 тенге** за одну подключённую Открытую линию (приложение Telegram) **на 30 дней.** К одной линии одновременно вы можете подключить только один аккаунт (номер) Telegram, при этом в любой момент можно заменить номер на другой. {% hint style="info" %} Оплачивать линию повторно можно в любое время. Новый оплаченный период прибавляется к остатку ранее оплаченных дней. {% endhint %} Подробная инструкция о том, как оплатить коннектор Telegram содержится в статье [Оплата коннектора](/stoimost-i-oplata-prilozheniya/oplata-konnektora). # New Оплата коннектора Для оплаты коннектора выполните следующие действия в приложении Олчат Telegram: {% stepper %} {% step %} Перейдите в приложение Олчат Telegram и выберите пункт «Новый платёж».
В случае, если планируете оплатить только одну конкретную линию, можно выбрать ее из Списка аккаунтов на главной станице приложения, нажать на «» в конце строки напротив выбранной линии, затем выбрать «Оплатить».
{% endstep %} {% step %} В поле «Компания» нажмите «», затем «+ Добавить компанию».
{% hint style="warning" %} При повторной оплате воспользуйтесь поиском для автоматической подстановки данных компании. {% endhint %} {% hint style="info" %} Если данные компании изменились, выберите «Редактировать», чтобы внести актуальные данные. Если необходимо полностью удалить данные о компании, воспользуйтесь кнопкой «Удалить». {% endhint %} {% endstep %} {% step %} Укажите страну, в которой юридически зарегистрирована компания, далее укажите название компании и контактные данные ответственного за оплаты. Для автоматической подстановки данных введите название компании или ИНН в поле «Название компании».
{% hint style="info" %} Все поля являются обязательными к заполнению. {% endhint %} {% hint style="warning" %} Обязательно проверьте правильность выбранных данных для избежания ошибок в оплате. {% endhint %} {% endstep %} {% step %} Выберите линии Telegram. Проставьте выбор в чекбоксе напротив тех открытых линий, оплату которых планируете продлить. При необходимости выбора всех открытых линий, проставьте только один чекбокс в начале списка. Список открытых линий можно отсортировать по названию, а также оставшемуся сроку оплаты. Для этого нажмите рядом с наименованием столбца. Для удобства срок оплаты окрашен в разные цвета. Активные линии с действующей подпиской отражены зеленым цветом, неактивные - серым, требующие оплаты - красным.
{% endstep %} {% step %} В поле «Период оплаты» выберите желаемый период оплаты. Доступна оплата на 30, 90, 180 и 360 дней.
{% endstep %} {% step %} Проверьте выбранный заказ в Корзине и нажмите «Перейти к оплате». Для раскрытия подробного списка оплачиваемых линий нажмите «Линии» при необходимости.
{% endstep %} {% step %} Выберите способ оплаты: оплата картой или по счёту. В случае оплаты банковской картой онлайн нажмите «Оплатить» и завершите оплату с помощью сервиса. В случае оплаты по счёту выберите соответствующий пункт, а затем скачайте счёт и завершите оплату. {% hint style="warning" %} Для активации подписки в платежном поручении в назначении платежа должен быть обязательно указан номер счёта. {% endhint %}
{% endstep %} {% step %} #### Оплата коннектора Олчат Telegram завершена. {% endstep %} {% endstepper %} # Оплата коннектора Для оплаты коннектора перейдите в настройки приложения Олчат: Telegram (в меню слева), нажмите на значок «**•••**» Меню напротив нужной линии и выберите пункт «Оплатить»:
### Оплата коннектора (приложения, линии, номера) с помощью карты Для оплаты на вкладке «Оплата картой» введите номер телефона для связи по вопросам оплаты, эл. почту для отправки счёта и уведомлений и выберите период оплаты. Затем нажмите «Оплатить».
Оплата c помощью карты происходит с использованием Банковских карт следующих платежных систем: * МИР. * VISA International. * Mastercard Worldwide.
{% hint style="info" %} Линия активируется сразу после оплаты. {% endhint %} ### Безналичная оплата коннектора (приложения, линии, номера) для организаций Для запроса на выставление счёта перейдите во вкладку «Оплата по счёту», заполните форму и нажмите на кнопку «Получить счёт».
Скачайте счёт по ссылке
Через некоторое время счёт будет продублирован на указанную почту. После поступления денег на наш счёт линия активируется. {% hint style="warning" %} В назначении платежа в платёжном поручении **обязательно** указывайте назначение платежа из счёта-оферты. Без указания номера счёта в платёжном поручении, согласно оферте, мы не можем активировать подписку. {% endhint %} {% hint style="info" %} Для подключения нескольких аккаунтов Telegram создайте несколько Открытых линий и подключите к ним коннекторы. Подробнее в статье [Добавление дополнительных аккаунтов Telegram](/ustanovka-i-nastroika/dobavlenie-dopolnitelnyh-akkauntov-telegram). {% endhint %} # Оплата групп Telegram {% hint style="info" %} В данный момент групповые чаты Telegram находятся в бета-версии и предоставляются БЕСПЛАТНО! {% endhint %} # Что нового? ## 21.05.2025 1. Повысили стабильность работы интеграции. Теперь не нужно перезагружать коннектор для работоспособности сервиса. 2. Решили вопрос с дубликатами сущностей. Теперь чаты прикрепляются к нужным сущностям и дубликаты не создаются. Даже если номер телефона пользователя скрыт настройками конфиденциальности. 3. Добавлена синхронизация списка групп и каналов в рамках подключенного аккаунта. Если у вас по умолчанию в настройках групп/каналов стоит «Создавать чаты ОЛ», то группы/каналы создаются в Открытых линиях сразу, как приходит событие из Телеграма. 4. В настройках групп поправили работоспособность настройки «Скрывать имена сотрудников». 5. Добавили возможность удаления и редактирования сообщения из Битрикс24. 6. Поправили работу сообщений с медиа. При реакциях пользователя в Телеграм на файл, файл остаётся в Битрикс24. Сообщения с медиа, пересылаемые между чатами в Телеграме, корректно отображаются в Открытых линиях Битрикс24. 7. Реакции в групповых чатах теперь передаются в Открытые линии Битрикс24. 8. Цитирование в чатах один на один и групповых чатах. Ответы на сообщения в Телеграме (цитирование) отображается в чатах Открытой линии. Цитирование в Открытых линиях Битрикс24 корректно передаётся в Телеграм. 9. Добавили робота Создания группы. # Правила эффективного взаимодействия со службой поддержки Мы ценим каждого клиента и стремимся решать возникающие вопросы быстро и качественно. Команда Олчат — это живые люди, специалисты, которые осознают важность своей работы и готовы приложить все усилия, чтобы помочь вам. Чтобы общение было максимально продуктивным и комфортным для обеих сторон, просим придерживаться нескольких простых правил. ### Основные принципы конструктивного диалога Успех решения любого запроса зависит от совместных усилий. Вот ключевые принципы, которые помогут нам помочь вам: * **Взаимное уважение.** Мы уважаем вас и ваше время. В ответ ожидаем такого же отношения к нашим сотрудникам. Грубость, оскорбления и переход на личности мешают концентрации и работе. * **Конкретика и ясность.** Чем более подробно и чётко вы опишете возникшую проблему, тем быстрее мы сможем найти решение. * **Взаимопонимание.** Технические неполадки могут вызывать раздражение, но мы просим помнить, что сотрудник поддержки не виноват в сложившейся ситуации. Его задача — стать вашим союзником в её решении. ### Права и обязанности клиента Вы имеете право на: * **Квалифицированную помощь.** Получение полной и экспертной консультации по вопросам, связанным с сервисом Олчат. * **Вежливое обслуживание.** Общение в уважительном и корректном тоне. * **Конфиденциальность.** Защита ваших персональных данных. Для этого мы просим вас: * **Предоставлять точную информацию.** Указывайте данные аккаунта, присылайте описание ошибки, скриншоты или видео, которые помогут понять суть проблемы. * **Соблюдать деловой тон.** Обращайтесь к сотрудникам по имени (которое указано в подписи) и избегайте фамильярности. * **Сохранять терпение.** Сложные вопросы требуют времени на тщательный анализ. Мы не всегда можем дать мгновенный ответ, но обязательно ответим, как только проработаем все варианты. ### Что недопустимо? Поведение, которое приведёт к прекращению поддержки Команда Олчат имеет право ограничить или приостановить предоставление поддержки, если клиент: * **Использует ненормативную лексику, оскорбления, угрозы** в адрес сотрудника или компании. * **Проявляет вербальную агрессию,** переходит на личности, унижает достоинство специалиста. * **Провоцирует конфликт,** игнорирует вопросы специалиста, отказывается от диалога и предложенных решений. * **Ведет себя деструктивно:** спамит, многократно повторяет одно и то же сообщение, препятствуя работе специалистов, либо предъявляет претензии, не относящиеся к работе сервиса Олчат. ### Почему это важно? Последствия нарушения правил Мы верим, что любую проблему можно решить. Однако чтобы защитить наших сотрудников и сохранить здоровую атмосферу в работе, мы можем применять санкции к клиентам, которые систематически нарушают правила эффективного взаимодействия. **В случае деструктивного поведения или грубого нарушения правил общения сотрудник поддержки может:** 1. **Предупредить** клиента о недопустимости общения в деструктивных тонах. 2. **Приостановить диалог** до нормализации тона общения. 3. В крайних случаях — **полностью прекратить поддержку** по обращению и передать информацию руководству для принятия дальнейших решений. Обращаем ваше внимание, что целью перечисленных мер является возобновление конструктивного диалога. ### Вместо заключения Помните: по другую сторону экрана находится человек, который хочет вам помочь. Уважительное и конструктивное общение — это самый короткий путь к решению возникшей проблемы. Мы всегда на вашей стороне, когда дело касается любых трудностей, и просим вас быть на нашей стороне, когда дело касается человеческого общения. С уважением, команда Олчат ❣️ # Установка приложения {% hint style="info" %} Установка приложения осуществляется через **Битрикс24 Маркетплейс** {% endhint %} Для установки приложения перейдите в «Маркет» вашего Битрикс24, введите в поиске «Олчат» и найдите приложение «Олчат — Чаты и Группы Telegram».
Выполните установку приложения, нажав на кнопку «УСТАНОВИТЬ».
После установки приложение Олчат: Telegram появится в меню слева.
{% hint style="info" %} Также вы можете установить приложение перейдя по ссылке на Маркет: [https://www.bitrix24.ru/apps/app/infocom.olchat\_tg/](https://www.bitrix24.ru/apps/app/infocom.olchat_tg/?p=132277\&p1=docs). {% endhint %} # Подключение открытой линии и коннектора После установки перейдите в приложение «Олчат: Telegram» в левом меню портала:
### Подключение открытой линии Для начала необходимо создать или подключить открытую линию. Для этого в открывшемся окне нажмите на кнопку «+ Подключить аккаунт».
{% hint style="info" %} Если у вас несколько открытых линий, из выпадающего списка выберите Открытую линию к которой собираетесь подключить коннектор, нажав на кнопку «ПОДКЛЮЧИТЬ». Если линий для подключения нет, вы можете создать новую, нажав на ссылку «СОЗДАТЬ НОВУЮ ЛИНИЮ». {% endhint %}
### Подключение коннектора {% hint style="info" %} При первичном подключении вашего номера к коннектору запускается синхронизация данных. Для её корректного завершения необходимо подождать около 10 минут. {% endhint %} После подключения открытой линии можно перейти к подключению коннектора. Для этого напротив подключаемого коннектора нажмите на значок меню «•••» и выберите пункт «Настройки коннектора».
В открывшемся окне нажмите на кнопку «АКТИВИРОВАТЬ ДЕМО».
Далее выберите способ авторизации: с помощью получения кода на телефон или с помощью сканирования QR-кода из приложения Telegram.
### Авторизация по QR-коду При выборе способа входа через сканирование QR-кода следуйте инструкции на экране:
### Авторизация по номеру телефона Если выбран способ подключения с помощью получения кода, введите номер телефона, на который придёт код авторизации, нажмите «Получить код», а затем введите полученный код в поле ввода кода и нажмите на кнопку «ВОЙТИ»:
{% hint style="warning" %} При выборе способа авторизации по номеру телефона, обязательно вводите номер в международном формате, через +. {% endhint %} #### Авторизация при наличии двухэтапной аутентификации
Если в настройках конфиденциальности вашего аккаунта Telegram подключена двухэтапная аутентификация (Облачный пароль), после ввода кода подтверждения на предыдущем шаге вам потребуется ввести ваш Облачный пароль в специальное поле ввода 2FA-пароля (пароля двухфакторной аутентификации):
После подключения вы увидите статус «Аккаунт авторизован», ID (идентификатор) и Username (имя) подключенного пользователя, а также номер телефона, для которого подключена интеграция.
### Авторизация по ссылке Также есть возможность авторизации по специальной ссылке. Если подключиться нужно другому человеку (например, коллеге или администратору), нажмите кнопку **Скопировать ссылку на авторизацию**. Полученную ссылку можно отправить этому человеку. По ней он сможет пройти авторизацию в своем Telegram без необходимости передавать номер телефона или коды подтверждения.
Эта функция особенно удобна, когда настройку выполняет не владелец номера. # Настройка открытой линии Настроим основные параметры открытой линии к которой подключен коннектор. Для этого перейдите в приложение Олчат Telegram в левом меню портала и напротив нужного коннектора нажмите на значок меню «•••». Выберите пункт «Настройки линии»:
Сначала нужно добавить сотрудников в очередь и выбрать тип распределения диалогов. Рекомендуем ставить «Одновременно всем», если у вас нет специфического сценария работы.
Дальше настраивается информация об операторах и правила автоматического создания сущностей при создании диалогов. Снимите галочку с настройки «Включить чат трекер». Остальные настройки рекомендуем установить как показано на скриншоте ниже:
После этого нужно настроить автоматические действия. {% hint style="warning" %} Обратите внимание! Изначально установлено автоматическое приветствие. Оно срабатывает всегда, когда вам клиент пишет в первый раз. Есть особенность. Открытые линии не разрешают писать первыми. Для того чтобы писать первыми мы применяем маленькую хитрость и пишем как бы от имени клиента. Битрикс24 думает, что написал клиент и создаёт чат.\ Но вместе с созданием чата срабатывает автоответ.\ В этом случае мы рекомендуем отключать автоматический ответ. {% endhint %} ![](/files/-Lv9wZ6U18F9QfjoQGpJ) ![](/files/-Mcwkdr9GoArlqnMps2Z) {% hint style="danger" %} Настоятельно рекомендуем отключать все автоматизированные действия, связанные с отправкой однотипных сообщений в разделах «Автоматические действия» и «Оценка качества». {% endhint %} В разделе «Прочее» вы можете сменить название Открытой линии. Нажмите на кнопку «СОХРАНИТЬ», чтобы применить выбранные настройки.
{% hint style="info" %} Открытые линии: [общие настройки Битрикс24](https://helpdesk.bitrix24.ru/open/2448369/). {% endhint %} # Настройка прав Настройка прав для работы с приложением Олчат: Telegram осуществляется в нескольких местах на портале. Для корректной работы c приложением необходимо выдать права на само приложение, на настройку открытой линии, на карточку CRM (системы управления взаимоотношениями с клиентами) и на коннектор линии тем сотрудникам, чья работа предполагает использование и настройку приложения Олчат: Telegram. ### Права на коннектор линии Изначально возможность выбора коннектора для отправки сообщений доступна всем сотрудникам, у кого есть права на использование приложения. Однако вы можете разграничить доступ к коннекторам и для определённых сотрудников или отделов выделить именно тот коннектор, который они должны использовать в работе. Чтобы выдать права на использование коннектора сотруднику или отделу, перейдите в приложение **Олчат: Telegram —** ••• **— Настройки коннектора — Настройки — Права доступа к коннектору — ИЗМЕНИТЬ.**
Выберите из структуры компании нужный отдел или пользователя. Нажмите кнопку «ВЫБРАТЬ».
{% hint style="info" %} Поддерживаемые типы прав для настройки доступа к коннектору линии — «Пользователи», «Сотрудники и отделы» и «Группы социальной сети». Тип прав «Другое» не поддерживается. Также не поддерживается выбор из структуры «Все сотрудники отдела с подотделами». {% endhint %} Если вы хотите открыть доступ к коннектору для всех сотрудников, необходимо нажать на «Изменить» и не выбирая никого нажать на кнопку «ВЫБРАТЬ». Система очистит список прав и данный коннектор станет доступен для всех. ### Права на приложение Для настройки прав на приложение, зайдите в **Маркет — Ещё — Установленные приложения — Олчат: Telegram —** ••• **— Доступ** и добавьте всех, кто может пользоваться приложением. Если вы не добавите никого, приложение будет доступно всем сотрудникам на портале.
### Права на открытые линии Чтобы выдать права на настройку открытой линии, перейдите в **CRM — Клиенты — Контакт центр — карточка \[Олчат] Telegram — Права доступа — Настроить.** В списке ролей добавьте новую роль или отредактируйте набор прав для представленных ролей. Чтобы сотрудник мог управлять настройками открытой линии, выдайте права на изменение в сущностях **Список открытых линий** и **Общие настройки**. Сохраните изменения. Затем присвойте роль нужному сотруднику или отделу, выбрав её из выпадающего списка ролей. Нажмите на кнопку «СОХРАНИТЬ». При необходимости можно удалить имеющиеся настройки прав и добавить новые. Чтобы добавить новые права, нажмите на ссылку **Добавить право доступа,** выберите из структуры компании нужный отдел или сотрудника и присвойте ему необходимую роль. Нажмите на кнопку «СОХРАНИТЬ».
Если вы хотите, чтобы сотрудники видели только свои переписки, настройте для этих сотрудников права таким образом, как показано на скриншоте ниже:
Также вы можете немного расширить права сотрудников и выдать им доступ на просмотр истории разговоров, установив в пункте «История разговора» значение «Любые». При этом сотрудники также не смогут подключаться и писать в чат, который за ними не закреплён, если остальные настройки установлены так как показано на скриншоте ниже:
### Права на карточку CRM Чтобы сотрудник имел возможность пользоваться приложением из карточки лида или сделки, необходимо настроить права на карточку CRM. Для этого перейдите в **CRM — Настройки — Права доступа — CRM.** В списке ролей добавьте новую роль или отредактируйте набор прав для представленных ролей. Для использования приложения сотруднику необходимо установить права на **Изменение** лида или сделки. Сохраните изменения. Затем присвойте роль нужному сотруднику или отделу, выбрав её из выпадающего списка ролей. Нажмите на кнопку «Сохранить».
При необходимости можно удалить имеющиеся настройки прав и добавить новые. Чтобы добавить новые права, нажмите на ссылку **Добавить право доступа,** выберите из структуры компании нужный отдел или сотрудника и присвойте ему необходимую роль. Нажмите на кнопку «Сохранить». ### Настройка прав администратора на приложение {% hint style="warning" %} Иногда возникает ситуация, когда сотрудника, установившего приложение Олчат, необходимо уволить с портала Битрикс24. В этом случае права перейдут другому назначенному на портале администратору. {% endhint %} Чтобы узнать, кто сейчас назначен администратором, нужно обратиться в службу поддержки. {% hint style="info" %} Сменить права можно только на того пользователя, который является администратором портала. {% endhint %} # Интерфейсы приложения # Описание панели приложения Панель приложения «Олчат: Telegram» является главным интерфейсом, содержащим набор кнопок и ссылок для управления настройками приложения, получения актуальной информации о подключенных линиях и статусах подключения. Для перехода к настройкам панели приложения, в левом меню портала выберите приложение Олчат Telegram:
1. Кнопка «**+ Подключить линию**» — позволяет создавать и добавлять Открытые линии для подключения к ним коннекторов. Подробнее в статье [Настройка открытой линии](/ustanovka-i-nastroika/nastroika-otkrytoi-linii). 2. Иконка «**⚙**» **– Настройки.** Переход к настройкам приложения. Подробнее в статье [Описание настроек приложения](/ustanovka-i-nastroika/interfeisy-prilozheniya/opisanie-nastroek-prilozheniya). 3. Иконка «📃» **– Документация.** Ссылка на данную документацию. 4. Иконка «🗨️» **– Написать в поддержку.** Открывает чат поддержки пользователей приложения Олчат: Telegram в вашем Битрикс24. 5. **Название коннектора.** Настраивается в разделе Настройка коннектора. Подробнее в статье [Описание настроек коннектора](/ustanovka-i-nastroika/interfeisy-prilozheniya/opisanie-nastroek-konnektora). 6. **Номер и название** подключенной открытой линии. Название открытой линии настраивается в настройках отрытой линии. Подробнее в статье [Настройка открытой линии](/ustanovka-i-nastroika/nastroika-otkrytoi-linii). 7. **ID** пользователя Telegram, который подключён к открытой линии в данный момент. 8. **Статус соединения** – показывает текущий статус соединения. 9. **Дата окончания** демонстрационного или оплаченного периода и количество оставшихся дней. 10. Значок «**•••**» **– Меню вызова настроек.**
1. **Оплатить.** Открывает окно для оплаты выбранного коннектора. Подробнее в статье [Оплата коннектора](/stoimost-i-oplata-prilozheniya/oplata-konnektora). 2. **Настройки коннектора.** Открывает окно настроек коннектора. Подробнее в статье [Описание настроек коннектора](/ustanovka-i-nastroika/interfeisy-prilozheniya/opisanie-nastroek-konnektora). 3. **Настройки линии.** Позволяет перейти в настройки открытой линии для данного коннектора. Подробнее в статье [Настройка открытой линии](/ustanovka-i-nastroika/nastroika-otkrytoi-linii). 4. **Настройки групп.** Открывает окно настроек для управления группами. Подробнее в статье [Групповые чаты](/gruppovye-chaty/gruppovye-chaty). # Описание настроек приложения Для перехода к панели приложения, в левом меню портала выберите приложение «Олчат: Telegram»:
Для перехода в интерфейс настроек приложения для начала необходимо войти в панель приложения. Затем нажать на Иконку «**⚙**» **– Настройки.** Более подробно про [описание панели приложения здесь](https://tg.docs.olchat.io/ustanovka-i-nastroika/interfeisy-prilozheniya/opisanie-paneli-prilozheniya). Страница «Настройки приложения» содержит несколько вкладок с вложенными настройками:
### Общие
В разделе «ОБЩИЕ» содержатся следующие настройки: 1. Настройка «Показывать страницу приложения только администраторам» позволяет ограничить права доступа к странице приложения другим сотрудникам, кроме администраторов или сделать её доступной всем. 2. В настройке «Уведомления» находится кнопка «ОТКРЫТЬ УВЕДОМЛЕНИЯ», ведущая в чат уведомлений, представлен список сотрудников в чате уведомлений и возможность добавить в этот чат сотрудников нажатием на кнопку «ДОБАВИТЬ ПОЛЬЗОВАТЕЛЯ». ### Роботы и бизнес-процессы
Раздел «РОБОТЫ И БИЗНЕС-ПРОЦЕССЫ» содержит список всех роботов и активити бизнес-процессов приложения Олчат: Telegram и кнопку для их переустановки. Подробнее в статье [Роботы и активити (действия) бизнес-процессов](/roboty-i-aktiviti/roboty-i-aktiviti-deistviya-biznes-processov). # Описание настроек коннектора Для перехода к панели приложения, в левом меню портала выберите приложение «Олчат: Telegram»:
Для перехода в интерфейс настроек коннектора напротив выбранной линии необходимо нажать на значок «**•••**» и выбрать **Настройки коннектора.** Более подробно про [описание панели приложения здесь](https://tg.docs.olchat.io/ustanovka-i-nastroika/interfeisy-prilozheniya/opisanie-paneli-prilozheniya). ## Общие настройки Страница настроек коннектора содержит в себе несколько разделов и кнопок для управления сценариями работы подключенного аккаунта Telegram (коннектора).
### **Наименование коннектора** Вы можете переименовать коннектор так, как вам удобно, нажав для этого на значок «✏️» карандаш. ### Дата окончания демонстрационного или оплаченного периода Указана дата, до которой будет работать коннектор. ## Соединение
В разделе «СОЕДИНЕНИЕ» содержатся следующие настройки: 1. **Способ авторизации.** Доступно подключение через получение кода на телефон или с помощью сканирования QR-кода. Подробнее о подключении [здесь](/ustanovka-i-nastroika/podklyuchenie-konnektora). 2. Иконка «**↻**» **– Перезагрузить коннектор.** Позволяет перезагрузить коннектор в случае, если что-то работает некорректно – не приходят входящие сообщения, не нажимаются кнопки и тд. 3. Иконка «**\[→**» **– Выйти из аккаунта.** Позволяет отключить текущее соединение. Если подключение выполнено, раздел «СОЕДИНЕНИЕ» будет содержать информацию о том, что аккаунт авторизован и показывать ID (идентификатор), Username (имя пользователя) и телефон, для которых выполнено подключение:
## Настройки
### Настройки чата Раздел отвечает за настройку логики работы приложения при отправке сообщений из чатов Битрикс24. Вы можете отметить или деактивировать нужные пункты в зависимости от потребностей и сценариев вашей работы.
1. **Включить SMS провайдера** — управляет возможностью использовать приложение Олчат: Telegram в качестве провайдера в стандартном функционале отправки СМС от Битрикс24. 2. **Публиковать в чат исходящие сообщения: через SMS, из приложения, роботов и бизнес-процессов** — при включении данной функции все сообщения отправляемые различными способами – через СМС, из приложения, с помощью роботов и бизнес-процессов будут опубликованы в чат открытой линии. Это глобальная настройка. Если она отключена, то сообщения от приложения не будут попадать в чат открытой линии даже если в роботах выбран один из способов публикации в чате открытой линии в настройке «Публикация в чате открытой линии?». 3. **Создавать чат при отправке через SMS провайдера** — управляет возможностью создавать или не создавать чат открытой линии с клиентом при использовании стандартного функционала отправки СМС от Битрикс24 и приложения Олчат: Telegram в качестве провайдера. 4. **Способ публикации SMS в истории чата ОЛ** — определяет, в каком виде сообщение будет отображаться в истории чата Открытой линии Битрикс24. Доступны варианты: * **Системным сообщением** — сообщение появляется в чате как системное уведомление. Чат при этом может не открываться автоматически (не создаётся активный диалог для операторов). * **Входящим сообщением** — сообщение публикуется как входящее (от лица клиента + пометка Олчат). Чат создаётся и открывается в очереди Открытых линий. 5. **Создавать чат при отправке через SMS-рассылки** — управляет возможностью создавать или не создавать чат открытой линии с клиентом при проведении рассылок и использовании приложения Олчат: Telegram в качестве провайдера в разделе Маркетинг. 6. **Отключить Чат-трекер для коннектора** — выключает автоматическое объединение переписки клиента из разных каналов в одну карточку CRM для выбранного коннектора. 7. **Список игнорируемых контактов** — чаты для входящих сообщений с номеров указанных в данном поле не будут создаваться. Формат записи номеров международный, через пробел. Сохранение производится автоматически.\ Можно указывать: * номера телефонов в международном формате (через пробел); * имя (username) бота и пользователя через символ @. ## Настройка виджета на сайт Подробнее в статье [Виджет на сайт](/vozmozhnosti/vidzhet-na-sait).
### Права доступа к коннектору Подробнее о настройке прав в статье [Настройка прав](/ustanovka-i-nastroika/nastroika-prav-dlya-raboty-s-prilozheniem-olchat#prava-na-konnektor-linii).
### Настройки групп по умолчанию
1. **Режим работы для групп**. При написании сообщений участниками группы можно выбрать, будут или не будут создаваться чаты в открытых линиях. 2. **Режим работы для каналов.** При написании сообщений подписчиками каналов можно выбрать, будут или не будут создаваться чаты в открытых линиях. 3. **Отправка сообщений**. Проставьте , если хотите включить возможность публиковать посты в канале или группе с помощью данного коннектора через открытую линию. Оставьте пустым, если планируете использовать открытую линию только для просмотра содержимого канала/группы. 4. **Скрывать имена сотрудников**. Проставьте , если хотите, чтобы сообщения, отправленные в канал из открытой линии, публиковались без подписи имён сотрудников. Если оставить пустым — сообщения будут публиковаться от имени канала, а ниже содержать приписку с именем сотрудника, отправившего сообщение из открытой линии в канал. # Типы уведомлений приложения Приложение Олчат Telegram создаёт на вашем портале Битрикс24 специальный чат, в который приходят уведомления. Здесь можно получить оперативную информацию об изменении статуса авторизации, подключения, оплаты, о блокировке линии. Также здесь будут подсказки для настройки приложения. ## Как открыть чат уведомлений и добавить в него сотрудников Перейти в данный чат можно из настроек приложения. Для этого выполните следующие действия: 1. На портале Битрикс24 в меню слева откройте раздел «Приложения» и выберите Олчат Telegram.
2. На главной странице приложения нажмите на значок настроек ⚙ в правом верхнем углу.
3. В разделе «Общие» настроек нажмите на кнопку «Открыть уведомления», чтобы перейти в нужный чат.
4. Если необходимо предоставить доступ к чату сотрудникам, нажмите на кнопку «Добавить пользователя» и выберите из структуры компании нужных.
Рекомендуем добавить в этот чат администраторов портала, ответственных за интеграцию и техподдержку, — это позволит оперативно реагировать на проблемы с сессией Telegram или оплатой. ## Типы уведомлений ### Авторизация, подключение и отключение коннектора * При выборе способа «Получение кода» при авторизации коннектора (ввод номера телефона → ожидание кода от Telegram):
* При выборе способа авторизации через QR-код:
* При успешной авторизации и подключении вы увидите «Подключено».
* При потере сессии или выходе из аккаунта придёт уведомление «Не подключено».
### Оплата коннектора * Олчат Telegram предупредит об окончании тестового периода за 24 часа:
* Когда тестовый период завершится, придёт следующее уведомление:

# Добавление дополнительных аккаунтов Telegram Вы можете подключить несколько аккаунтов Telegram в ваш Битрикс24 и создать для каждого отдельную Открытую линию. С помощью настроек Открытых линий вы можете выбрать тех сотрудников, которые будут иметь право на использование конкретного номера и настроить индивидуальные сценарии работы для каждого подключенного аккаунта Telegram. {% hint style="info" %} Каждый подключенный коннектор (аккаунт Telegram) оплачивается отдельно. Подробнее о тарифах приложения вы можете узнать из статьи [Тарифы приложения](/stoimost-i-oplata-prilozheniya). {% endhint %} Чтобы подключить новый аккаунт Telegram перейдите в настройки приложения Олчат: Telegram (в меню слева) и нажмите на кнопку «+ Подключить аккаунт».
На открывшейся странице выберите Открытую линию, к которой хотите подключить новый аккаунт Telegram, либо создайте новую Открытую линию. Затем нажмите на кнопку «ПОДКЛЮЧИТЬ».
{% hint style="info" %} Подробнее о подключении коннектора и настройке Открытой линии вы можете узнать из статьи [Настройка открытой линии](/ustanovka-i-nastroika/nastroika-otkrytoi-linii). {% endhint %} # Синхронизация контактов CRM с телефонной книгой Когда вы пишете клиенту первым из CRM (системы управления взаимоотношениями с клиентами), модуль интеграции добавляет клиента в контакты вашего аккаунта Telegram. При этом существуют [ограничения на количество и скорость добавления контактов за промежуток времени](/vazhnaya-informaciya), а при превышении лимитов значительно увеличиваются риски блокировки аккаунта Telegram. Чтобы этого избежать, мы рекомендуем синхронизировать вашу телефонную книгу с CRM. {% hint style="warning" %} Обращаем внимание, что описана **синхронизация контактов из CRM на устройство (в телефон).** Контакты не синхронизируются с устройства прямо в Битрикс24. Сейчас создана заявка в разработку со стороны Битрикс24 № 97298 на двустороннюю синхронизацию. {% endhint %} ### Настройка синхронизации для устройств на iOS В Битрикс24 доступна синхронизация контактов с мобильным телефоном по протоколу CardDAV. Apple iPhone, iPad, Mac по умолчанию поддерживают протокол CardDAV. Прежде чем начать синхронизацию контактов по протоколу CardDAV, нужно перейти на страницу вашего профиля и нажать на кнопку «БЕЗОПАСНОСТЬ».
Перейдите на страницу «Синхронизация» и выполните настройки на вашем устройстве Apple согласно пошаговой инструкции:
Далее, выберите **Контакты CRM** или **Компании CRM**, или и то и другое и установите галочку **Включить.**
Также можно выбрать, какие контакты и компании из CRM синхронизировать – Свои или Все и их количество. После настроек нажмите на кнопку «СОХРАНИТЬ». ### Настройка синхронизации для устройств на Android Для синхронизации контактов в Android-устройствах по протоколу CardDAV, скорее всего, понадобятся сторонние приложения, доступные в магазине приложений. Кроме этого, вы можете настроить синхронизацию с помощью добавления аккаунта Битрикс24 в настройках аккаунтов и синхронизации. Для этого в настройках телефона перейдите в пункт Аккаунты и синхронизация. В зависимости от модели телефона, он может называться иначе: Аккаунты, Учётные записи и т.д. Выберите пункт «Добавить аккаунт»:
Выберите аккаунт Битрикс24:
Введите регистрационные данные: * Адрес вашего портала Битрикс24. * Логин или e-mail, который вы используете для входа. * Пароль. И нажмите «Сохранить».
После этого вы можете выбрать, что синхронизировать. В текущей ситуации необходимо синхронизировать контакты. Для этого нажмите на «Синхронизация аккаунта» и включите бегунок напротив необходимой позиции.
Также вы можете настроить частоту синхронизации Контактов:
# Работа с дубликатами в CRM В настройках конфиденциальности приложения Telegram пользователь может скрыть видимость своего номера телефона, установив в пункте «Кто видит мой номер телефона» значение «Никто»:
В этом случае, когда вы пишите клиенту из карточки сущности по номеру телефона, создаётся новый лид или сделка с никнеймом клиента:
Если вы столкнулись с данной ситуацией, рекомендуем сделать объединение сущностей. Для этого отметьте нужные сущности, выберите действие «Объединить» и нажмите на кнопку «ПРОДОЛЖИТЬ»:
При объединении вы можете указать приоритетную сущность. Она станет основой для итоговой карточки:
После объединения вы увидите итоговую карточку сущности, в которой сохранятся все значения полей, которые были выбраны в процессе объединения:
{% hint style="warning" %} На данный момент сам Битрикс24 поддерживает работу только с телефонами и электронными почтами. Другие идентификаторы, такие как username (имя пользователя) или ID (идентификатор) в Telegram, не распознаются системой и не могут быть сопоставлены с номерами телефонов. Но сейчас их данные идентификаторы можно записывать в другое поле. Открытые линии Битрикс24 не позволяют инициировать диалог первыми. Для создания нового диалога необходимо отправить «входящее» сообщение, что приводит к созданию нового лида. Это связано с невозможностью сопоставления номера телефона и идентификатора Telegram, создаваемого при начале чата. Каждая открытая линия имеет свой уникальный идентификатор, который можно увидеть в поле «Мессенджер» лида или контакта, если он создан. Этот идентификатор влияет на отображение иконки чата открытой линии. **Возможные действия:** 1. **Конвертация лида в существующий контакт**: при этом поле «Мессенджер» будет перенесено в контакт и станет видимым. 2. **Создание контакта из лида и объединение контактов**: это позволяет объединить информацию из лида с уже существующим контактом. {% endhint %} {% hint style="info" %} Подробнее с механизмом объединения сущностей вы можете ознакомиться в статьях Битрикс24 [Объединение лидов и сделок](https://helpdesk.bitrix24.ru/open/10374194/) и [Как объединить контакты и компании](https://helpdesk.bitrix24.ru/open/14289242/). {% endhint %} # Дополнительные настройки для коробочной версии Битрикс24 Если вы используете наше приложение в коробочной версии Битрикс24, для его корректной работы вам необходимо открыть доступы к нашему серверу и серверам Битрикс24. Ниже представлен минимальный список адресов и портов, которые необходимо открыть: **Наш сервер:** > 188.120.237.205 > > telegram.olchat.io **Сервера Битрикс24:** > cloud-messaging.bitrix24.com – Сервис пуш-уведомлений > > im.bitrix.info – Сервер коннекторов > > marta.bitrix.info – Сервис ботов, в том числе канал по network > > imsqs.bitrix.info, imsqs-ru.bitrix.info – Серверы очередей для ботов и открытых линий > > oauth.bitrix.info – Сервер REST авторизации > > marketplace.1c-bitrix.ru – Marketplace **Порты. Какие входящие сетевые соединения ожидает сервер:** > 80, 443 – стандартные HTTP/HTTPS порты > > 8893, 8894 – если используется push-сервер. > > Подробнее в статье Битрикс24 [Настроить сервис Push/RTC](https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=37\&CHAPTER_ID=09377\&LESSON_PATH=3908.8809.9377) {% hint style="info" %} Актуальность и полноту списка адресов Битрикс24 лучше уточнить в техподдержке Битрикс24 на момент подключения. {% endhint %} # Получение и отправка сообщений Общение с клиентом происходит через стандартный функционал[ открытых линий Битрикс24](https://www.bitrix24.ru/features/olines.php). Когда клиент пишет вам в Telegram, создаётся чат в карточке лида, в котором и ведётся дальнейшее общение. ## Работа с сообщениями Вы можете использовать все возможности открытых линий, такие как: приветственное сообщение, очередь операторов, оценка качества и другие. Для настройки возможностей воспользуйтесь данной [ссылкой](https://helpdesk.bitrix24.ru/open/2448369/). Чтобы продолжить общение с клиентом, достаточно нажать на иконку чата в карточке контакта, лида или сделки или нажать на кнопку «ОТКРЫТЬ».
### Удалённые и отредактированные сообщения Если клиент удаляет сообщение в Telegram, оно не исчезает из чата открытой линии. Сообщение остаётся видимым, но помечается красным крестиком (✖), чтобы было понятно, что оно было удалено клиентом.
Если клиент редактирует сообщение в Telegram, изменения также отображаются в чате открытой линии.
### Голосовые сообщения {% hint style="info" %} Для входящих голосовых сообщений длительностью до 5 минут добавлена функция автоматической текстовой расшифровки (транскрибации) сообщения. Текст сообщения отображается в чате открытой линии рядом с голосовым сообщением. Сам процесс расшифровки занимает 5-20 секунд. {% endhint %}
# Статусы коннектора В интерфейсе приложения Олчат: Telegram статус коннектора показывает текущее состояние подключения аккаунта Telegram к открытой линии. Статус можно увидеть в настройках коннектора (кнопка «•••» → «Настройки коннектора»). Ниже приведены все возможные статусы и рекомендации по работе с ними. ### **Не инициализирован** Коннектор создан, но авторизация в Telegram ещё не выполнялась. Этот статус обычно отображается сразу после добавления новой открытой линии. Начните процесс авторизации, выбрав удобный способ — через QR-код или ввод номера телефона. ### **Ожидание авторизации (qr)** Коннектор находится в режиме ожидания сканирования QR-кода с помощью мобильного приложения Telegram. Откройте приложение Telegram на смартфоне и отсканируйте предложенный QR-код. ### **Ожидание авторизации (код)** Коннектор ожидает ввода кода подтверждения, который Telegram отправил на указанный номер телефона. Введите полученный код в соответствующее поле в настройках коннектора. ### **Подключено** Коннектор успешно авторизован в Telegram и готов к полноценной работе. Это основной рабочий статус. В настройках коннектора при этом отображаются ID (идентификатор) аккаунта, имя пользователя и номер телефона. ### **Не оплачено** Оплата за использование коннектора отсутствует или истекла. В этом состоянии коннектор не обрабатывает сообщения. Оплатите коннектор в личном кабинете Олчат. ### **Загрузка...** Выполняется одна из длительных операций: первичная синхронизация данных после авторизации, перезагрузка коннектора или обновление настроек. Дождитесь завершения операции. Обычно это занимает от нескольких секунд до 10 минут. ### **Ограничение Telegram (flood)** Telegram применил временное ограничение на аккаунт из-за превышения лимитов на отправку сообщений (flood control). В период действия такого ограничения отправка первых сообщений новым контактам через Олчат будет заблокирована. Вы сможете отвечать только тем, кто написал вам первым. **Рекомендация:** * Напишите боту Spam Info Bot. Он покажет текущие ограничения на аккаунте, причину их наложения и примерное время действия. * Подождите автоматического снятия ограничения (от нескольких минут до 24–48 часов в зависимости от тяжести нарушения). * Снизьте частоту отправки сообщений, особенно новым контактам, которые не добавили ваш номер в телефонную книгу. * При необходимости перезагрузите коннектор с помощью иконки «↻» в настройках. # Отправка сообщений из приложения в карточке Для того чтобы написать сообщение клиенту, воспользуйтесь приложением **\[Олчат] Telegram** в карточке:
{% hint style="info" %} Если вы отправляете сообщение через приложение в первый раз после подключения интеграции, приложение может открываться не сразу, а спустя некоторое время. Во время открытия приложения вы увидите уведомление «Идёт загрузка приложения \[Олчат] Telegram». Связано это с синхронизацией ваших контактов Telegram с системой. Рекомендуем перезайти в приложение через 3-5 минут. {% endhint %}
### Откуда При отправке можно выбрать коннектор, через который вы отправляете сообщение. ### Кому В выпадающем списке указаны все найденные аккаунты Telegram. Поиск аккаунтов производится в полях **Телефон, Мессенджер** и **Сайт** в лиде или привязанной к сделке сущности (в контакте, в компании). Написать человеку можно по номеру или username (по имени пользователя). Подробнее о том, как правильно записывать контактные данные клиента в карточку CRM (системы управления взаимоотношениями с клиентами), описано в статье [Особенности записи контактных данных клиента в карточке CRM](/ispolzovanie/osobennosti-zapisi-kontaktnykh-dannykh-klienta-v-kartochke-crm).
Если вы хотите создать чат открытой линии и пригласить туда сотрудников портала для общения с клиентом, нажмите на кнопку «СОЗДАТЬ ЧАТ».
Также вы можете скопировать имя пользователя (username) клиента в Telegram, нажав на соответствующую кнопку.
### Отправка сообщений **СООБЩЕНИЕ** — здесь нужно указать текст, который вы хотите отправить.
**ФАЙЛЫ** — для прикрепления файла выберите его на компьютере. При необходимости активируйте галочку «Отправить как документ» для отправки файла без сжатия.
**ГОЛОСОВОЕ** — есть возможность записать и отправить голосовое сообщение. Для этого необходимо нажать на значок микрофона. После записи сообщение можно прослушать и при необходимости удалить.
**Способ публикации в открытой линии**: * **Входящее.** * **Без публикации.** * **Исходящее.** Если выбран тот или иной способ публикации в чате открытой линии и чат не был создан до этого, то он будет создан после публикации сообщения.
{% hint style="info" %} Ранее Открытые линии не позволяли писать клиенту первыми. Чтобы реализовать эту возможность, первое сообщение было как бы от лица клиента, и Битрикс24 думал, что это входящее сообщение. {% endhint %} При выборе способа **Входящее** сообщение будет опубликовано в чате как будто от лица клиента, но с пометкой «Олчат», показывающей, что это сообщение было написано методом публикации **Входящее.**
При выборе способа **Исходящее** сообщение будет опубликовано в Открытой линии как исходящее от того сотрудника, который выполнил отправку из карточки сообщения. Это новая возможность Открытых линий.
При выборе режима **Без публикации** сообщение не будет опубликовано в чате Открытой линии. **Создавать Дело в таймлайне** — если галочка установлена, то для отправленного сообщения будет создано дело со статусами доставки в таймлайне карточки сущности.
### Особенности настроек конфиденциальности номера в Telegram Иногда при попытке отправить клиенту сообщение может появиться ошибка: «На данный момент отправка сообщения недоступна. Подробнее обо всех причинах можно узнать [здесь](/vazhnaya-informaciya-1).
**Это уведомление может возникать по одной из следующих причин:** * номер телефона скрыт в [настройках конфиденциальности](/vazhnaya-informaciya-1#nastroiki-konfidencialnosti) Telegram; * превышены [лимиты](/vazhnaya-informaciya-1#limity); * [первый контакт](/vazhnaya-informaciya-1#pervyi-kontakt); * аккаунт [заблокирован](/vazhnaya-informaciya-1#blokirovka-akkaunta); * у клиента [отсутствует аккаунт](/vazhnaya-informaciya-1#net-akkaunta) Telegram. #### **Что делать** Когда вы пишете клиенту впервые, подождите около **5 минут** — за это время информация может прогрузиться — и затем повторите отправку сообщения. Если после ожидания уведомление продолжает отображаться, это означает, что номер телефона скрыт настройками конфиденциальности на стороне клиента (либо у клиента действительно нет Telegram-аккаунта). Если в разделе «Кто видит мой номер телефона?» выбран вариант «Никто», а в разделе – «Кто может найти меня по номеру?» вариант «Контакты» — вы увидите сообщение как на примере выше. Получить username и отправить на него сообщение, если вы не будете сохранены у клиента как контакт в его телефонной книге, не получится. # Особенности записи контактных данных клиента в карточке CRM При отправке сообщений в Telegram из приложения в карточке мы производим поиск контактных данных Telegram клиента в следующих стандартных полях в лиде или привязанной к сделке сущности (контакте, компании): 1. **Телефон (PHONE).** Запись телефона в поле необходимо производить в международном формате. 2. **Мессенджер (IM).** В поле в виде специальной формы записи хранится идентификатор пользователя открытой линии, ID (идентификатор) чата пользователя Telegram и другие параметры. Данный идентификатор создаётся автоматически. Чтобы он работал корректно, его нельзя изменять или добавлять самостоятельно!
Кроме этого, в поле **Мессенджер** может быть записан номер телефона в международном формате и Username (имя) пользователя Telegram:
3. **Сайт (WEB).** В данном поле необходимо хранить ссылки вида: `https://t.me/{username or phone}` или `https://{username}.t.me/`, где:\ `username` — имя пользователя Telegram `phone` — номер телефона пользователя Telegram в международном формате\ Укажите тип «Личный»
{% hint style="info" %} При условии соблюдения правильного формата записи мы сможем корректно обработать записанные в полях значения и отобразить в списке адресатов все найденные аккаунты Telegram. {% endhint %} # Отправка сообщений из мобильного приложения Битрикс24 Если вы работаете с мобильным приложением Битрикс24, то вы также имеете возможность первым написать клиенту. Необходимо перейти в сущность CRM (системы управления взаимоотношениями с клиентами), из которой вы планируете отправить сообщение, например, в сделку, и нажать на «+».
Затем необходимо выбрать функционал «СМС».
Затем в новом окне выбрать провайдера, через которого будет отправлено сообщение.
После этого выбрать необходимое приложение, если у вас их установлено несколько.
Введите текст сообщения в поле и отправьте. # Виджет в карточке CRM и Смарт-процессах Виджет обеспечивает быстрый доступ из карточки любой сущности CRM (системы управления взаимоотношениями с клиентами) к выбору линии, созданию нового чата, переходу в уже созданный чат, а также позволяет отправить сообщение клиенту прямо из карточки CRM, не переходя в основное приложение. ### Как включить виджет {% hint style="warning" %} Сначала нужно активировать виджет в настройках приложения. {% endhint %} 1. Перейдите в **настройки приложения** в правом верхнем углу**.**
2. Найдите раздел **Опции приложения**. 3. Включите параметр **«Виджет Олчат Telegram в карточке CRM».**
Отключение виджета производится путём снятия галочки. ### **Как показать виджет Олчат: Telegram в карточке CRM** Чтобы показать виджет в карточке CRM, зайдите в неё и нажмите на кнопку **Выбрать поле**.
В открывшемся списке полей установите галочку напротив «Олчат: Telegram» и нажмите на кнопку **Выбрать**.
Нажмите на кнопку **Обновить виджет**. Виджет будет готов к работе.
### **Как показать виджет Олчат Telegram в карточке Смарт-процесса** Чтобы показать виджет в карточке Смарт-процесса, выполните следующие действия. * В карточке Смарт-процесса создайте пользовательское поле с типом Олчат: Telegram. Для этого нажмите на кнопку **Создать поле** — **Дополнительные поля...**
* В выпадающем списке «Тип данных» выберите тип Олчат Telegram. В поле «Название» укажите название поля и нажмите на кнопку **СОХРАНИТЬ**.
* Войдите в режим редактирования карточки и установите виджет. Для входа в режим редактирования карточки нажмите на кнопку **Изменить**.
{% hint style="info" %} Нажатие на иконку «Обновить данные виджета» очищает данные поля виджета. Обновление данных можно использовать в том случае, если вы столкнулись с некорректным отображением идентификаторов клиента (номеров телефонов или username) в виджете. Например, добавили клиента с Telegram-аккаунтом в карточку, но в виджете он не появился. {% endhint %} Как написать из виджета, можно узнать [здесь](/ispolzovanie/vidzhet-v-kartochke-crm-i-smart-processakh/olchat-telegram). Подробнее о работе с приложением в карточке ознакомьтесь в статье [«Отправка сообщений из приложения в карточке»](https://tg.docs.olchat.io/ispolzovanie/kak-napisat-pervym-cherez-prilozhenie-olchat-v-kartochke). # Олчат: Telegram ## **Виджет Олчат : Telegram** Виджет Олчат: Telegram обеспечивает быстрый доступ из карточки любой сущности CRM (системы управления взаимоотношениями с клиентами) к выбору линии, созданию нового чата, переходу в уже созданный чат, а также позволяет отправить сообщение клиенту прямо из карточки CRM, не переходя в основное приложение. {% hint style="info" %} По умолчанию виджет «Олчат: Telegram» при открытии карточки сущности отображается в скрытом виде с кнопкой «Обновить виджет». {% endhint %} Подробнее о том, как включить и показать виджет в карточке, ознакомьтесь [по ссылке](/ispolzovanie/vidzhet-v-kartochke-crm-i-smart-processakh). #### **Выбор линии и идентификатора клиента (номер телефона или username)** Если к вашему порталу подключено несколько коннекторов линий Telegram, вы можете выбрать, с какой именно линии начать диалог с клиентом.
Если к сущности CRM прикреплено несколько контактов или компаний, в виджет подтянутся все доступные идентификаторы клиента (номера телефонов и/или username (имя пользователя) Telegram), по которым возможен диалог. В виджете отобразится не более 5 идентификаторов. Чтобы увидеть остальные, нажмите кнопку «Показать больше». #### **Создание нового диалога и переход в уже созданный чат** Чтобы начать новый диалог с клиентом, выберите нужный идентификатор и нажмите на иконку «Создать чат».
Если диалог с клиентом уже начат и чат был создан ранее, отобразится «Открыть чат». После нажатия на эту кнопку вы перейдёте в существующий чат с клиентом.
{% hint style="info" %} Через виджет вы можете открыть чат, находясь в любой сущности CRM, даже если он не привязан напрямую к текущей сущности. {% endhint %} #### **Отправка сообщений, файлов и голосовых из виджета** Виджет позволяет отправить сообщение клиенту прямо из карточки CRM без перехода в основное приложение. Для этого нажмите на иконку «Написать в чат». В открывшемся поле введите текст сообщения и нажмите кнопку отправки.
Кроме обычного текстового сообщения с помощью виджета также можно: * Отправить файл. * Записать и отправить голосовое сообщение.
#### **Создавать Дело в таймлайне** Если чекбокс «Создавать Дело в таймлайне» активирован, после отправки сообщения в таймлайне карточки создастся дело с информацией о содержании сообщения.
#### **Режим отправки в Открытой линии** Сообщения можно отправить, используя режимы: * **Входящее**. Сообщение появляется как будто написал клиент (с пометкой Олчат). * **Без публикации**. Сообщение не появляется в чате Открытой линии вообще. * **Исходящее**. Сообщение отображается как ответ оператора (от имени сотрудника, который отправил).
#### **Обновление информации в виджете** Информация в виджете обновляется автоматически при открытии карточки и не реже, чем раз в несколько минут (точная частота зависит от настроек коннектора). #### **Что делать, если виджет не работает?** Необходимо проверить [«Права на приложение»](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. # Copy of Виджет в карточке CRM и Смарт-процессах Виджет обеспечивает быстрый доступ из карточки любой сущности CRM (системы управления взаимоотношениями с клиентами) к выбору линии, созданию нового чата, переходу в уже созданный чат, а также позволяет отправить сообщение клиенту прямо из карточки CRM, не переходя в основное приложение. ### Как включить виджет {% hint style="warning" %} Сначала нужно активировать виджет в настройках приложения. {% endhint %} 1. Перейдите в **настройки приложения** в правом верхнем углу**.**
2. Найдите раздел **Опции приложения**. 3. Включите параметр **«Виджет Олчат Telegram в карточке CRM».**
Отключение виджета производится путём снятия галочки. ### **Как показать виджет Олчат: Telegram в карточке CRM** Чтобы показать виджет в карточке CRM, зайдите в неё и нажмите на кнопку **Выбрать поле**.
В открывшемся списке полей установите галочку напротив «Олчат: Telegram» и нажмите на кнопку **Выбрать**.
Нажмите на кнопку **Обновить виджет**. Виджет будет готов к работе.
### **Как показать виджет Олчат Telegram в карточке Смарт-процесса** Чтобы показать виджет в карточке Смарт-процесса, выполните следующие действия. * В карточке Смарт-процесса создайте пользовательское поле с типом Олчат: Telegram. Для этого нажмите на кнопку **Создать поле** — **Дополнительные поля...**
* В выпадающем списке «Тип данных» выберите тип Олчат Telegram. В поле «Название» укажите название поля и нажмите на кнопку **СОХРАНИТЬ**.
* Войдите в режим редактирования карточки и установите виджет. Для входа в режим редактирования карточки нажмите на кнопку **Изменить**. При первой загрузке (до установки виджета в карточку Смарт-процесса) вы увидите надпись «Вы в режиме редактирования» и кнопку **Обновить данные виджета**.
При повторных загрузках карточки в режиме редактирования в виджете останется только кнопка **Обновить виджет**.
{% hint style="info" %} Обновление очищает данные поля виджета. Обновление данных можно использовать в том случае, если вы столкнулись с некорректным отображением идентификаторов клиента (номеров телефонов или username) в виджете. Например, добавили клиента с Telegram-аккаунтом в карточку, но в виджете он не появился. {% endhint %} Как написать из виджета, можно узнать [здесь](/ispolzovanie/vidzhet-v-kartochke-crm-i-smart-processakh/olchat-telegram). Подробнее о работе с приложением в карточке ознакомьтесь в статье [«Отправка сообщений из приложения в карточке»](https://tg.docs.olchat.io/ispolzovanie/kak-napisat-pervym-cherez-prilozhenie-olchat-v-kartochke). # Олчат: Telegram ## **Виджет Олчат : Telegram** Виджет Олчат: Telegram обеспечивает быстрый доступ из карточки любой сущности CRM (системы управления взаимоотношениями с клиентами) к выбору линии, созданию нового чата, переходу в уже созданный чат, а также позволяет отправить сообщение клиенту прямо из карточки CRM, не переходя в основное приложение. {% hint style="info" %} По умолчанию виджет «Олчат: Telegram» при открытии карточки сущности отображается в скрытом виде с кнопкой «Обновить виджет». {% endhint %} Подробнее о том, как включить и показать виджет в карточке, ознакомьтесь [по ссылке](/ispolzovanie/vidzhet-v-kartochke-crm-i-smart-processakh). #### **Выбор линии и идентификатора клиента (номер телефона или username)** Если к вашему порталу подключено несколько коннекторов линий Telegram, вы можете выбрать, с какой именно линии начать диалог с клиентом.
Если к сущности CRM прикреплено несколько контактов или компаний, в виджет подтянутся все доступные идентификаторы клиента (номера телефонов и/или username (имя пользователя) Telegram), по которым возможен диалог. В виджете отобразится не более 5 идентификаторов. Чтобы увидеть остальные, нажмите кнопку «Показать больше». #### **Создание нового диалога и переход в уже созданный чат** Чтобы начать новый диалог с клиентом, выберите нужный идентификатор и нажмите на иконку «Создать чат».
Если диалог с клиентом уже начат и чат был создан ранее, отобразится «Открыть чат». После нажатия на эту кнопку вы перейдёте в существующий чат с клиентом.
{% hint style="info" %} Через виджет вы можете открыть чат, находясь в любой сущности CRM, даже если он не привязан напрямую к текущей сущности. {% endhint %} #### **Отправка сообщений, файлов и голосовых из виджета** Виджет позволяет отправить сообщение клиенту прямо из карточки CRM без перехода в основное приложение. Для этого нажмите на иконку «Написать в чат». В открывшемся поле введите текст сообщения и нажмите кнопку отправки.
Кроме обычного текстового сообщения с помощью виджета также можно: * Отправить файл. * Записать и отправить голосовое сообщение.
#### **Создавать Дело в таймлайне** Если чекбокс «Создавать Дело в таймлайне» активирован, после отправки сообщения в таймлайне карточки создастся дело с информацией о содержании сообщения.
#### **Режим отправки в Открытой линии** Сообщения можно отправить, используя режимы: * **Входящее**. Сообщение появляется как будто написал клиент (с пометкой Олчат). * **Без публикации**. Сообщение не появляется в чате Открытой линии вообще. * **Исходящее**. Сообщение отображается как ответ оператора (от имени сотрудника, который отправил).
#### **Обновление информации в виджете** Информация в виджете обновляется автоматически при открытии карточки и не реже, чем раз в несколько минут (точная частота зависит от настроек коннектора). #### **Что делать, если виджет не работает?** Необходимо проверить [«Права на приложение»](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. # Виджет на сайт Для добавления виджета Telegram на ваш сайт в левом меню портала войдите в приложение **Олчат: Telegram —** ••• **— Настройки коннектора — Настройки — Настройка виджета на сайт.** Укажите название виджета в соответствующем поле. Нажмите на кнопку «ОБНОВИТЬ ВИДЖЕТ». Также вы можете скопировать ссылку на чат в Telegram из поля, в котором прописана ссылка, нажав на иконку «📄».
Далее перейдите в **Контакт-центр — Виджет на сайт**.
Включите канал в настройках виджета:
Если у вас уже существует и настроен виджет с каким-то набором подключенных к нему каналов, вы можете подключить к нему канал из другой линии. Это может пригодиться в случае, если для приложения Олчат: Telegram вы использовали отдельную открытую линию со своим сценарием обработки и распределения входящих сообщений от клиентов. Для добавления канала Telegram из открытой линии подключенной к приложению Олчат: Telegram, в настройках виджета нажмите ссылку «добавить открытую линию».
Выберите нужную открытую линию. Включите канал в настройках виджета.
{% hint style="info" %} После установки виджет может появиться на сайте не сразу, т.к. он кэшируется на стороне Битрикс24. Чаще всего такое случается на коробочных версиях Битрикс24. Обновляться виджет может в течение 15-60 минут. Для ускорения обновления данных в виджете рекомендуем выключать и включать виджет. Тогда кэш виджета обновляется быстрее и применяются новые настройки. {% endhint %} Для выключения и включения виджета перейдите в раздел **CRM – Интеграции – Виджет на сайт**. Найдите нужный виджет и напротив него нажмите на кнопку «ВЫКЛЮЧИТЬ», а затем «ВКЛЮЧИТЬ».
Установленный виджет отобразится на сайте:
{% hint style="info" %} Настройка виджета для сайта в Битрикс24\ . {% endhint %} # Шаблоны сообщений Если вы регулярно отправляете однотипные сообщения клиентам в Telegram, воспользуйтесь шаблонами сообщений Олчат. Эти шаблоны универсальны и работают для каналов Олчат, включая Telegram. Отправка шаблонов сообщений входит в базовые возможности приложения Олчат и доступна всем пользователям. ## **Настройка и создание шаблонов** Шаблоны создаются и редактируются в отдельном приложении Олчат WhatsApp. Подробная инструкция по созданию, редактированию, категориям и переменным доступна [здесь](https://docs.olchat.io/capabilities/shablony-soobshenii). Для работы с шаблонами сообщений в Telegram установите следующие приложения: * **Олчат — Чаты и Группы Telegram** (основное приложение для подключения чатов и групп Telegram к Открытым линиям). * **Олчат — Чаты и Группы WhatsApp,** [как установить приложение](https://docs.olchat.io/ustanovka-i-nastroika/ustanovka-prilozheniya). Функция шаблонов не включается автоматически. Чтобы шаблоны отображались в чатах Открытой линии, её необходимо включить вручную: 1. Перейдите в приложение Олчат WhatsApp → пункт меню **Настройки приложения**. 2. Откройте вкладку **Возможности**. 3. Включите переключатель **Шаблоны в чате**.
Без включения этой настройки значок выбора шаблонов в поле ввода сообщения чата не появится. #### **Кратко о настройке шаблонов** 1. Перейдите в приложение Олчат WhatsApp в левом меню портала Битрикс24.
2. Выберите пункт меню **Настройки шаблонов**.
3. Нажмите **Создать шаблон**.
4. Укажите название шаблона и текст шаблона.
* Для подстановки переменных из CRM (системы управления взаимоотношениями с клиентами) нажмите значок **{ }** → выберите поле (Сделка, Контакт, Компания, Лид и др.). * При отправке значения в **{{название\_поля}}** заменяются автоматически.
5. На следующем шаге (опционально) присвойте **категорию** и укажите **права доступа** (если пусто — доступ всем сотрудникам).
6. Нажмите **Сохранить**. Шаблоны можно сортировать, искать, фильтровать по категориям, редактировать или удалять в общем списке. #### **Управление категориями** В разделе **Настройки шаблонов** нажмите значок шестерёнки **⚙️** → **Создать категорию** → введите название → **Добавить**. Категории помогают быстро находить нужные шаблоны при работе в чатах.
#### **Отправка шаблонного сообщения из чата Открытой линии**. 1. Откройте чат с клиентом в Открытой линии (Telegram-канал). 2. В поле ввода сообщения нажмите значок **Редактирование и выбор шаблонов**.
3. В открывшемся окне выберите нужный шаблон из списка. * Текст шаблона автоматически вставится в поле ввода. * Переменные подставятся из связанных полей CRM (если чат привязан к сущности: сделка, лид, контакт и т.д.). 4. При необходимости отредактируйте текст вручную. 5. Нажмите **Отправить**. #### **Дополнительные опции в окне выбора шаблонов (в чате):** * Строка поиска по ключевым словам в названии или тексте.
* Фильтр по категориям.
* Переключатель **Отображать текст шаблона** — включает/выключает показ полного текста в списке (для компактного вида оставьте только названия).
* Режим вставки: * **Вставить шаблон в чат** — окно остаётся открытым (удобно для отправки нескольких шаблонов подряд). * **Вставить шаблон в чат и закрыть окно** — автоматическое закрытие после вставки. * Кнопка **+ Создать шаблон** — позволяет добавить новый шаблон прямо из чата, без перехода в настройки.
## **Отправка шаблонов из карточки CRM (приложение** Олчат **в карточке)** Отправка шаблонов напрямую из поля **Шаблоны** в карточке сущности (лид, контакт, сделка, компания) для каналов Telegram недоступна. {% hint style="info" %} Для оперативной работы с клиентами в Telegram используйте шаблоны именно через чат Открытой линии — это наиболее удобный и быстрый способ. Если нужно отправить шаблон из карточки — пока переключайтесь в чат Открытой линии или копируйте текст шаблона вручную. {% endhint %} # Роботы и активити (действия) бизнес-процессов {% hint style="warning" %} Функционал роботов в лидах и сделках доступен в Битрикс24 на тарифах **«Базовый»**, **«Стандартный»**, **«Профессиональный»** и **«Энтерпрайз»**.Функционал **активити (действий) в бизнес-процессах** доступен в Битрикс24 на тарифах **«Профессиональный»** и **«Энтерпрайз»**. {% endhint %} {% hint style="info" %} Общая информация по работе с роботами в Битрикс24: Роботы Битрикс24.Общая информация по работе с бизнес-процессами в Битрикс24: Видео-курс о бизнес-процессах. {% endhint %} ### Установка роботов и активити Включить роботов и активити можно в настройках приложения: **Олчат: Telegram — Настройки — Роботы и Бизнес-процессы** нажатием на кнопку «ПЕРЕУСТАНОВИТЬ ВСЕ».​Статус возле названия робота в виде значка ✅ свидетельствует о том, что роботы установлены корректно. ### Описание роботов и активити * [​Поиск пользователя в Telegram](/roboty-i-aktiviti/roboty-i-aktiviti-deistviya-biznes-processov/poisk-polzovatelya-v-telegram). * Информация о чате Telegram. * ​[Отправить сообщение](/roboty-i-aktiviti/roboty-i-aktiviti-deistviya-biznes-processov/otpravka-soobsheniya). * ​[Отправить файл](/roboty-i-aktiviti/roboty-i-aktiviti-deistviya-biznes-processov/otpravka-faila). * Ожидать сообщение. * Создать группу. * Присоединиться к группе. * Покинуть группу. * Удалить группу. * Добавить пользователя в группу. * Забанить пользователя группы. * Разбанить пользователя группы. # Поиск пользователя в Telegram ### Настройка робота Для проверки присутствия пользователя в Telegram добавьте робота «\[Олчат: Telegram] Поиск пользователя в Telegram». Для этого перейдите в **Роботы ‒ Создать ‒ Выбор стадии ‒ Другие роботы ‒ \[Олчат: Telegram] Поиск пользователя в Telegram ‒ Добавить.**
Выполните настройку робота**.** Для этого на добавленном роботе нажмите на кнопку «изменить», чтобы открыть интерфейс редактирования робота: 1. В поле **Линия коннектора** укажите линию, через которую планируете сделать проверку 2. Укажите **Тип идентификатора чата**. В качестве идентификатора может выступать **ID (идентификатор) чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора, в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username (имя пользователя),** которые необходимо проверить на существование аккаунта в Telegram.
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «СОХРАНИТЬ» ### Настройка активити (действия) бизнес-процесса Для проверки присутствия пользователя в Telegram, добавьте действие «\[Олчат: Telegram] Поиск пользователя в Telegram».
Выполните настройку параметров действия: 1. В поле **Линия коннектора** укажите линию, через которую планируете сделать проверку 2. Укажите **Тип идентификатора чата**. В качестве идентификатора может выступать **ID чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора, в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username,** которые необходимо проверить на существование аккаунта в Telegram.
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «Сохранить». {% hint style="info" %} Вся информация о пользователе Telegram, которую можно использовать в дальнейших сценариях автоматизации будет содержаться в дополнительных результатах робота или активити: {% endhint %}
# Информация о чате Telegram # Отправка сообщения ### Настройка робота Для отправки сообщения добавьте робота «\[Олчат: Telegram] Отправка сообщения». Для этого перейдите в **Роботы ‒ Создать ‒ Выбор стадии ‒ Другие роботы ‒ \[Олчат: Telegram] Отправка сообщения ‒ Добавить.**
Выполните настройку робота**.** Для этого на добавленном роботе нажмите на кнопку «изменить», чтобы открыть интерфейс редактирования робота: 1. В поле **Линия коннектора** укажите линию, через которую планируете сделать отправку 2. Укажите **Тип идентификатора чата**. В качестве идентификатора может выступать **ID (идентификатор) чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора, в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username (имя пользователя),** куда будет отправлено сообщение. {% hint style="info" %} Если в поле **«Идентификатор чата»** вы выбираете вариант **«Номер телефона»**, важно убедиться, что в настройках робота указано **корректное поле с номером телефона**. Например, если в карточке клиента заполнено поле **«Мобильный телефон»**, а в настройке робота в строке **«Номер телефона»** указана переменная **{{Рабочий телефон}}**, робот **не сможет найти номер** — в результате сообщение **не будет отправлено**.\ Чтобы робот корректно подставлял номер из **любого** заполненного телефонного поля, рекомендуем в строке **«Номер телефона»** выбрать переменную **{{Телефон (текст)}}**. Указать её можно через меню **«…» (три точки)** напротив строки **«Номер телефона»**. {% endhint %} 4. Введите текст **Сообщения.** 5. В поле **Публикация в чате открытой линии?** укажите каким образом отправленное роботом сообщение отобразится в чате Открытой линии. Доступны варианты: **входящим сообщением в ОЛ, без публикации в ОЛ** и **исходящим в ОЛ.**
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «СОХРАНИТЬ». ### Настройка активити (действия) бизнес-процесса Для отправки сообщения из бизнес-процесса добавьте действие «\[Олчат: Telegram] Отправка сообщения».
Выполните настройку параметров действия: 1. В поле **Линия коннектора** укажите линию, через которую планируете сделать отправку. 2. Укажите **Тип идентификатора чата**. В качестве идентификатора может выступать **ID чата, Номер телефона** или **Имя пользователя.** 3. В зависимости от выбранного типа идентификатора, в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username,** куда будет отправлено сообщение. {% hint style="info" %} Если в поле **«Идентификатор чата»** вы выбираете вариант **«Номер телефона»**, важно убедиться, что в настройках робота указано **корректное поле с номером телефона**. Например, если в карточке клиента заполнено поле **«Мобильный телефон»**, а в настройке робота в строке **«Номер телефона»** указана переменная **{{Рабочий телефон}}**, робот **не сможет найти номер** — в результате сообщение **не будет отправлено**.\ Чтобы робот корректно подставлял номер из **любого** заполненного телефонного поля, рекомендуем в строке **«Номер телефона»** выбрать переменную **{{Телефон (текст)}}**. Указать её можно через меню **«…» (три точки)** напротив строки **«Номер телефона»**. {% endhint %} 4. Введите текст **Сообщения.** 5. В поле **Публикация в чате открытой линии?** укажите каким образом отправленное роботом сообщение отобразится в чате Открытой линии. Доступны варианты: **входящим сообщением в ОЛ, без публикации в ОЛ** и **исходящим в ОЛ.**
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку **Сохранить**. # Отправка файла ### Настройка робота Чтобы отправить файл, добавьте робота «\[Олчат: Telegram] Отправка файла». Для этого перейдите в **Роботы ‒ Создать ‒ Выбор стадии ‒ Другие роботы ‒ \[Олчат: Telegram] Отправка файла ‒ Добавить.**
Выполните настройку робота**.** На добавленном роботе нажмите на кнопку «изменить», чтобы открыть интерфейс редактирования робота: 1. В поле **Линия коннектора** укажите линию, которую планируете использовать. 2. Укажите **Тип идентификатора чата**. Это может быть **ID (идентификатор) чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username (имя пользователя),** куда будет отправлен файл. 4. В поле **Тип источника файла** выберите пункт **Прямая ссылка на файл, Битрикс24.Диск (ID файла), Файл из поля CRM (системы** управления взаимоотношениями с клиентами). 5. В зависимости от выбранного типа источника файла в поле **Прямая ссылка на файл, ID файла на диске, ID поля** укажите ссылку на файл, его ID или ID поля, в котором он находится. 6. В поле **Отправить как документ?** выберите **Да,** если хотите чтобы файл отправился как документ, без сжатия и потери качества, или **Нет,** если уменьшение размера файла допустимо. 7. В поле **Публикация в чате открытой линии?** укажите, каким образом отправленное роботом сообщение отобразится в чате Открытой линии. Доступны варианты: **входящим сообщением в ОЛ, без публикации в ОЛ** и **исходящим в ОЛ.** 8. При необходимости в поле **Подпись** укажите текст, который будет прикреплён к отправляемому файлу. Поддерживается в документах, изображениях и видео.
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «СОХРАНИТЬ». ### Настройка активити (действия) бизнес-процесса Для отправки файла из бизнес-процесса добавьте действие «\[Олчат: Telegram] Отправка файла».
Выполните настройку параметров действия: 1. В поле **Линия коннектора** укажите линию, которую планируете использовать. 2. Укажите **Тип идентификатора чата**. Это может быть **ID чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username,** куда будет отправлен файл. 4. В поле **Тип источника файла** выберите пункт **Прямая ссылка на файл, Битрикс24.Диск (ID файла), Файл из поля CRM**. 5. В зависимости от выбранного типа источника файла в поле **Прямая ссылка на файл, ID файла на диске, ID поля** укажите ссылку на файл, его ID или ID поля, в котором он находится. 6. В поле **Отправить как документ?** выберите **Да,** если хотите чтобы файл отправился как документ, без сжатия и потери качества, или **Нет,** если уменьшение размера файла допустимо. 7. В поле **Публикация в чате открытой линии?** укажите, каким образом отправленное роботом сообщение отобразится в чате Открытой линии. Доступны варианты: **Входящим сообщением в ОЛ, Без публикации в ОЛ** и **Исходящим в ОЛ.**
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «Сохранить». # Создать группу # Ожидать сообщение # Отправка контакта ### Настройка робота Чтобы отправить контакт добавьте робота «\[Олчат: Telegram] Отправка контакта». Для этого перейдите в **Роботы ‒ Создать ‒ Выбор стадии ‒ Другие роботы ‒ \[Олчат: Telegram] Отправка контакта ‒ Добавить.**
Выполните настройку робота. Для этого на добавленном роботе нажмите на кнопку «изменить», чтобы открыть интерфейс редактирования робота: 1. В поле **Линия коннектора** укажите линию, через которую планируете сделать отправку. 2. Укажите **Тип идентификатора чата**. В качестве идентификатора может выступать **ID чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора, в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username,** куда будет отправлен контакт. 4. Укажите **Номер телефона контакта**. 5. Укажите **Имя контакта.** 6. Укажите **Фамилию контакта.** 7. В поле **Публикация в чате открытой линии?** укажите каким образом отправленное роботом сообщение отобразится в чате Открытой линии. Доступны варианты: **Входящим сообщением в ОЛ, Без публикации в ОЛ** и **Исходящим в ОЛ.** {% hint style="warning" %} В настоящее время **Публикация в чате открытой линии** возможно только **Входящим сообщением!** Публикация **Исходящим в ОЛ** недоступна. Техотдел работает над добавлением такой возможности. {% endhint %} Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «СОХРАНИТЬ» ### Настройка активити (действия) бизнес-процесса Для отправки контакта из бизнес-процесса добавьте действие «\[Олчат: Telegram] Отправка контакта».
Выполните настройку параметров действия: 1. В поле **Линия коннектора** укажите линию, через которую планируете сделать отправку. 2. Укажите **Тип идентификатора чата**. В качестве идентификатора может выступать **ID чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора, в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username,** куда будет отправлен контакт. 4. Укажите **Номер телефона контакта**. 5. Укажите **Имя контакта.** 6. Укажите **Фамилию контакта.** 7. В поле **Публикация в чате открытой линии?** укажите каким образом отправленное роботом сообщение отобразится в чате Открытой линии. Доступны варианты: **Входящим сообщением в ОЛ, Без публикации в ОЛ** и **Исходящим в ОЛ.** {% hint style="warning" %} В настоящее время **Публикация в чате открытой линии** возможно только **Входящим сообщением!** Публикация **Исходящим в ОЛ** недоступна. Техотдел работает над добавлением такой возможности. {% endhint %} # Отправка местоположения ### Настройка робота Чтобы отправить карту с местоположением, заданным координатами широты и долготы, добавьте робота «\[Олчат: Telegram] Отправка местоположения». Для этого перейдите в **Роботы ‒ Создать ‒ Выбор стадии ‒ Другие роботы ‒ \[Олчат: Telegram] Отправка местоположения ‒ Добавить.**
Выполните настройку робота. Для этого на добавленном роботе нажмите на кнопку «изменить», чтобы открыть интерфейс редактирования робота: 1. В поле **Линия коннектора** укажите линию, через которую планируете сделать отправку. 2. Укажите **Тип идентификатора чата**. В качестве идентификатора может выступать **ID чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора, в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username,** куда будет отправлено местоположение. 4. Укажите **Широту** местоположения 5. Укажите **Долготу** местоположения 6. В поле **Публикация в чате открытой линии?** укажите каким образом отправленное роботом сообщение отобразится в чате Открытой линии. Доступны варианты: **Входящим сообщением в ОЛ, Без публикации в ОЛ** и **Исходящим в ОЛ.** {% hint style="warning" %} В настоящее время **Публикация в чате открытой линии** возможно только **Входящим сообщением!** Публикация **Исходящим в ОЛ** недоступна. Техотдел работает над добавлением такой возможности. {% endhint %}
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «СОХРАНИТЬ» ### Настройка активити (действия) бизнес-процесса Для отправки карты с местоположением из бизнес-процесса добавьте действие «\[Олчат: Telegram] Отправка местоположения».
Выполните настройку параметров действия: 1. В поле **Линия коннектора** укажите линию, через которую планируете сделать отправку. 2. Укажите **Тип идентификатора чата**. В качестве идентификатора может выступать **ID чата, Номер телефона** или **Имя пользователя**. 3. В зависимости от выбранного типа идентификатора, в поле **Идентификатор чата** укажите **Номер телефона, ID чата** или **username,** куда будет отправлено местоположение. 4. Укажите **Широту** местоположения 5. Укажите **Долготу** местоположения 6. В поле **Публикация в чате открытой линии?** укажите каким образом отправленное роботом сообщение отобразится в чате Открытой линии. Доступны варианты: **Входящим сообщением в ОЛ, Без публикации в ОЛ** и **Исходящим в ОЛ.** {% hint style="warning" %} В настоящее время **Публикация в чате открытой линии** возможно только **Входящим сообщением!** Публикация **Исходящим в ОЛ** недоступна. Техотдел работает над добавлением такой возможности. {% endhint %}
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «Сохранить». ### Отображение сообщения в чате Сообщение с местоположением в чате Телеграмм выглядит следующим образом: ### Получение координат с помощью Яндекс и Google карт Узнать широту и долготу адреса места можно воспользовавшись Яндекс или Google картами. #### В Яндекс картах: 1. Выберите место и кликните по нему левой клавишей мыши 2. В открывшемся слева меню найдите пункт «Координаты» и нажмите на числовые значения координат. Координаты скопируются в буфер и будут доступны для вставки в поле в роботе ![](/files/-MkpkIgSzRsUWVdDJl17) #### В Google картах: 1. Выберите место и кликните по нему правой клавишей мыши 2. В открывшемся контекстном меню в первой строке отобразятся координаты места. Нажмите левой клавишей мыши на указанные цифры. Координаты скопируются в буфер и будут доступны для вставки в поле в роботе
# Отладка и поиск ошибок # Как вывести результат работы робота в комментарий При разработке и использовании уже настроенных роботов, бывает необходимо узнать подробности выполнения того или иного робота. Для этого в системе предусмотрен журнал выполнения бизнес-процессов (лог). Однако данный журнал недоступен на тарифах Битрикс24, в которых нет бизнес-процессов. Если на вашем тарифе нет журнала бизнес-процессов, выходом из ситуации может служить вывод результатов работы робота в комментарий в сущности. Выполним пошаговую настройку следующего сценария работы: 1. Робот отправляет сообщение в Telegram. 2. Результат выполнения робота выводится в комментарий в таймлайне (хронологии) элемента. Для начала добавим робота **«\[Олчат: Telegram] Отправка сообщения»** и выполним его настройку.
Выведем результат работы робота в комментарий в таймлайне элемента. Для этого добавим стандартного робота Битрикс24 **«Добавить комментарий в элемент».**
Выполним настройку робота. Результат выполнения предыдущего робота **«\[Олчат] Отправка сообщения»** содержится в дополнительных результатах отработанного робота в разделе Роботы — \[Олчат: Telegram] Отправка сообщения. Добавим значения **«Сообщение отправлено?»** и **«Описание ошибки».**
Вывод можно оформить следующим образом, как показано на скриншоте ниже:
Установите галочку срабатывания «после предыдущего робота» и нажмите кнопку «СОХРАНИТЬ». Попробуем выполнить отправку. В статусе **«Сообщение отправлено?»** получаем вывод **«Y»**, что свидетельствует об успешной отправке, а **«Описание ошибки»** содержит пустое значение, т.к. ошибок не было.
Вы можете усовершенствовать вашего робота вывода сообщения в комментарий и выводить комментарий только в том случае, когда роботу **\[Олчат: Telegram] Отправка сообщения** не удалось отправить сообщение или присутствуют ошибки при отправке. Для этого в роботе **«Добавить комментарий в элемент»** выполните настройку условия, при котором будет производиться вывод комментария в таймлайн. Например, выведем только те комментарии, которые не соответствуют критерию **«Y»** (успешная отправка) в статусе **«Сообщение отправлено?»**
В этом случае вы будете получать комментарии в таймлайне только в том случае, если при отправке возникли проблемы. # Настройка отправки файла в зависимости от источника При отправке файла с помощью активити или робота «\[Олчат Telegram] Отправить файл» и выборе типа источника файла доступны варианты «Прямая ссылка на файл», «Битрикс24.Диск (ID файла)» или «Файл из поля CRM». В зависимости от выбранного типа источника необходимо указывать прямую ссылку на файл, его ID (идентификатор) на Диске Битрикс24 или ID поля CRM (системы управления взаимоотношениями с клиентами), в котором хранится отправляемый файл. ## **Создание прямой ссылки на файл** Прямая ссылка — это URL (уникальный адрес ресурса) вида , при переходе по которому Telegram сразу начинает скачивание файла без промежуточных страниц и авторизации. Файл можно разместить: * на собственном хостинге/сайте; * в сервисах, которые поддерживают генерацию прямых ссылок. {% hint style="warning" %} Через бизнес-процесс Битрикс24 невозможно получить прямую ссылку на скачивание файла из облачных хранилищ. Битрикс24, Dropbox, Google Drive, Яндекс.Диск и другие облачные сервисы по умолчанию не создают прямые ссылки на скачивание, а создают публичные ссылки с промежуточной страницей, где нужно для загрузки нажать кнопку «Скачать». {% endhint %} ## **Варианты создания прямых ссылок с помощью популярных сервисов** * **Dropbox:** измените параметр в конце ссылки с ?dl=0 на ?dl=1 или ?raw=1. Пример: * **Google Drive:** сделайте файл общедоступным («Доступ по ссылке»), затем преобразуйте ссылку вида в прямую: * **Яндекс.Диск:** 1. Сделайте файл публичным и скопируйте ссылку (например: или ). 2. Получите прямую ссылку через API Яндекса. Откройте в браузере адрес: Пример: 3. В ответе JSON найдите поле "href" — это и есть прямая (временная) ссылка на скачивание. Аналогичный принцип работает для других облачных сервисов: публичную ссылку нужно изменить, чтобы получить прямой URL на скачивание без промежуточной страницы. ## **Указание ID отправляемого файла (Битрикс24.Диск)** ID файла отображается в интерфейсе Диска Битрикс24: 1. Перейдите в раздел «Диск». 2. Найдите нужный файл. 3. В таблице или в деталях файла в столбце/поле «ID» будет указано число — это и есть нужный идентификатор.
{% hint style="info" %} Если столбец с ID отсутствует, нажмите на шестерёнку, чтобы выбрать, какие параметры должны отображаться в таблице. {% endhint %} Также ID файла можно получить в бизнес-процессе, воспользовавшись активити «Детально об объекте Диска».
## **Указание ID поля, в котором находится отправляемый файл** Чтобы узнать ID поля типа «Файл» в сущности CRM: 1. Перейдите в CRM → Настройки → Настройки CRM →Настройки форм и отчётов → Пользовательские поля. 2. Выберите сущность: Лид | Сделка | Контакт | Компания. 3. Откройте список полей → найдите нужное поле типа «Файл». 4. Откройте поле в режиме редактирования. 5. В адресной строке браузера увидите параметр вида FIELD\_ID=UF\_CRM\_XXXXXXXXXXXXX — скопируйте значение после =. Вставьте этот ID в поле «Поле файла» робота/активити «\[Олчат: Telegram] Отправка файла».
## **Важно** * При использовании короткой ссылки Битрикс24 убедитесь, что файл доступен без авторизации. # Групповые чаты Функционал групповых чатов Telegram позволяет подключить на портал Битрикс24 каналы, группы и супергруппы, в которых присутствует подключенный коннектор. Настройки позволяют гибко управлять подключенными группами. Вы можете выбрать режимы работы при получении в группе Telegram нового сообщения – создавать/не создавать чаты открытых линий или чаты Битрикса, запретить или разрешить пользователям отправлять сообщения в группы и т.д. {% hint style="warning" %} Внимание! В настоящее время функционал групповых чатов Telegram работает в бета-версии. Это означает, что некоторые функции могут быть недоступны или работать некорректно. Мы активно работаем над улучшением функционала и выпуском стабильной версии групповых чатов. {% endhint %} Для перехода к настройкам групп перейдите в приложение «Олчат: Telegram» в левом меню портала и напротив нужного коннектора нажмите на значок «**•••**» **– Настройки групп.**
{% hint style="info" %} Настройки групп по умолчанию можно установить на этапе «Настройка коннектора». Подробнее об этом написано [здесь](/ustanovka-i-nastroika/interfeisy-prilozheniya/opisanie-nastroek-konnektora). {% endhint %} ## Описание настроек групп Окно с настройками групп Telegram является главным интерфейсом, содержащим набор кнопок и ссылок для управления настройками групп, а также инструменты для поиска групп, фильтрации, сортировки и навигации по группам.
{% hint style="info" %} Из настроек групп можно сразу перейти в чат. Для этого выберите кнопку «Открыть чат» в строке соответствующей группы. {% endhint %}
### **Наименование коннектора** Указывается коннектор, для которого представлен список групп ### Меню для поиска, сортировки и управления настройками групп Меню содержит в себе несколько столбцов: 1. **Тип.** Может принимать значения: **Группа, Супергруппа, Канал.** Столбец позволяет производить фильтрацию по типам групп. 2. **Название.** Присутствует строка для ввода названия и поиска групп. 3. **Режим работы.** Настройка управляет событиями, которые будут происходить в момент поступления в группу нового сообщения. Может принимать значения: 1. **Создавать чаты ОЛ** – создастся чат в открытой линии. 2. **Создавать чаты Битрикс24** – создастся чат Битрикс24. **В настоящий момент данная функция временно не работает!** 3. **Не создавать чат** – при поступлении в группу нового сообщения никакие чаты в Битрикс24 созданы не будут. Присутствует возможность фильтрации по режимам работы. 4. **Отправка сообщений.** Настройка управляет возможностью отправки сообщений в группы с портала Битрикс24. Может принимать значения: 1. **Разрешена** – пользователи смогут отправлять сообщения в группы 2. **Запрещена** – пользователи не смогут отправлять сообщения в группы Присутствует возможность фильтрации по принимаемым значениям. В каждом столбце меню присутствует возможность сортировки. Для этого необходимо нажать на иконку со стрелочками: «↑↓». Также доступна множественная сортировка по нескольким столбцам. Для этого необходимо зажать «Ctrl» и выбрать нужные столбцы.
### ID Напротив каждой группы в строке отображается иконка ID. При клике на неё в буфер обмена копируется ID (идентификатор) выбранной группы.
### Настройки При клике на иконку шестерёнка «⚙️», открываются дополнительные настройки и информация о группе:
1. **Тип** группы**.** Может принимать значения: **Группа, Супергруппа, Канал.** 2. **Никнейм** группы. Может быть скопирован в буфер при клике на него. 3. **ID** группы. Может быть скопирован в буфер при клике на него. 4. **Название** группы. 5. **Режим работы.** Настройка управляет событиями, которые будут происходить в момент поступления в группу нового сообщения. 6. **Отправка сообщений.** Настройка управляет возможностью отправки сообщений в группы с портала Битрикс24. 7. **Скрывать имена сотрудников.** Настройка управляет возможностью скрывать или показывать имена сотрудников, от которых отправляется сообщение в группу. ### Очистить фильтры При клике на иконку значения фильтров в столбцах очищаются и на странице отображается максимально полный список групп.
### Постраничная навигация Если подключенный коннектор участвует в большом количестве групп, внизу страницы будет отображаться постраничная навигация. Вы сможете выбрать количество групп, отображаемых на странице, а также перейти на следующие страницы для просмотра остальных групп.
## Типы групп Тип группы может принимать значения: **Группа, Супергруппа, Канал.** **Канал** функционирует по модели подписки, представляя собой новостную ленту с элементами блог-контента. Пользователи подписываются на канал, чтобы получать обновления систематически. Сообщения, публикуемые в канале, подписчики получают не от имени автора, а от имени самого канала.\ Выделяют два вида каналов: 1. Публичные. Обладают постоянными именем и адресом и доступны для поиска через глобальный поиск в Telegram. 2. Приватные. Не поддаются поиску и предоставляют доступ через уникальную ссылку, которую можно изменить или скрыть для обеспечения конфиденциальности. Различия между **Группой** и **Супергруппой**: | Особенности | Группа | Супергруппа | | :------------------------------------------------: | :--------------------: | :-----------------------------------------------------------------------------------------: | | Количество участников | До 200 участников | До 200 000 участников | | Публичный доступ к сообществу | Нет | Может быть переключена на публичный доступ | | Управление сообществом | Только владелец | Владелец группы может назначить администраторов для совместного управления | | Бот с автоматическим управлением | Ограниченная поддержка | Полнофункциональные боты могут быть использованы для автоматического управления сообществом | | Возможность поиска через глобальный поиск Telegram | Нет | Можно искать при переходе на публичный доступ | В Telegram обычная группа может быть автоматически преобразована в супергруппу. Это происходит в следующих случаях: * Увеличение числа участников свыше 200. * Перевод группы в публичный режим (после этого можно вернуть её в приватный, группа останется супергруппой). * Изменение настроек видимости «Истории чата» для новых участников (можно вернуть обратно, группа не изменит статус супергруппы). * Присвоение администратору особого названия роли. * Модификация разрешений для любого из участников. * Активация «Медленного режима» в группе. * Присоединение группы к каналу. * Включение темы в группе. * Создание общей ссылки на папку с включением в неё группы. {% hint style="info" %} Команда Олчат никак не может повлиять на смену типа группы с обычной на супергруппу. Данные изменения происходят исключительно на стороне Telegram и могут произойти при выполнении даже одного пункта из списка выше. Для корректной работы рекомендуем сразу переводить тип группы в супергруппу. {% endhint %} При смене типа группы происходит и смена ID группы. В настройках групп Олчат Telegram ID активных супергрупп отображается в формате «100111111», т.е. всегда начинается с «100». Если произошла смена типа группы, в приложении Олчат Telegram будет дублирование групп. Написать в старую группу больше не получится - кнопки «Открыть чат» не будет. Используйте для работы ту группу, которая имеет тип «Супергруппа» и её ID начинается с «100...». Тип группы можно также отличить по значку в настройках приложения Олчат Telegram:
1. Группа. 2. Супергруппа. 3. Канал. # Подключение канала Чтобы подключить канал Telegram к Открытым линиям Битрикс24, выполните следующие действия: {% stepper %} {% step %} 1. Создайте канал в мобильной или веб-версии Telegram: 1. В мобильной версии откройте вкладку **Чаты** → над списком чатов выберите → далее **Создать канал**. 2. В веб-версии нажмите в нижней части списка чатов, далее **Создать канал**. 2. Укажите название канала, при необходимости добавьте описание и установите аватар. 3. Выберите тип канала: 1. «Публичный» — данный тип канала найдётся через поиск Telegram, а также вся информация в таком канале будет доступна пользователям, в том числе неподписанным на канал. 2. «Частный» канал нельзя найти через глобальный поиск Telegram, а информация в нём будет доступна только подписчикам. 4. Сформируйте ссылку на канал, а также установите параметры сохранения и копирования материалов (ползунок **Запретить копирование**). Это необязательный шаг, вернуться к нему можно будет позже через **Настройки канала**. 5. Добавьте первых подписчиков канала на следующем этапе и нажмите **Далее**. 6. Создание канала завершено. {% endstep %} {% step %} Создайте чат канала, если необходимо включить функцию комментирования постов. Без чата, прикреплённого к каналу, подписчики не смогут оставлять комментарии, а также начинать обсуждения. В настройках канала выберите пункт **Обсуждение** → **Добавить** → **+ Создать группу**. По умолчанию название чата формируется в виде: Название канала Chat. При необходимости настройте автоудаление сообщений, затем нажмите **Создать**. {% endstep %} {% step %} Откройте приложение Олчат Telegram, выберите линию, к которой подключен аккаунт с созданным каналом, и перейдите в настройки групп данной линии.
{% hint style="warning" %} Если канал создан на одном аккаунте Telegram (например, на личном), а к приложению Олчат Telegram подключен другой (например, рабочий), добавьте в канал аккаунт Олчат и выдайте ему следующие права администратора на управление сообщениями. В противном случае сообщения из открытых линий отправляться в канал не будут. {% endhint %} {% endstep %} {% step %} Настройте режим работы на создание чатов в открытых линиях (1), включите отправку сообщений (2).
{% hint style="warning" %} Недавно созданный канал может появиться в списке групп не сразу, а через некоторое время. Обычно это занимает до 15 минут. {% endhint %} {% endstep %} {% step %} Воспользуйтесь кнопкой **Открыть чат** (3) напротив канала или группы, чтобы начать диалог в открытой линии Битрикс24. Используйте открытую линию канала, чтобы публиковать посты через Битрикс24, а открытую линию чата для просмотра комментариев и обсуждений. {% hint style="warning" %} Чтобы ответить на комментарий пользователя, используйте непосредственно мобильную или веб-версию Telegram, так как в настоящий момент в случае ответа на пользовательский комментарий из открытой линии Битрикс24, пользователь не получит уведомления и не увидит ваш ответ. {% endhint %} {% endstep %} {% step %} Подключение канала к Олчат Telegram завершено. {% endstep %} {% endstepper %} В открытой линии Битрикс24, привязанной к **каналу**, сообщения будут выглядеть следующим образом:
Вид из мобильной версии Telegram:
В открытой линии Битрикс24, привязанной к **обсуждениям** канала, сообщения будут выглядеть следующим образом:
Вид из мобильной версии Telegram:
# Как прикрепить группу Telegram к сделке В Олчат группы Telegram отображаются в контакт-центре. Чтобы связать группу с конкретной сделкой, можно использовать два подхода. **Важно:** если требуется привязка чата к сущностям CRM (системы управления взаимоотношениями с клиентами), используйте первый вариант. ## Вариант 1. Привязка группы через сохранение в CRM Этот способ позволяет Битрикс24 корректно увидеть группу как диалог, связанный с контактом, компанией или сделкой. После привязки возможна полноценная автоматизация: роботы, задачи, изменение стадий и т.д. 1. Откройте нужную группу (**Олчат: Telegram** → **Настройки групп** → **Открыть чат**).
2. Нажмите на кнопку с тремя точками (⋮) в правом верхнем углу карточки группы. 3. Выберите пункт **Сохранить в CRM**. После выполнения система создаст (или привяжет) сущность к чату в зависимости от ваших настроек Открытой линии (создастся Лид или Сделка). #### Дальнейшие действия, если создался Лид 1. Перейдите в созданный Лид (ссылка появляется в системном уведомлении диалога). 2. Переместите Лид на финальную стадию (например, **Успешно реализовано** или **Квалифицирован** — в зависимости от вашей воронки).
3. Нажмите **Создать контакт** (или **Создать на основе лида**). #### Работа с контактом * Контакт с Telegram-группой можно привязать к компании или напрямую к сделке — в зависимости от вашего рабочего сценария. Привязка к компании: 1. Откройте контакт в режиме редактирования. 2. В поле **Компания** выберите существующую компанию. 3. Нажмите **Сохранить**. После привязки контакта к компании или сделке доступна автоматизация через роботы и бизнес-процессы. ## Вариант 2. Добавление ссылки на группу в поле сущности CRM (ручной способ) Вы можете сохранить прямую ссылку на групповой чат в поле типа **Ссылка**, чтобы содержимое было кликабельным. #### Как получить ссылку Чтобы получить ссылку, нужно: 1. Открыть нужный чат. 2. Нажать на количество участников, чтобы перейти к списку. 3. В открывшемся справа меню будет кнопка **Скопировать ссылку на чат**.
После формирования ссылки: * Вставьте её в нужное поле карточки сделки/ компании. * Ссылка станет кликабельной и позволит быстро перейти в группу из CRM. {% hint style="info" %} Cсылка носит исключительно справочный характер. {% endhint %} **Рекомендация:** для большинства сценариев автоматизации используйте именно первый вариант. Он обеспечивает полноценную интеграцию группы с CRM и позволяет задействовать весь функционал Битрикс24. # Отправка сообщений в групповой чат через умный сценарий с использованием ID группового чата {% hint style="warning" %} Данная статья предназначена для специалистов, обладающих практическим опытом настройки роботов и бизнес-процессов. Материал содержит технические детали и требует понимания принципов интеграции и автоматизации. При отсутствии соответствующего опыта, рекомендуем обратиться к квалифицированному подрядчику или интегратору. {% endhint %} Для отправки сообщений в групповой чат Telegram необходимо знать ID (идентификатор) группового чата. ID чата хранится в поле Мессенджер. В поле Мессенджер хранится специальная конструкция.\ ID чата в данной конструкции хранится на третьем месте, после символа |.
Чтобы из данной конструкции выделить ID чата и использовать его в дальнейшем для отправки в чат сообщения, можно воспользоваться специальной комбинацией формул: ``` {{=firstvalue(swirl(swirl(swirl(explode('|', "Значение поля Мессенджер")))))}} ``` Как работает данная комбинация формул: 1. **«Значение поля Мессенджер».** Поскольку поле Мессенджер множественное, укажите явно, в каком именно значении множественного поля Мессенджер у вас хранится ID чата и которое впоследствии будет использовано в формуле. Например, значение содержащееся в **{{Контакт Открытая линия (текст)}}.** 2. С помощью формулы [**explode**](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=57\&LESSON_ID=4912\&LESSON_PATH=5442.5446.5059.4912#explode) мы разделяем значения поля **{{Контакт Открытая линия (текст)}}** на несколько подзначений с помощью разделителя **|.** 3. С помощью формулы [**swirl**](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=57\&LESSON_ID=4912\&LESSON_PATH=5442.5446.5059.4912#swirl)**,** последовательно применённой 3 раза, мы перемещаем подзначение ID чата с 3-го на первое место. 4. С помощью формулы [**firstvalue**](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=57\&LESSON_ID=4912\&LESSON_PATH=5442.5446.5059.4912#firstvalue) мы забираем из строки с подзначениями то, которое стоит на первом месте. Далее можно переходить к настройкам умного сценария. Умные сценарии в Битрикс24 позволяют автоматизировать работу с лидами, сделками, контактами и компаниями. С помощью умных сценариев вы можете настроить последовательность роботов, которые совершат нужные действия для выбранных сущностей. В умных сценариях доступны все роботы приложения Олчат. Чтобы создать сценарий, необходимо перейти в раздел **CRM ‒ Сделки ‒ Список сценариев ‒ Умные сценарии ‒ Создать сценарий.**
В открывшемся окне укажите название и описание сценария.
В разделе «Роботы» добавим робота, который будет выполнять отправку сообщения в Telegram. Для этого необходимо нажать кнопку **+добавить ‒ Другие роботы ‒ \[Олчат ‒ Чаты и Группы Telegram] Отправка сообщения.** Выполните настройку робота:
1. В поле «Тип идентификатора чата» из выпадающего списка выберите значение «ID чата». 2. В поле «Идентификатор чата» укажите составленную комбинацию формул. ``` {{=firstvalue(swirl(swirl(swirl(explode('|', {{Контакт Открытая линия (текст)}})))))}} ``` 3. Напишите текст сообщения. 4. Сохраните настройки робота, нажав на кнопку «Сохранить». Умный сценарий готов и можно переходить к его запуску. Чтобы запустить умный сценарий, отметьте необходимые сущности, перейдите в **Список сценариев ‒ Умные сценарии ‒ Отправка сообщения.** Сценарий запустится и выполнит указанные в нём действия.
Чтобы отредактировать созданный сценарий, необходимо перейти в список сценариев.
В открывшемся окне вы увидите список всех доступных сценариев. Чтобы удалить или настроить сценарий, используйте соответствующие действия.
# Как отправить сообщение в Telegram, если номер телефона клиента скрыт? {% hint style="warning" %} Данная статья предназначена для специалистов, обладающих практическим опытом настройки роботов и бизнес-процессов. Материал содержит технические детали и требует понимания принципов интеграции и автоматизации. При отсутствии соответствующего опыта рекомендуем обратиться к квалифицированному подрядчику или интегратору. {% endhint %} {% hint style="warning" %} Функционал роботов в лидах и сделках доступен для тарифов Базовый, Стандартный, Профессиональный и Энтерпрайз. Функционал активити (действий) бизнес-процессов доступен для тарифов Профессиональный и Энтерпрайз. {% endhint %} Для отправки сообщения клиенту в Telegram в случае, когда его номер неизвестен, вы можете воспользоваться отправкой сообщения в чат по ID (по идентификатору) чата. ID чата хранится в поле Мессенджер. Здесь хранится специальная конструкция, которая имеет вид:
ID чата хранится на третьем месте, после символа |:
Чтобы выделить ID чата и использовать его в дальнейшем для отправки сообщения, можно воспользоваться специальной комбинацией формул: ``` {{=firstvalue(swirl(swirl(swirl(explode('|', "Значение поля Мессенджер")))))}} ``` Как работает данная комбинация формул: 1. **«Значение поля Мессенджер».** Поскольку поле Мессенджер множественное, укажите явно, в каком именно значении множественного поля Мессенджер у вас хранится ID чата и которое впоследствии будет использовано в формуле. Например, значение содержащееся в **{{Контакт: Мессенджер (текст)}}**. 2. С помощью формулы [**explode**](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=57\&LESSON_ID=4912\&LESSON_PATH=5442.5446.5059.4912#explode) мы разделяем значения поля **{{Контакт: Мессенджер (текст)}}** на несколько подзначений с помощью разделителя **|.** 3. С помощью формулы [**swirl**](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=57\&LESSON_ID=4912\&LESSON_PATH=5442.5446.5059.4912#swirl)**,** последовательно применённой 3 раза, перемещаем подзначение ID чата с 3-го на первое место. 4. С помощью формулы [**firstvalue**](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=57\&LESSON_ID=4912\&LESSON_PATH=5442.5446.5059.4912#firstvalue) забираем из строки с подзначениями то, которое стоит на первом месте. Далее можно переходить к настройкам робота:
1. В поле «Тип идентификатора чата» из выпадающего списка выберите значение «ID чата». 2. В поле «Идентификатор чата» укажите составленную комбинацию формул. 3. Напишите текст сообщения. 4. Сохраните настройки робота, нажав на кнопку «СОХРАНИТЬ». Если вы используете в работе бизнес-процессы, то можете настроить активити бизнес-процесса следующим образом:
1. В поле «Тип идентификатора чата» из выпадающего списка выберите значение «ID чата». 2. В поле «Идентификатор чата» укажите составленную комбинацию формул. 3. Напишите текст сообщения. 4. Сохраните настройки активити, нажав на кнопку «Сохранить». # Какое приложение Олчат установить для WhatsApp, Telegram и МАКС? Сейчас для подключения каналов используются несколько приложений Олчат: * Олчат WhatsApp — для подключения WhatsApp. * Олчат Telegram — для подключения Telegram. * Олчат ОМНИ — для подключения МАКС. В нём также доступна новая интеграция с Telegram. Раньше WhatsApp и Telegram работали в отдельных приложениях. Сейчас мы развиваем Олчат ОМНИ — общее приложение, в котором планируем объединить все каналы. Первой новой интеграцией в нём стал МАКС, вместе с ним появилась и новая версия Telegram. ## **Каким приложением пользоваться для Telegram** Telegram можно подключить через Олчат Telegram или Олчат ОМНИ. Пока рекомендуем использовать отдельное приложение Олчат Telegram — оно работает стабильнее и его функциональность лучше отработана. Если Telegram уже подключён через это приложение, переносить его в Олчат ОМНИ не нужно. Интеграция с Telegram в Олчат ОМНИ тоже работает, но её доработка ещё продолжается. ## **Зачем устанавливать Олчат ОМНИ** Олчат ОМНИ нужно установить, чтобы подключить МАКС. В дальнейшем это приложение станет единым для всех интеграций, и управлять ими можно будет в одном месте. Пока переход идёт постепенно, поэтому для WhatsApp, Telegram и МАКС используются разные приложения. Конкретные сроки полного объединения пока не определены. # Возникающие ошибки {% content-ref url="/pages/NevoAaOq66aM29honzwX" %} [Ошибка PRIVACY\_PREMIUM\_REQUIRED](/voprosy-i-otvety/voznikayushie-oshibki/oshibka-privacy_premium_required) {% endcontent-ref %} # Ошибка PRIVACY\_PREMIUM\_REQUIRED При отправке сообщения вы можете увидеть системное уведомление PRIVACY\_PREMIUM\_REQUIRED.
Это означает, что вы можете написать пользователю только при наличии премиум-аккаунта в Telegram. # Ошибка «Канал коммуникации не настроен» ### Причины, по которым не получается написать сообщение, и как их исправить 1. **Вы пишете в старый чат, который был создан другим приложением/коннектором, и сейчас этот коннектор не подключён к этой открытой линии.** \ Проверьте, к какому каналу и линии прикреплён чат: найдите его через список диалогов (CRM → Клиенты → Контакт-центр → Список диалогов). Если коннектор не тот, попробуйте [написать из приложения в карточке.](/ispolzovanie/kak-napisat-pervym-cherez-prilozhenie-olchat-v-kartochke)
2. **Коннектор отключён в настройках.** \ Проверьте[ статус коннектора](/ispolzovanie/statusy-konnektora) на главной странице приложения — он должен быть «Подключен». Если статус «QR-код», подключите номер, после этого можно писать. 3. **Вы пишете себе на подключённый номер.** \ Проверьте, на какой номер вы отправляете сообщение. 4. **В настройках открытой линии отключена галочка «Линия активна».** \ Статус линии (активна или нет) видит любой пользователь с доступом к Олчат Telegram. Поставить галочку и сделать линию активной может только администратор линии. Если галочка не стоит, попросите администратора портала её включить.
### Важно Для работы с каналами коммуникации не имеет значения, являетесь ли вы администратором портала Битрикс24. Главное — наличие соответствующих [прав доступа к коннектору и открытой линии](/ustanovka-i-nastroika/nastroika-prav-dlya-raboty-s-prilozheniem-olchat). Убедитесь, что у пользователя назначены необходимые разрешения для работы с выбранным каналом. # Статусы «Остановлено» и «Загрузка» ## **Что означает статус «Остановлено»?** Статус «Остановлено» появляется, когда у клиента возникают проблемы на линии. **Что делать:** 1. **Если требуется подтверждение сессии.**\ На телефоне клиента обязательно нужно нажать **Да, это я**. Telegram самостоятельно разрывает сессию, если подтверждение не выполнено. После этого приходят уведомления со статусом «Остановлено». \ В этом случае необходимо: 1. отключить номер; 2. заново подключить номер; 3. при подключении нажать «Это вы» или написать [в техподдержку](https://auth2.bitrix24.net/oauth/select/?preset=im\&IM_DIALOG=networkLines7c380c91ab28dacab02d3af93fecdbf9). 2. **Статус может появиться не только в начале работы.**\ Нужно написать [в техподдержку](https://auth2.bitrix24.net/oauth/select/?preset=im\&IM_DIALOG=networkLines7c380c91ab28dacab02d3af93fecdbf9). Мы перезагрузим коннектор — после этого всё должно заработать. ## **Что означает статус «Загрузка»?** Статус «Загрузка» является промежуточным. Если статус не меняется на «Подключено» более 5 минут, нужно написать [в техподдержку](https://auth2.bitrix24.net/oauth/select/?preset=im\&IM_DIALOG=networkLines7c380c91ab28dacab02d3af93fecdbf9). ## **Почему Telegram-коннектор сам подключается и отключается?** В периоды низкой нагрузки периодически проводятся работы по обновлению серверов и ПО. Из-за этого Telegram-коннектор может отправлять уведомления о подключении или остановке. Также интеграция с Telegram требует периодической смены серверов для повышения устойчивости работы и обхода ограничений. Это тоже может влиять на работу коннекторов и вызывать уведомления о переподключении.