Техническое задание: Интеграция Telegram-уведомлений для Битрикс24

Цель проекта

Настроить автоматическую отправку структурированных уведомлений в Telegram-чат при изменении статуса/стадии сделки в CRM Битрикс24.

Основные требования

Область действия

• Отслеживать изменения сделок только в воронке "Продажи"
• Настроить обработку для 8 статусов/стадий
• Для каждого статуса должно быть задано свое название и процент выполнения

Формат уведомления

Сообщение в Telegram должно содержать 6 строк со следующим содержимым:

• Строка 1: Заголовок сделки
• Строка 2: Дата изменения статуса в формате "4 декабря"
• Строка 3: Название примененного статуса и следующий статус по порядку (пример: "Завершил утепление. Приступил к обрешетке")
• Строка 4: Данные из специального поля сделки (например, "Прораб Максим")
• Строка 5: Локация из соответствующего поля сделки (формат: "Локация: Казань")
• Строка 6: Визуализация процента выполнения с помощью emoji (пример: ⬛⬛⬛⬜⬜ 60%)

Технические требования

• Реализовать механизм отслеживания изменений сделок в Битрикс24
• Настроить подключение к Telegram API для отправки сообщений
• Реализовать парсинг данных из указанных полей сделки
• Создать конфигурацию для сопоставления статусов с названиями и процентами
• Обеспечить корректное форматирование даты
• Реализовать преобразование процента в последовательность emoji

Пример желаемого результата

⦁ Сделка #754
⦁ 4 декабря
⦁ Завершил утепление. Приступил к обрешетке
⦁ Прораб Максим
⦁ Локация: Казань
⦁ ⬛⬛⬛⬜⬜ 60%