Настройка канала Telegram (персональный аккаунт)¶

Подключите персональный аккаунт Telegram к Онлайн-чату, чтобы иметь возможность написать клиенту первым. Чтобы подключить персональный аккаунт, нужно:

• Создать аккаунт в Telegram
• Подключить аккаунт в вашем проекте

Шаг 1. Создание аккаунта Telegram¶

1. Купите номер.
2. Зарегистрируйте номер, зайдя с него в Telegram на любом устройстве.
3. Установите имя аккаунта.

Шаг 2. Подключение аккаунта к Roistat¶

1. Перейдите на страницу Онлайн-чат → Настройки и в блоке Telegram (персональный аккаунт) нажмите Подключить канал Telegram.

   

2. Введите Название канала, Номер телефона и нажмите Продолжить.

   

   После этого на указанный номер отправится сообщение с кодом подтверждения. Сообщение должно появиться в Telegram-канале.

3. Введите полученный код в поле Код подтверждения и нажмите Сохранить.

   

   • Если код не пришел — нажмите Запросить код еще раз.

   • Если в указанном аккаунте включена двухфакторная аутентификация, необходимо будет ввести пароль от аккаунта Telegram.

Готово. Если всё настроено правильно, на странице Онлайн-чат → Настройки в блоке Telegram (персональный аккаунт) появится подключенный канал.

Шаг 3. Разметка ссылок¶

С помощью дополнительного скрипта вы можете автоматически подставлять номер визита (roistat_visit) в Telegram-ссылки на вашем сайте. Это позволяет связать пользователя с конкретным визитом и использовать эту информацию в CRM, аналитике или внутри Telegram-бота.

Пример работы¶

На странице размещается ссылка на Telegram:

https://t.me/your_telegram

После загрузки страницы, скрипт подставит шаблон сообщения в ссылку. При переходе по ссылке, пользователю подставится текст шаблона в первое сообщение.

https://t.me/your_telegram?text=Обязательно отправьте это сообщение и дождитесь ответа. Ваш номер:123456

Как подключить¶

1. Добавьте контейнер с шаблоном сообщения¶

Отредактируйте шаблон на свое усмотрение, оставьте в шаблоне {roistat_visit} - вместо это подставится реальный номер визита.

<div class="js-telegram-message-container" style="display:none;">
    Обязательно отправьте это сообщение и дождитесь ответа. Ваш номер: {roistat_visit}
</div>

2. Добавьте скрипт¶

<script>
(function() {
    if (window.roistat !== undefined) {
        handler();
    } else {
        var pastCallback = typeof window.onRoistatAllModulesLoaded === "function" ? window.onRoistatAllModulesLoaded : null;
        window.onRoistatAllModulesLoaded = function () {
            if (pastCallback !== null) pastCallback();
            handler();
        };
    }

    function handler() {
        function init() {
            appendMessageToLinks();
            var delays = [1000, 5000, 15000];
            setTimeout(function func(i = 0) {
                appendMessageToLinks();
                if (delays[i + 1]) {
                    setTimeout(func, delays[i + 1], i + 1);
                }
            }, delays[0]);
        }

        function replaceQueryParam(url, param, value) {
            var [base, query = ''] = url.split('?');
            var regex = new RegExp("([?;&])" + param + "[^&;]*[;&]?");
            var queryWithoutParam = '?' + query.replace(regex, "$1").replace(/&$/, '');
            return base + (queryWithoutParam.length > 1 ? queryWithoutParam + '&' : '?') + param + '=' + value;
        }

        function appendMessageToLinks() {
            var template = document.querySelector('.js-telegram-message-container')?.textContent || '';
            var roistatVisit = window.roistatGetCookie('roistat_visit');
            if (!roistatVisit) return;

            var message = encodeURIComponent(template.replace(/{roistat_visit}/g, roistatVisit));

            var selectors = [
                '[href*="t.me"]',
                '[href*="telegram.me"]'
            ];

            document.querySelectorAll(selectors.join(', ')).forEach(link => {
                link.href = replaceQueryParam(link.href, 'text', message);
            });
        }

        if (document.readyState === 'loading') {
            document.addEventListener('DOMContentLoaded', init);
        } else {
            init();
        }
    }
})();
</script>

Дополнительные настройки¶

Настройка времени работы¶

Вы можете настроить расписание работы канала. Для этого снимите галку Круглосуточно – появятся настройки, где можно указать дни недели, а также рабочее время отдельно для будней и выходных. Если клиент напишет в Telegram в нерабочее время, он получит сообщение о том, что в данный момент операторов нет онлайн.

Настройка текстов и языка бота по умолчанию¶

1. Вы можете изменить язык канала Telegram по умолчанию.

2. Вы можете Отключить отправку системных текстов, чтобы клиентам, которые написали в Telegram, не отправлялось автоматически сообщение. Например, "Подождите, ищем оператора."

3. Если необходимо, адаптируйте стандартные тексты. Для этого нажмите Редактировать тексты канала Telegram.

   • Можете изменить стандартные тексты
   • Для каждого языка можно настроить разные тексты

   

4. Активируйте настройку Отправлять сообщение клиенту о нерабочем времени в активном чате, чтобы клиентам из активных чатов в нерабочее время автоматически отправлялось сообщение о том, что ваша служба в данный момент не работает. Тогда клиенты не будут ожидать мгновенного ответа и будут знать, что оператор обработает их запрос в ближайшее рабочее время.

   • По умолчанию будет отправляться сообщение: Мы работаем над вашим вопросом, ответим в рабочее время. Но вы можете изменить этот текст в разделе Редактировать системные тексты канала Telegram.

Написать клиенту первым¶

Если клиент есть в списке CRM, оператор может написать ему первым.

1. В приложении нажмите Написать клиенту.

2. Создайте чат. Для этого:

   • Выберите аккаунт Telegram, от имени которого хотите написать сообщение.

   • Выберите клиента, которому хотите написать.

     

   • Напишите сообщение для клиента. При необходимости можете прикрепить файл/картинку.

     • Если к сообщению ничего не прикреплено, максимальная длина сообщения – 4096 символа.
     • Если к сообщению прикреплен файл или картинка, максимальная длина сообщения – 1024 символа.

     

3. Нажмите Создать.

Готово. Теперь можете общаться с клиентом в Telegram через приложение Онлайн-чат.

Написать клиенту первым, если его нет в списке CRM¶

Может быть ситуация, когда клиенту нужно написать, но его ещё нет в CRM или интеграция с CRM в проекте отсутствует. В таком случае можно разрешить писать любым пользователям Telegram. Для этого нужно:

1. Зайдите в настройки канала Telegram (персональный аккунт)
2. Активируйте настройку Оператор может писать клиентам, которых нет в CRM и сохраните изменения
3. Откройте приложение для операторов Roistat Chat и нажмите Написать клиенту
4. В открышемся окне выберите канал, в котором активирована настройка Оператор может писать клиентам, которых нет в CRM и нажмите на кнопку Написать клиенту, которого нет в CRM
5. В поле введите номер телефона клиента в формате +71234567890 или username в формате @username
6. Напишите сообщение и нажмите на Создать

Частые вопросы¶