Инструкция модуля интеграции
Telegram Personal

Если авторизация прошла успешно, вы увидите это в модуле.

QR-код имеет продолжительность жизни от 25-60 секунд, после истечения этого времени он будет удален, и вы сможете создать его повторно. После того как вы отсканировали QR-код, на стороне Telegram появится сессия CPython 3.11.15, далее нажмите на стороне модуля кнопку «Я отсканировал». Если видите сообщение «Ошибка авторизации через QR-код», это значит, что ответ от Telegram ещё не пришел, нажмите кнопку повторно несколько раз. В противном случае на стороне Telegram удалите сессию CPython 3.11.15, сгенерируйте новый код и отсканируйте его повторно.

После того как вы будете готовы отсканировать QR-код, нажмите кнопку «Получить QR-код».

В блоке авторизации доступно два способа: по QR-коду и по номеру телефона. Рекомендуем использовать по QR-коду, так как по номеру телефона код часто не приходит в Telegram.

Для авторизации по QR-коду вам необходимо подготовить телефон с аккаунтом Telegram, который будет подключен. В мобильном приложении Telegram пройдите в Настройки → Устройства → Подключить устройство.

После ввода названия нажмите «Сохранить», а после этого кнопку «Активировать канал». Если канал успешно активировался, блок с авторизацией станет доступен.

Перед вами предстанет окно настройки, первый блок отвечает за настройку транспортного канала, второй — за авторизацию для связи вашего аккаунта в Telegram и RetailCRM. Первым делом заполните поле «Название транспортного канала». Оно будет отображаться в чате в RetailCRM.

Для начала настройки нажмите кнопку "Добавить клиент".

В отобразившемся окне введите название и текст шаблона. Нажмите кнопку «Добавить». Создайте таким образом все необходимые шаблоны сообщений.

Перейдите во вкладку «Шаблоны». Нажмите кнопку «Добавить шаблон».

После нажатия на кнопку у вас откроется всплывающее окно с возможностью написать сообщение, использовать шаблон или использовать никнейм пользователя в Telegram.

Для инициализации диалога в карточке клиента и в заказе есть следующая кнопка, функционал у них одинаковый.

В мессенджере Telegram не любят спам.
Часто при попытке написать клиенту из RetailCRM возникают ошибки. Возможные причины такого поведения:

1. у этого номера нет аккаунта Telegram;
2. у пользователя есть настройки конфиденциальности, которые ограничивают получения сообщения (по типу аккаунта Premium, по наличию в списке контактов);
3. сработал механизм антиспам Telegram. Telegram видит, что вы написали новому пользователю, который не добавил вас в контакты или сообщение отправлено по триггеру (в тч новому пользователю) или превышены лимиты отправки сообщений за сутки (вы отправили массовую рассылку до этого).

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

Модуль предоставляет удобную возможность для инициации диалога с клиентом, используя его никнейм в Telegram. Данный функционал особенно полезен для связи с пользователями, которые в настройках конфиденциальности мессенджера скрыли свой номер телефона.

Для корректной работы этой функции необходимо выполнить предварительную настройку пользовательских полей:

1. Создание полей: Вы можете создать пользовательские поля в RetailCRM, предназначенные для хранения Telegram-никнеймов. Такие поля доступны для создания как на уровне карточки клиента, так и на уровне заказа.
2. Сопоставление: После того, как поля будут созданы в RetailCRM, их потребуется сопоставить в настройках нашего модуля. Это позволит системе корректно идентифицировать никнеймы и автоматически подтягивать их в шаблон для инициации диалога.

После этого необходимо настроить "Параметры выгрузки".

Режим выгрузки

• Инкрементально — выгружаются только новые сообщения, использовать для регулярной работы
• Полностью — выгружается вся история чатов, использовать для первичной загрузки

Тестовый прогон

• Включается переключателем
• Сообщения не отправляются в CRM

Данную опцию можно использовать для проверки настроек перед реальной выгрузкой.

Ограничения выгрузки

Кол-во чатов
Сколько чатов выгружать, счет идет от новых к старым, устанавливая это значения вы определяете глубину выгрузки

• 0 — без ограничений

Сообщений на чат
Ограничение количества сообщений из одного чата

• 0 — выгрузить все

Не старше
Фильтр по дате

• будут выгружены только сообщения не старше выбранной даты

Фильтрация чатов

Включить только chat_id
Выгружать только указанные чаты
Пример: 8068870049

Исключить chat_id
Исключить определённые чаты из выгрузки
Пример: 1234567890

Чат ID можно увидеть в веб версии Телеграм в URL

Работа с медиа

Медиа
Включает/отключает выгрузку:

• фото
• видео
• файлов

Лимит файла
Максимальный размер выгружаемого файла:

• например: 50 MB

файлы больше лимита будут пропущены и не загрузятся в CRM

Запуск выгрузки

После настройки:

1. Убедитесь, что:

• сессия авторизована

2. Нажмите «Запустить выгрузку»

Перед началом выгрузки необходимо авторизовать Telegram-аккаунт:

1. Нажмите кнопку «Авторизовать»
2. Откроется QR-код
3. Отсканируйте его через Telegram:

• Настройки → Устройства → Подключить устройство

4.После успешной авторизации:

• статус изменится на «active»

Без этого шага выгрузка невозможна

Одни из самых популярных причин, по которым аккаунт Telegram могут заблокировать, это:

• Спам;
• Массовые рассылки;
• Несколько пользователей, не являющиеся вашими контактами и которым вы писали, заблокировали вас.

Если ваш аккаунт заблокировали, существует несколько способов разблокировки:
при помощи Spam Info Bot и через службу поддержки Telegram.

Разблокировка при помощи Spam Info Bot
Откройте Spam Info Bot и нажмите на вариант "Это ошибка" в меню бота. Далее выберите "Нет, ничего подобного не было". Опишите суть проблемы и сообщите, что аккаунт попал в черный список по ошибке. Модератор рассмотрит ваше обращение и примет решение по поводу блокировки.
Не нажимайте в меню бота кнопку «Признаю вину, снимите ограничения». В таком случае модератор не будет изучать проблему блокировки.

Разблокировка при помощи службы поддержки Telegram
На почту spam@telegram.org направьте обращение, в котором опишите суть проблемы, приложив доказательства того, что нарушений с вашей стороны не поступало. Заявка будет рассматриваться модератором 1–3 дня.
Пользователям, столкнувшиеся впервые с ограничениями, Telegram может предложить снять блокировку при помощи оформления Premium-аккаунта.