Форматирование текста
Олчат обеспечивает конвертацию форматирования текста между Битрикс24 (BBCode) и мессенджерами (Telegram, MAX). При передаче сообщений форматирование автоматически преобразуется в формат, поддерживаемый целевой платформой.
Форматирование в Telegram
Заголовок раздела «Форматирование в Telegram»Telegram поддерживает расширенный набор форматирования текста. При отправке из Битрикс24 в Telegram и обратно поддерживаются следующие стили:
| Стиль | Отображение в Telegram | BBCode в Битрикс24 |
|---|---|---|
| Жирный | текст | [B]текст[/B] |
| Курсив | текст | [I]текст[/I] |
[S]текст[/S] | ||
Моноширинный | код | [CODE]код[/CODE] |
| Блок кода | Многострочный код | [CODE]код[/CODE] |
| Ссылка | текст | [URL=ссылка]текст[/URL] |
| Подчёркнутый | подчёркнутый текст | [U]текст[/U] |
Пример конвертации
Заголовок раздела «Пример конвертации»Сообщение из Битрикс24:
[B]Важно![/B] Ваш заказ [I]№12345[/I] готов.Подробнее: [URL=https://example.com]ссылка[/URL]В Telegram клиент увидит:
**Важно!** Ваш заказ *№12345* готов.Подробнее: ссылка (кликабельная)Форматирование в MAX
Заголовок раздела «Форматирование в MAX»MAX поддерживает форматирование на основе Markdown. При отправке из Битрикс24 в MAX выполняется конвертация BBCode в Markdown:
| Стиль | Формат в MAX | BBCode в Битрикс24 |
|---|---|---|
| Жирный | **текст** | [B]текст[/B] |
| Курсив | *текст* | [I]текст[/I] |
Код | `код` | [CODE]код[/CODE] |
| Ссылка | [текст](url) | [URL=ссылка]текст[/URL] |
Конвертация BBCode из Битрикс24
Заголовок раздела «Конвертация BBCode из Битрикс24»Битрикс24 использует BBCode для форматирования сообщений в чатах. Олчат автоматически конвертирует BBCode в формат целевого мессенджера.
Поддерживаемые теги BBCode
Заголовок раздела «Поддерживаемые теги BBCode»| BBCode | Результат |
|---|---|
[B]...[/B] | Жирный текст |
[I]...[/I] | Курсив |
[S]...[/S] | Зачёркнутый |
[U]...[/U] | Подчёркнутый |
[CODE]...[/CODE] | Моноширинный код |
[URL=ссылка]текст[/URL] | Ссылка с текстом |
[URL]ссылка[/URL] | Ссылка |
[QUOTE]...[/QUOTE] | Цитата |
Неподдерживаемые теги
Заголовок раздела «Неподдерживаемые теги»Специфичные для Битрикс24 теги (упоминания пользователей, встроенные объекты и другие) удаляются при отправке в мессенджер, и передаётся только текстовое содержание.
Ссылки (URL) обрабатываются следующим образом:
- Из Битрикс24 в мессенджер: BBCode
[URL=...]преобразуется в кликабельную ссылку. - Из мессенджера в Битрикс24: Ссылки из Telegram (entity
text_url/text_link) и обычные URL преобразуются в BBCode. - Голые ссылки (bare URL): Ссылки без оформления автоматически определяются и становятся кликабельными.
Эмоджи (смайлы) полностью поддерживаются в обоих направлениях:
- Эмоджи из мессенджера отображаются в Битрикс24 без изменений.
- Эмоджи из Битрикс24 передаются в мессенджер в стандартном формате Unicode.
- Стикеры Telegram передаются как изображения.
Вложения и файлы
Заголовок раздела «Вложения и файлы»Олчат поддерживает передачу различных типов файлов между Битрикс24 и мессенджерами.
Поддерживаемые типы вложений
Заголовок раздела «Поддерживаемые типы вложений»| Тип | Telegram | MAX | Примечания |
|---|---|---|---|
| Изображения (JPG, PNG, GIF, WebP) | Да | Да | Сжимаются мессенджером |
| Документы (PDF, DOC, XLS и др.) | Да | Да | Передаются как файлы |
| Видео (MP4, MOV и др.) | Да | Да | Ограничение по размеру |
| Аудио (MP3, OGG и др.) | Да | Да | Включая голосовые |
| Голосовые сообщения | Да | Да | Формат OGG/Opus |
| Видеосообщения (кружки) | Да | — | Специфично для Telegram |
| Стикеры | Да | — | Передаются как изображения |
Ограничения по размеру файлов
Заголовок раздела «Ограничения по размеру файлов»| Мессенджер | Максимальный размер |
|---|---|
| Telegram | До 2 ГБ (через Bot API — до 50 МБ) |
| MAX | В зависимости от типа файла |
| Битрикс24 | Определяется тарифом портала |
Отправка файлов из Битрикс24
Заголовок раздела «Отправка файлов из Битрикс24»При отправке файла из чата Битрикс24 в мессенджер:
- Файл загружается оператором в чат открытой линии.
- Олчат получает файл и определяет его тип.
- Файл передаётся в мессенджер клиента в оригинальном формате.
Получение файлов от клиента
Заголовок раздела «Получение файлов от клиента»Файлы, отправленные клиентом из мессенджера:
- Файл загружается на сервер Олчат.
- Передаётся в чат открытой линии Битрикс24.
- Оператор может просмотреть или скачать файл из чата.
Особенности отправки нескольких файлов
Заголовок раздела «Особенности отправки нескольких файлов»Если оператор отправляет несколько файлов одновременно, каждый файл передаётся в мессенджер отдельным сообщением. Подробнее об отправке нескольких файлов через роботов читайте в разделе Несколько файлов из CRM.
Рекомендации по форматированию
Заголовок раздела «Рекомендации по форматированию»- Используйте простое форматирование: жирный, курсив, ссылки.
- Избегайте глубоко вложенного форматирования — оно может отображаться некорректно.
- Проверяйте отображение ссылок — убедитесь, что URL корректны перед отправкой.
- Для кода и технической информации используйте моноширинный формат
[CODE]. - Учитывайте ограничения по размеру файлов в зависимости от мессенджера.