Telegram в Odoo Discuss: как мы соединили мессенджер и CRM в один канал

Многие команды поддержки в русскоязычном бизнесе работают с клиентами через Telegram. И часто — параллельно с CRM или ERP, в которой ведутся заказы, тикеты и контакты. Оператор пишет клиенту в одном окне, а ищет историю заказа в другом. Сообщения теряются, контекст переключается, новый сотрудник тратит дни, чтобы разобраться, кто и о чём писал.

Мы столкнулись с этой проблемой в собственных проектах на Odoo 18 и сделали модуль telegram_integration, который превращает Telegram-бот в обычный канал внутри Odoo Discuss. В этой статье — как он устроен, что именно он делает и в каких сценариях имеет смысл его ставить.

Зачем переносить Telegram внутрь Odoo

Стандартная схема в небольшой компании выглядит так: у компании есть Telegram-бот для общения с клиентами, отдельное приложение Telegram на телефонах операторов и CRM (в нашем случае — Odoo) для заказов, инвойсов и контактов. Когда клиент пишет в бот, оператор отвечает с телефона, а информацию о заказе ищет в браузере на компьютере.

Это работает до тех пор, пока в команде один-два оператора. Дальше начинают всплывать рутинные проблемы:

• Кто-то ответил клиенту в Telegram, но не записал, о чём договорились — следующий оператор не знает контекста.
• Файл, который клиент прислал в Telegram (PDF договора, скрин ошибки), остаётся в Telegram. В Odoo на карточке клиента его нет.
• При увольнении сотрудника история переписки теряется вместе с его аккаунтом или с правом доступа к боту.
• Невозможно собрать статистику: сколько клиентов написало за неделю, как быстро им отвечали, какие темы повторяются.

Перенос Telegram внутрь Odoo Discuss закрывает эти проблемы не за счёт «новой технологии», а за счёт устранения двух параллельных интерфейсов. Сообщение приходит туда же, где менеджер уже работает с заказом.

Что делает модуль telegram_integration

Модуль расширяет встроенный Odoo Discuss и добавляет в него Telegram как ещё один источник сообщений — наряду со встроенными каналами, e-mail и (опционально) WhatsApp Business API.

Базовые функции:

• Двусторонние сообщения в реальном времени. Клиент пишет в Telegram-бот — сообщение появляется в Odoo Discuss мгновенно через webhook. Оператор отвечает из Odoo — сообщение уходит клиенту в Telegram.
• Автоматическое создание канала на каждого клиента. Когда новый человек впервые пишет боту, модуль создаёт отдельный канал в Discuss и, если по telegram_id или телефону находится контакт res.partner — связывает их. Никаких ручных операций.
• Файлы и изображения. Клиент прислал PDF, фото, скан — они отображаются в Odoo как вложения в сообщении. Оператор может скачать их, переслать или прикрепить к заказу/тикету.
• Назначение оператора. Каждому Telegram-каналу можно назначить ответственного. Уведомления приходят внутри Odoo по обычной схеме Discuss.
• Webhook настраивается без серверной консоли. Бот создаётся через @BotFather в самом Telegram, токен вставляется в форму внутри Odoo, URL webhook генерируется автоматически.

Архитектурно модуль создаёт одну новую модель telegram.account (конфигурация бота — токен, webhook, статус) и расширяет стандартную discuss.channel. Никаких прокси-серверов, внешних сервисов или отдельной базы данных — всё работает поверх существующего Odoo.

Что вы получаете на практике

Сценарий, ради которого мы писали модуль, выглядит примерно так:

Клиент пишет в бот: «Привет, у меня вопрос по заказу 1234». Сообщение моментально появляется в Odoo Discuss в канале с именем клиента — потому что по telegram_id модуль нашёл его контакт. Оператор открывает Discuss, видит сообщение, в том же окне поднимает карточку клиента, проверяет заказ 1234 и отвечает: «Здравствуйте, заказ отгружен сегодня в 14:00, трек 5678». Сообщение уходит клиенту в Telegram.

Через неделю клиент возвращается с новым вопросом — другой оператор открывает тот же канал и видит всю историю переписки прямо в Odoo. История привязана к контакту, попадает в общие отчёты Discuss, видна владельцу аккаунта.

Если клиент прислал PDF — он скачивается из Odoo и прикрепляется к заказу или тикету одним кликом.

Технические детали

Лимит размера файлов задаётся самим Telegram Bot API — до 50 МБ через бот-канал. Этого хватает для документов, фото и скриншотов в большинстве сценариев поддержки.

Установка за 10–15 минут

Если у вас уже работает Odoo 18, установка выглядит так:

1. Установить модуль. Apps → найти Telegram Integration → Install. Зависимостей кроме базового mail нет. 2. Создать бот в Telegram. Открыть @BotFather в самом Telegram, выполнить /newbot, получить токен. 3. Прописать бот в Odoo. Discuss → Configuration → Telegram Accounts → New. Вставить токен, сохранить — Odoo сгенерирует URL webhook. 4. Зарегистрировать webhook. Зайти на полученный URL или нажать кнопку «Register webhook» из формы Odoo — это говорит Telegram, куда слать входящие сообщения. 5. Проверить. Написать своему же боту сообщение из личного Telegram — оно должно появиться в Discuss как новый канал.

Никаких внешних серверов, очередей сообщений, веб-хуков, развернутых вручную, не требуется — Odoo сам слушает входящие через webhook на свой же домен. Это работает в любой стандартной установке Odoo 18, включая Odoo.sh.

Что это значит для бизнеса

Если у вас в день 10–20 диалогов в Telegram — модуль экономит часы оператора в месяц и избавляет от потерь контекста. Если 100+ диалогов — это не просто удобство, а инфраструктурная необходимость: без центрального журнала переписки команда быстро упирается в путаницу.

Главная польза не в самом «соединении мессенджера и CRM», а в том, что весь клиентский разговор хранится рядом с заказом, инвойсом и тикетом. История не зависит от телефона конкретного сотрудника. Новый оператор открывает Discuss и видит контекст за секунды.

Часто задаваемые вопросы

Работает ли модуль в multi-company? Да. Можно создать отдельный telegram.account для каждой компании. Каждый аккаунт привязан к своей компании, и автоматически созданные каналы соблюдают эту привязку. Стандартные правила доступа Odoo между компаниями работают штатно.

Нужны ли дополнительные модули? Только базовый mail, который входит в любую стандартную установку Odoo 18. Никаких сторонних модулей или внешних сервисов, кроме создания бота через @BotFather, не требуется.

Можно ли настроить автоответы в нерабочее время? Сам telegram_integration шаблонов автоответа не содержит. Для расписания автоответов мы используем отдельный модуль auto_reply_schedule — он опционально поддерживает Telegram через зависимость на telegram_integration.

Какие ограничения по файлам? До 50 МБ — лимит самого Telegram Bot API. Для бóльших файлов Telegram требует User API вместо Bot API, и это уже за рамками модуля. На практике 50 МБ покрывают подавляющее большинство сценариев — документы, изображения, чеки.

Можно ли назначать операторов на каналы? Да. Логика назначения — стандартная для Odoo Discuss: каждому каналу можно дать одного или нескольких ответственных, они получают уведомления внутри Odoo. Это позволяет распределить нагрузку и сделать ответственность за разговор явной.

Где взять модуль

Модуль опубликован на Odoo Apps Store за €49 под лицензией LGPL-3. Это open source — код можно изучить, доработать под себя или предложить улучшения. Поддерживается только Odoo 18.

Если ваша команда уже работает в Odoo и сейчас параллельно тратит время на Telegram в отдельном окне — установка этого модуля закрывает разрыв за один рабочий день.

Если нужно больше, чем готовый модуль

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

Запишитесь на консультацию — мы делаем кастомные интеграции Odoo с мессенджерами и AI-агентами для поддержки. Посмотреть, как мы работаем над такими задачами, можно на странице нашей методологии.