Установка
Для корректной работы всех функций модуля необходимо иметь актуальный SSL сертификат для вашего домена (в том числе бесплатный Let's Encrypt). Работа модуля возможна только по HTTPS протоколу.Установка модуля стандартная. После установки перейдите на страницу настроек модуля. Заполните обязательные данные:
- Домен сайта (без протокола)
- API токен телеграм
Получение API токенаДля получения уведомлений со своего сайта в телеграм нужно получить доступ к API токен телеграм-бота.
Запустите через телеграм бот @BotFather и начните беседу.
Отправьте команду /newbot и следуйте инструкциям.
Вам нужно будет ввести название своего бота и придумать его логин.
После этого вы получите API токен. Скопируйте токен и вставьте в настройках нашего модуля.
В итоге вы создадите свой бот, который будет доступен для ваших клиентов.
По желанию вы можете добавить описание бота и прикрепить аватарку. |
Остальные параметры заполняйте в соответствии с подсказками на странице модуля.
Создание веб-хукаПосле заполнения токена и сохранения настроек на первой вкладке с настройками модуля в самом низу будет кнопка "Создать веб-хук". Нажмите для связи модуля сайта с телеграм-ботом, который вы создали.
Создание меню и панели команд ботаВы также можете создать меню с основными командами модуля, для этого нажмите на кнопку "Создать меню". Вы можете изменить состав меню на вкладке "Конструктор меню". В этом случае после изменения структуры необходимо пересоздать меню.
На вкладке "Настройка команд" вы можете изменить состав команд, которые выводятся при запуске стартовой команды /start при нахождении пользователя в базе сайта.
Как выполняется идентификация пользователя сайта в телеграм-боте?1) После того как пользователь запустит бот командой /start модуль начнет искать телеграм логин среди пользователей сайта в поле UF_TELEGRAM_ACC. Все обязательные пользовательские поля создаются при первом сохранении настроек модуля.
Вы можете на своем сайте создать свойство заказа, через которое при оформлении заказов на сайте клиенты будут указывать свои телеграм-логины (без @). Дальше вы можете написать обработчик и реализовать сохранение аккаунта клиента в поле UF_TELEGRAM_ACC из свойства заказа. В данный момент в модуле не реализован такой функционал.
Таким образом, клиенту достаточно запустить телеграм-бот и модуль автоматически выполнит идентификацию клиента по его логину.
Это не обязательный вариант идентификации клиентов в боте.2) Пользователь может ввести свой номер телефона и модуль автоматически будет искать заказы с указанным номером телефона, после совпадения идентификация выполнена.
В настройках модуля указывается паттерн, по умолчанию:
| /^(\+7|8)?\s?\(?\d{3}\)?\s?\d{3}[\s-]?\d{2}[\s-]?\d{2}$|^\d{3}[\s-]?\d{3}[\s-]?\d{2}[\s-]?\d{2}$/ |
Также указывается маска, по умолчанию:
Паттерн в примере допускает номера в следующих форматах:
? +7 999 123-45-67
? +7 (999) 123-45-67
? +79991234567
? 8 999 123 45 67
? 8(999)123-45-67
? 89991234567
? 9991234567
? 999 123 45 67
Клиент может указать свой номер телефона в телеграм-боте в любом из допустимых форматов для поиска аккаунта на сайте.
Модуль преобразует номер по маске, указанной выше, и найдет пользователя по номеру телефона.
Соответственно, в заказах на сайте номер-телефона должен сохраняться строго по указанной маске.
| Если в настройках свойства заказа с номером телефона стоит галочка "является телефоном" и у вас на сайте нет никаких других кастомных обработчиков, то укажите маску 7XXXXXXXXXX (стандартная функция преобразования номера телефона) |
3) Пользователь может указать свой email и модуль найдет пользователя на сайте и выполнит автоматическую идентификацию.