Модуль «Мессенджеры»: заявки из Telegram в CRM
Модуль «Мессенджеры» подключает Telegram-бота к CRM. Клиент пишет боту — система получает сообщение по вебхуку, находит или создаёт заявку, сохраняет текст в выбранное поле. Менеджер видит переписку в журнале и может ответить из раздела «Мессенджеры» в основном меню.
Сейчас поддерживается Telegram. Нужны токен бота от BotFather и публичный HTTPS-адрес CRM, на который Telegram сможет отправлять вебхуки.
Бот
Создайте бота в BotFather и скопируйте токен.
Конфигурация
Мои расширения → Мессенджеры → Настройки.
Вебхук
Путь в настройках; регистрация — в разделе «Мессенджеры».
| Элемент | Как настроить | Зачем это нужно |
|---|---|---|
| Токен бота | В настройках модуля | От BotFather |
| Группа заявок | Выпадающий список из ваших групп | Куда попадает обращение |
| Поле текста | Поле text или textarea | Текст сообщения клиента |
| Поле имени | Необязательно | Имя из Telegram |
| Поле канала | Необязательно | Например значение «Telegram» |
| Секрет вебхука | Генерируется при сохранении | Часть URL для Telegram |
- Создайте бота в Telegram и получите токен.
- В панели Конфигурация → Мои расширения откройте настройки «Мессенджеры» и заполните привязки.
- Зарегистрируйте вебхук (кнопка в разделе «Мессенджеры» или вручную в Telegram).
- Отправьте тестовое сообщение боту и проверьте заявку в CRM.
Что входит в модуль
- Журнал сообщений — входящие и исходящие, чат, ссылка на заявку.
- Автозаявка — при первом сообщении от нового чата (если включено в настройках).
- Ответ из CRM — отправка текста клиенту в Telegram.
- Виджет в меню — счётчик сообщений за сутки.
Где настраивать модуль
Все параметры модуля (токен, группы, поля, путь вебхука) задаются в установленной CRM, в панели администратора:
- Откройте раздел Конфигурация (отдельная панель, не конструктор на сайте nxr-engine.ru).
- Перейдите в Мои расширения.
- У модуля Мессенджеры нажмите Настройки.
- Укажите токен бота, группу заявок и нужные поля — списки формируются из групп и полей вашей CRM.
- Сохраните. В форме будет показан путь вебхука; полный адрес =
https://ваш-домен-crm+ этот путь.
Если вы ещё только собираете CRM в конструкторе на сайте, те же поля можно заполнить на шаге «Модули» — значения попадут в дистрибутив при установке. После развёртывания править настройки удобнее в Конфигурация → Мои расширения.
Вебхук и Telegram
После сохранения настроек откройте рабочий раздел Мессенджеры в основном меню CRM и нажмите Зарегистрировать вебхук в Telegram — система вызовет setWebhook с адресом вашей CRM. Либо укажите полный URL вручную в BotFather.
Требования
- Публичный HTTPS-адрес CRM.
- Права на кластер «Коммуникации» для ролей, работающих с заявками.