﻿---
title: "Telegram и Битрикс24: бот как канал обращений"
description: Клиент пишет Telegram-боту, диалог приходит в Битрикс24, а CRM хранит историю и ответственного.
---

**Кратко:** В этой связке Telegram — канал, через который клиент пишет боту первым, а Битрикс24 принимает сообщение и хранит диалог.

## Кратко

- **Задача:** принимать обращения из Telegram в CRM и отправлять клиентам и сотрудникам уведомления.
- **Что проверено:** получение токена у `@BotFather`, подключение бота к открытой линии, ограничение
  «один бот — один портал», поведение в группах, лимит создания ботов, отключение канала.
- **Уровень:** documented.
- **Что не проверено:** состав полей карточки клиента и поведение конкретных роботов на вашем портале.

## Когда нужна интеграция

Интеграция нужна, когда клиенты переписываются с компанией в Telegram, а сделки и заявки ведутся в
Битрикс24. Тогда переписка получает ответственного и историю, а уведомления о событиях CRM приходят в
мессенджер.

Обратные случаи:

- **Клиенты пишут в MAX или ВКонтакте** — используйте соответствующие каналы:
  [Битрикс24 и MAX](https://wpcraft.ru/integrations/bitrix24/max.md), [Битрикс24 и ВКонтакте](https://wpcraft.ru/integrations/bitrix24/vk.md).
- **Нужен только внутренний чат сотрудников** — это мессенджер Битрикс24, а не канал Telegram.
- **Нужны массовые рассылки по базе Telegram** — это отдельный сценарий с правилами платформы и
  согласиями получателей, а не обработка входящих обращений.

## Сценарии

### Сообщение боту → диалог в открытой линии

- **Событие:** клиент пишет в личный чат с Telegram-ботом.
- **Направление:** Telegram → Битрикс24.
- **Сущности:** сообщение, бот, диалог, открытая линия, оператор.
- **Результат:** сообщение попадает в открытую линию, оператор отвечает из Битрикс24, история диалога
  сохраняется в CRM.

### Новый клиент → карточка и заявка

- **Событие:** боту пишет пользователь, которого ещё нет в CRM.
- **Направление:** Telegram → Битрикс24.
- **Сущности:** контакт, лид или сделка, источник «Telegram», ответственный.
- **Результат:** обращение получает карточку по правилам портала, источник фиксируется для отчётов.

### Событие CRM → уведомление в Telegram

- **Событие:** новая сделка, оплата, просроченная задача или смена стадии.
- **Направление:** Битрикс24 → Telegram.
- **Сущности:** сообщение, `chat_id`, событие CRM, получатель.
- **Результат:** сотрудник или клиент получает уведомление через `sendMessage`; это своя интеграция на
  Bot API, а не штатный канал.

### Приглашение клиента → ссылка на бота

- **Событие:** оператор отправляет клиенту ссылку или QR-код на бота.
- **Направление:** Битрикс24 → клиент.
- **Сущности:** ссылка на бота, клиент, диалог.
- **Результат:** клиент открывает чат и начинает диалог, после чего бот может отвечать ему без
  дополнительных приглашений.

## Триггеры и действия

| Событие в Telegram | Действие в Битрикс24 | Примечание |
| --- | --- | --- |
| Личное сообщение боту | Диалог в открытой линии | Бот работает только в личных чатах |
| Новый пользователь | Создание контакта или заявки | По правилам открытой линии и роботов |
| Сообщение в группе | Ничего | Сообщения групп в CRM не приходят |
| Отзыв токена | Канал перестаёт работать | Нужно подключить бота заново |

| Событие в Битрикс24 | Действие в Telegram | Примечание |
| --- | --- | --- |
| Ответ оператора | Сообщение клиенту через бота | Штатный канал |
| Смена стадии или оплата | Уведомление через свой бот | Нужен `chat_id` получателя |
| Закрытие диалога | Завершение переписки | Клиент может написать снова |

## Варианты реализации

- **Штатный канал Telegram** — бот создаётся в `@BotFather`, токен вставляется в настройках канала, бот
  привязывается к открытой линии. Кода нет, набор возможностей ограничен контакт-центром.
- **Приложение из Маркетплейса** — добавляет сценарии и отчёты, но приносит вендора, подписку и его
  ограничения; проверяются права и совместимость.
- **iPaaS** — связывает события Telegram и CRM без серверного кода; подходит для уведомлений, но логика
  остаётся вне репозитория.
- **Custom-интеграция на Bot API** — свой сервис принимает webhook или `getUpdates`, ведёт журнал,
  вызывает методы Битрикс24 и наоборот. Даёт контроль над повторами и идемпотентностью.

Граница простая: переписка в CRM — штатный канал; собственные уведомления и сложные правила — Bot API.

## Данные и соответствие полей

| Данные в Telegram | Куда попадают в Битрикс24 | Ключ соответствия | Примечание |
| --- | --- | --- | --- |
| `chat_id` | Диалог и получатель уведомлений | Идентификатор чата | Появляется после первого сообщения |
| Имя и username | Контакт клиента | Внешний идентификатор | Могут быть скрыты настройками |
| Текст сообщения | Сообщение диалога | Время и автор | Разметка и вложения — отдельно |
| Бот | Канал обращения | Токен | Один бот — один портал |
| Ссылка на бота | Источник обращения | — | Используется в приглашениях |

**Владелец данных:** Telegram владеет профилем и доставкой сообщений; Битрикс24 — карточкой клиента,
сделкой и историей работы. Бот не заменяет CRM-карточку и не хранит воронку.

## Перед запуском

- [ ] Создать бота у `@BotFather` и сохранить токен в защищённой конфигурации.
- [ ] Отключить добавление бота в группы, чтобы не получать сообщения, которые не попадают в CRM.
- [ ] Создать открытую линию и настроить очередь операторов.
- [ ] Подключить бота к линии и назначить отвечающих сотрудников.
- [ ] Проверить, не подключён ли тот же бот к другому Битрикс24.
- [ ] Прогнать на staging: первое сообщение, ответ оператора, уведомление через Bot API, отзыв токена.

## Ограничения и надёжность

- **Один портал на бота.** Бот, подключённый к нескольким Битрикс24, работает только в последнем:
  второй портал молча теряет сообщения.
- **Только личные чаты.** Групповые чаты не передаются в CRM; бот лучше сразу закрыть от добавления в
  группы.
- **Лимит создания.** Из одного аккаунта Telegram создаётся не более 20 ботов.
- **Токен.** `/revoke` у `@BotFather` отзывает старый токен: все прежние подключения перестают работать,
  новый токен нужно вставить заново.
- **Инициатива.** Бот может написать первым только тому, кто уже начал с ним диалог; `chat_id`
  сохраняется после первого сообщения.
- **Лимиты Bot API.** У методов есть ограничения частоты и длины сообщения; массовые уведомления идут
  порциями и с повторами.

## Вопросы и ответы

**Можно ли использовать один бот в двух Битрикс24?**
Технически подключить можно, но работать он будет только в последнем портале. Для второго портала
нужен отдельный бот.

**Попадут ли сообщения из групп?**
Нет, поэтому добавление бота в группы отключают — иначе сообщения теряются без следа в CRM.

**Как отправить уведомление клиенту?**
Через собственный бот и `sendMessage`, если клиент уже начал диалог и известен его `chat_id`. Штатный
канал служит для переписки, а не для рассылок.

**Что будет при отзыве токена?**
Канал перестанет принимать и отправлять сообщения до подключения бота с новым токеном.

## Решения

- [Wazzup: Telegram и другие каналы в открытых линиях Битрикс24](https://wpcraft.ru/integrations/solutions/wazzup.md) —
  Сервис-коннектор, который подключает Telegram и другие мессенджеры к открытым линиям Битрикс24 и
  сохраняет переписку в карточке клиента.
- [Albato: сценарии между Битрикс24 и Telegram](https://wpcraft.ru/integrations/solutions/albato.md) — Конструктор
  интеграций, который связывает события Битрикс24 с сообщениями Telegram без кода: триггеры,
  действия и обмен данными по сценарию.

## Источники

- [Битрикс24: как подключить Telegram из CRM](https://helpdesk.bitrix24.ru/open/17538378/)
- [Telegram Bot API](https://core.telegram.org/bots/api)