Настройка Telegram Notify для работы в CRM Битрикс24

Войти в панель управления rukovoditel.net

2023-08-13T18:17:19+03:00

Для входа необходимо знать: * URL панели управления * Логин * Пароль

Права пользователей

2023-08-13T19:04:26+03:00

Коротко об иерархии уровней пользователей: * Менеджер - может управлять только проектами, на которые он назначен. * Модератор - управляет всеми проектами, может управлять пользователями. * Администратор - царь и бог, имеет всё, что доступно, включая системные настройки и отчёты. На скриншоте панель с правами модератора.

Проекты

2023-08-14T00:27:51+03:00

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

Создание проекта

2023-08-14T20:40:34+03:00

Для создания нового проекта нужно нажать синюю кнопку "Добавить", расположенную в верхнем левом углу светлой области панели управления. В появившемся окне требуется: 1. Задать название проекту. 2. Статус оставить включенным. 3. Назначить менеджера на проект, если требуется.

Открыть проект

2023-08-14T22:17:50+03:00

Перейти в только что созданный проект, нажав на его название-ссылку в списке проектов.

Добавление бота

2023-08-14T22:38:18+03:00

В блоке "Боты" нужно нажать синюю кнопку "Добавить", тогда появится окно с формой добавления бота. 1. Выбрать боту имя: всё равно какое, но лучше, если оно совпадает с оригинальным именем вашего телеграмного бота, тогда не будет путаницы. 2. Статус оставить "Вкл". 3. Вставить токен бота, который можно получить у крёстного отца всех ботов - @BotFather, с помощью которого и создавался бот. Пример токена: `0000075398:AAHoJx-JikmHGfxOlPjy-rELHYhoawq8Es4` Вопрос создания ботов в Телеге в рамках данной инструкции не рассматривается.

Добавление чата

2023-08-14T23:21:21+03:00

Под "Чатом" подразумевается любая фигня в Телеге, куда можно что-нибудь запостить, т.е.: * Канал * Группа * Пользователь В проекте может быть любое количество этих сущностей в нужной пропорции, но наиболее практичным будет использовать один канал или группу, куда подключить нужных пользователей. В примере будет использоваться канал. Нажатием кнопки "Добавить" в блоке "Чаты" вызываем окно с формой: 1. **Название** - лучше использовать такое же как у добавляемого канала/группы/пользователя. 2. **Статус** - Вкл. 3. **Чат ID** - вставить сюда **только цифры** после последнего слеша в URL канала/группы/пользователя. Доступно в [веб-версии Telegram](https://web.telegram.org/) Пример URL для канала: `https://web.telegram.org/k/#-0000028766` Примечание: * При добавлении группы, бот должен быть добавлен в группу, а у самого бота должно быть включено разрешение на участие в группах. * При добавлении канала, бот должен быть добавлен в канал в качестве администратора, у которого есть разрешение на публикацию сообщений. У самого бота требуется отключить настройку конфиденциальности.

Добавление сценария

2023-08-15T00:49:40+03:00

Нажать кнопку "Добавить" в блоке "Сценарии" и заполнить форму: 1. **Название** - любое понятное. В примере это будет "Универсальная форма связи", т.к. сценарий будет отправлять из Битрикс24 уведомление о заполнении таких CRM-форм, размещенных на нескольких разных сайтах. 2. **Статус** - Вкл. 3. **Бот** - выбрать бота, добавленного на предыдущих шагах. 4. **Чаты** - выбрать один или несколько чатов, добавленных ранее, в которые должно поступить сообщение. 5. **Шаблон сообщения** - вставить сюда шаблон сообщения, которое будет отправлено в Телеграм. Пример шаблона сообщения для универсальной формы связи: ``` {% if var.domain is defined and var.domain is not empty %} Заполнена форма связи на сайте: {{ var.domain }} {% endif %} {% if var.title is defined and var.title is not empty %} Название лида: {{ var.title }} {% endif %} {% if var.date_created is defined and var.date_created is not empty %} Дата создания: {{ var.date_created }} {% endif %} {% if var.lead_id is defined and var.lead_id is not empty %} URL лида: https://united.bitrix24.ru/crm/lead/details/{{ var.lead_id }}/ {% endif %} {% if var.name is defined and var.name is not empty %} Имя или название организации: {{ var.name }} {% endif %} {% if var.phone is defined and var.phone is not empty %} Телефон: {{ var.phone }} {% endif %} {% if var.email is defined and var.email is not empty %} E-mail: {{ var.email }} {% endif %} {% if var.comment is defined and var.comment is not empty %} Комментарий: {{ var.comment }} {% endif %} -------------------------------------------------- Дополнительно: {% if var.url is defined and var.url is not empty %} URL заполнения: {{ var.url }} {% endif %} {% if var.page is defined and var.page is not empty %} Заголовок страницы: {{ var.page }} {% endif %} {% if var.btn_name is defined and var.btn_name is not empty %} Имя кнопки: {{ var.btn_name }} {% endif %} {% if var.btn_id is defined and var.btn_id is not empty %} ID кнопки: {{ var.btn_id }} {% endif %} ```