Интеграция EspoCRM с Telegram: чат-бот для приёма заявок и уведомлений

Компания по установке систем безопасности в Казани, 11 менеджеров. Клиенты писали в Telegram напрямую: кто в личный аккаунт менеджера, кто через групповой чат, кто через бота на сайте. Результат: около 20-25% входящих запросов терялись или обрабатывались с задержкой 3-5 дней. История переписки жила в Telegram, а не в CRM, и при смене менеджера передать клиента нормально было невозможно.

После настройки интеграции каждое сообщение в корпоративный Telegram-бот автоматически создаёт сделку в EspoCRM. Менеджер получает уведомление, видит данные клиента в CRM, пишет ответ прямо из карточки сделки, и клиент получает ответ обратно в Telegram. Потеря заявок упала до 2%.

Зачем связывать EspoCRM и Telegram

Telegram стал основным мессенджером для деловых коммуникаций в России. По данным 2025 года, более 60% B2B-компаний принимают хотя бы часть заявок через мессенджеры. При этом большинство CRM-систем не имеют встроенной поддержки Telegram.

Типичная проблема без интеграции: клиент написал в Telegram, менеджер ответил, разговор завис в личке. Сделка в CRM не создана. Через неделю менеджер заболел, данные клиента потеряны. CRM-система показывает, что источника «Telegram» не существует, хотя реально через него приходит 30-40% запросов.

Интеграция решает три задачи: фиксирует каждый входящий контакт как сделку, сохраняет историю переписки в карточке клиента, позволяет менеджеру отвечать из CRM без переключения на мессенджер.

Два сценария интеграции

Перед выбором архитектуры нужно понять, что именно нужно бизнесу.

Сценарий 1: уведомления из EspoCRM в Telegram. Односторонняя интеграция. EspoCRM отправляет сообщения в Telegram при наступлении событий: создана новая сделка, сменился статус, просрочена задача, клиент долго без ответа. Реализуется через webhook и не требует разработки бота. Подходит для компаний, где клиенты не пишут в Telegram, но менеджеры хотят получать оперативные оповещения.

Сценарий 2: приём заявок через Telegram-бота. Двусторонняя интеграция. Клиент пишет в корпоративного Telegram-бота, система создаёт контакт и сделку в EspoCRM, менеджер отвечает. История переписки хранится в CRM. Требует разработки бота или готового интеграционного решения. Подходит для компаний, активно работающих с Telegram как основным каналом.

Оба сценария можно комбинировать: принимать заявки через бота и одновременно получать уведомления в рабочий чат команды.

Уведомления из EspoCRM в Telegram

Простейший способ начать: настроить отправку webhook-уведомлений из EspoCRM в Telegram-чат.

Что нужно: Telegram-бот (создаётся за 2 минуты через BotFather), Chat ID чата или канала, настроенный Workflow в EspoCRM.

Как работает. EspoCRM поддерживает исходящие webhook-уведомления через раздел «Управление», пункт «Webhooks». При наступлении события (создание записи, смена поля, наступление даты) EspoCRM отправляет HTTP-запрос на указанный URL. Этот URL может быть ботом в Telegram или промежуточным сервисом.

Практический пример: уведомление о новой сделке. Создаётся Workflow с триггером «Сделка создана», действием «Отправить webhook». Webhook принимает запрос и отправляет сообщение в Telegram-чат команды: «Новая заявка: [Имя клиента], [Телефон], источник [Откуда пришёл]». Менеджеры видят все новые заявки в рабочем Telegram-чате и сразу могут реагировать.

Уведомления о просроченных задачах. Workflow с триггером «Дата выполнения задачи наступила, статус не закрыт» отправляет уведомление ответственному менеджеру. Это заменяет ручные напоминания и снижает число просроченных дел.

Уведомления о смене статуса сделки. При переходе сделки на стадию «Требует одобрения» или «Ждёт оплаты» руководитель получает уведомление в персональный Telegram-чат с ботом. Это ускоряет решения без необходимости открывать CRM.

Приём заявок через Telegram-бота

Более сложная, но и более ценная интеграция: клиент пишет боту, запрос появляется в EspoCRM как сделка.

Как выглядит цепочка. Клиент открывает бота, пишет сообщение. Бот получает его через Telegram Bot API. Промежуточный сервис обрабатывает сообщение: ищет контакт в EspoCRM по номеру телефона или Telegram Chat ID, создаёт новый контакт если не найден, создаёт сделку с текстом сообщения. Менеджер в EspoCRM видит новую сделку с пометкой «Источник: Telegram» и всей информацией о клиенте.

Что создаётся в EspoCRM при входящем сообщении:

• Контакт с именем пользователя Telegram и Chat ID (уникальный идентификатор для отправки ответов)
• Сделка с описанием «Первое сообщение: [текст клиента]»
• Тег или поле «Источник: Telegram»
• Задача ответственному менеджеру

Обработка повторных обращений. Если клиент пишет боту повторно, система ищет контакт по Chat ID. Найден существующий контакт: новое сообщение добавляется как активность к его карточке или открывает новую сделку (в зависимости от настройки). Менеджер видит полную историю общения.

Двустороннее общение: ответ из EspoCRM в Telegram

После настройки двусторонней интеграции менеджер работает только в EspoCRM: клиент пишет в Telegram, менеджер отвечает из CRM, клиент получает ответ обратно в Telegram.

Как реализуется. В карточке контакта добавляется кастомное поле «Telegram Chat ID». При ответе менеджера из EspoCRM промежуточный сервис берёт этот Chat ID и отправляет сообщение через Telegram Bot API. С точки зрения клиента: он написал боту, бот ему ответил.

История переписки. Все входящие и исходящие сообщения через Telegram фиксируются в Stream карточки сделки или контакта. При смене менеджера новый сотрудник видит полную историю общения с клиентом, включая переписку в Telegram. Это устраняет основную боль при передаче клиентской базы.

Мультимедиа. Если клиент отправил фото или документ через Telegram, файл может быть сохранён как вложение к карточке сделки в EspoCRM. Реализация зависит от конкретного промежуточного решения.

Техническая реализация: что нужно

Telegram-бот. Создаётся через BotFather (официальный бот Telegram): /newbot, выбрать имя, получить токен. Бот является публичным и клиенты могут найти его по имени или ссылке.

Промежуточный сервис. Самостоятельная разработка (Python + Flask или Node.js, 2-5 дней работы разработчика) или готовое решение (n8n, Make, Albato с коннекторами для Telegram и EspoCRM). Готовые no-code решения подходят для простых сценариев (уведомления, создание контактов). Для двусторонней переписки с сохранением истории нужна кастомная разработка.

EspoCRM API. EspoCRM предоставляет REST API для создания и обновления записей. Промежуточный сервис использует API с токеном авторизации для создания контактов и сделок. Документация API доступна в разделе «Управление», пункт «API» вашей инсталляции EspoCRM.

Хостинг для промежуточного сервиса. Необходим публично доступный URL для принятия webhook от Telegram. Это может быть тот же VPS, где работает EspoCRM, или отдельный сервис. Telegram требует HTTPS для webhook-адресов.

Ориентировочная стоимость разработки:

• Уведомления из EspoCRM в Telegram (односторонние): 15 000-25 000 руб., 1-2 дня разработки
• Приём заявок через бота (создание сделок в EspoCRM): 35 000-60 000 руб., 3-5 дней
• Полноценный двусторонний чат с историей переписки: 70 000-120 000 руб., 7-12 дней

Настройка уведомлений для разных групп сотрудников

Гибкость Telegram-интеграции позволяет настроить уведомления по ролям: каждая группа сотрудников получает только те оповещения, которые нужны именно ей.

Менеджеры по продажам. Уведомление при назначении на сделку, при получении нового сообщения от клиента через бота, при переносе задачи коллегой. Эти уведомления идут в личный диалог менеджера с корпоративным ботом.

Руководитель отдела. Уведомления о просроченных задачах подчинённых, о сделках в статусе «Зависла» дольше N дней, о крупных сделках, перешедших на финальную стадию. Руководитель видит только исключения, не весь поток.

Команда (групповой чат). Новые входящие заявки, сменившиеся статусы ключевых сделок, напоминания о дедлайнах проекта. Групповой чат используется как общая лента событий, где каждый видит общую картину.

Техническая реализация. В EspoCRM каждый Workflow может указывать разные webhook-адреса или Chat ID для разных событий. Настройка занимает 1-2 дня при наличии базовой интеграции.

Готовые no-code решения для базовой интеграции

Если бюджет на разработку ограничен или нужно быстро проверить гипотезу, можно использовать платформы автоматизации.

n8n. Открытая платформа автоматизации с возможностью self-hosted развёртывания. Имеет встроенный узел для Telegram Bot API и HTTP-узел для обращения к EspoCRM API. Сценарий «входящее сообщение Telegram -> создать контакт в EspoCRM» настраивается за 2-3 часа без написания кода. Минус: ограниченные возможности для двусторонней переписки.

Make (Integromat). Облачная платформа с визуальным редактором сценариев. Имеет коннектор для Telegram и поддержку HTTP-запросов для EspoCRM. Подходит для уведомлений и создания записей. Стоимость: от 9 USD в месяц, зависит от числа операций.

Albato. Российская платформа автоматизации. Имеет готовый коннектор Telegram и поддержку webhook для EspoCRM. Данные хранятся на российских серверах, что важно для компаний с требованиями 152-ФЗ. Стоимость: от 990 рублей в месяц.

Когда no-code не подходит. Готовые платформы не обеспечивают двустороннюю переписку с сохранением истории в EspoCRM, не умеют искать существующий контакт по Telegram Chat ID с нужной логикой, не позволяют кастомизировать поведение бота под специфику бизнеса. Для продвинутых сценариев нужна разработка.

Что EspoCRM не делает из коробки

Community Edition EspoCRM не включает встроенный Telegram-модуль. В официальном Extension Store есть платные расширения, но их функционал ограничен. Для реального двустороннего общения через Telegram нужна разработка интеграционного слоя.

Это не недостаток платформы: EspoCRM изначально строился как открытая система с API, которую разработчик может интегрировать с любым каналом. Telegram, WhatsApp, ВКонтакте, корпоративные мессенджеры подключаются по одному принципу.

Альтернатива кастомной разработке: использовать n8n или Make (Integromat) для автоматизации. Эти платформы имеют коннекторы и для Telegram Bot API, и для EspoCRM (через HTTP-запросы к API). Это быстрее и дешевле, чем разработка с нуля, но даёт меньше гибкости.

Типичные ошибки при интеграции Telegram и EspoCRM

Один бот на весь бизнес без разделения направлений. Если компания продаёт несколько разных продуктов или работает в нескольких регионах, один бот создаёт путаницу: заявки на «Монтаж кондиционеров» и «Обслуживание котельных» падают в одну очередь к разным менеджерам. Правильно: отдельный бот или отдельное стартовое меню с выбором направления. При создании сделки в EspoCRM передаётся тег или поле «Направление» для маршрутизации.

Не настроена квалификация через переменные. Менеджер получает сделку с единственной информацией «Привет, хочу узнать цены». Без квалифицирующих вопросов в боте менеджер тратит 5-7 минут на выяснение базового контекста. Добавьте в бот 2-3 вопроса перед созданием сделки: масштаб задачи, срок, контактные данные. Это не отпугивает клиентов (при грамотном тексте), но даёт менеджеру контекст сразу.

Уведомления приходят в нерабочее время без фильтра. Workflow без расписания отправляет уведомления о новых заявках в 23:00 и в выходные. Менеджеры начинают игнорировать уведомления. Решение: добавить условие в Workflow «время создания записи с 9:00 до 19:00 рабочих дней» или настроить суммарный дайджест за ночь.

Нет тестирования при смене версии EspoCRM. При обновлении EspoCRM меняется структура API или URL endpoint. Если интеграция не покрыта тестами, обновление ломает её без предупреждения. Перед обновлением EspoCRM всегда проверяйте работу интеграции на тестовой среде.

Кейс: юридическая компания, Новосибирск

Юридическая фирма, 8 юристов, специализация на арбитражных делах и банкротстве. Основной канал привлечения клиентов: контекстная реклама, лендинг с кнопкой «Написать в Telegram». Клиент нажимает кнопку и попадает в корпоративного бота.

До интеграции: менеджер по продажам вручную переносил данные из Telegram в CRM. Около 15% запросов терялись или дублировались.

Что настроили: входящее сообщение от нового пользователя автоматически создаёт контакт в EspoCRM с тегом «Источник: Telegram». Параллельно создаётся задача «Обработать заявку» с дедлайном 2 часа. Если задача не закрыта за 2 часа, в Telegram руководителя уходит уведомление.

Ответ клиенту менеджер пишет в EspoCRM: текст уходит через бота обратно клиенту в Telegram. Клиент видит ответ от «официального бота», а не от личного аккаунта менеджера, что добавляет ощущение структурированности компании.

Результат через 3 месяца: конверсия из заявки в консультацию выросла с 34% до 51%. Время первого ответа сократилось с 4,2 часа до 47 минут. Ни одна заявка не была потеряна за 90 дней после запуска.

Стоимость разработки интеграции: 68 000 рублей. Время разработки: 9 рабочих дней.

Вопросы, которые задают при интеграции

Можно ли принимать заявки сразу из нескольких Telegram-ботов?

Да. EspoCRM через API позволяет создавать записи из любого источника. Если у компании несколько ботов (для разных направлений бизнеса или регионов), каждый бот при создании сделки передаёт свой идентификатор, и в EspoCRM записи разделяются по тегу или полю «Направление».

Как работает бот, если клиент уже есть в базе EspoCRM?

Промежуточный сервис при каждом новом сообщении ищет контакт по Telegram Chat ID. Если контакт найден, новое сообщение добавляется к существующей карточке клиента. Дублей не создаётся. Это ключевое требование при разработке интеграции.

Можно ли настроить авто-ответы в боте (первичную квалификацию)?

Да. Бот может задавать клиенту уточняющие вопросы до создания сделки: «Опишите вашу задачу», «Сколько сотрудников в компании», «В каком городе находитесь». Ответы клиента передаются в EspoCRM как поля сделки. Менеджер получает уже частично заполненную карточку. Это снижает время обработки заявки на 15-25%.

Нужно ли уведомлять клиента о том, что переписка сохраняется в CRM?

С точки зрения 152-ФЗ: если в переписке есть персональные данные (а они есть практически всегда), вы обязаны иметь согласие клиента на обработку. Стандартная практика: в первом сообщении бот уведомляет клиента о политике обработки данных и запрашивает согласие кнопкой «Продолжить / Принять».

Работает ли интеграция с групповыми чатами Telegram?

Технически бот может работать в групповых чатах, но для CRM-интеграции это нецелесообразно. В группе несколько людей пишут одновременно, атрибуция сообщений к конкретной сделке становится сложной. Оптимальная схема: личный диалог клиента с корпоративным ботом, не группа.

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

Получить консультацию: разберём, какой сценарий интеграции подойдёт вашему бизнесу и рассчитаем стоимость разработки.