Шорткоды
Шорткоды — это специальные текстовые команды, которые позволяют отправлять файлы, контакты, геолокацию и другие типы вложений через шаблоны сообщений и роботов Битрикс24. Шорткод вставляется в текст сообщения и при отправке заменяется соответствующим вложением.
Что такое шорткоды
Заголовок раздела «Что такое шорткоды»Шорткод — это текстовая команда в формате [=тип:параметры]. При отправке сообщения система обнаруживает шорткоды в тексте, извлекает их и преобразует в соответствующие вложения (файлы, контакты, местоположение).
Шорткоды можно использовать:
- В шаблонах сообщений
- В роботах Битрикс24
- В триггерах
- В рассылках
- В любых сообщениях, отправляемых через Олчат
Синтаксис шорткодов
Заголовок раздела «Синтаксис шорткодов»Общий формат:
[=тип:параметры]Если шорткод требует несколько параметров, они разделяются символом | (вертикальная черта):
[=тип:параметр1|параметр2|параметр3]Шорткод можно вставить в любое место текста сообщения. При отправке текст шорткода удаляется из сообщения, а вложение отправляется вместе с оставшимся текстом.
Доступные шорткоды
Заголовок раздела «Доступные шорткоды»Файл — [=file:URL]
Заголовок раздела «Файл — [=file:URL]»Отправляет файл по прямой ссылке.
Синтаксис:
[=file:URL]Пример:
Направляю прайс-лист:[=file:https://example.com/files/price-2026.pdf]Файл скачивается по ссылке и отправляется в мессенджер как документ. Имя файла определяется автоматически из URL.
Голосовое сообщение — [=voice:URL]
Заголовок раздела «Голосовое сообщение — [=voice:URL]»Отправляет аудиофайл как голосовое сообщение.
Синтаксис:
[=voice:URL]Пример:
[=voice:https://example.com/audio/greeting.ogg]Файл с диска Битрикс24 — [=disk:ID]
Заголовок раздела «Файл с диска Битрикс24 — [=disk:ID]»Отправляет файл из диска Битрикс24 по его идентификатору.
Синтаксис:
[=disk:ID]Пример:
Отправляю документ:[=disk:12345]Где 12345 — идентификатор файла на диске Битрикс24.
Контакт (визитка) — [=vcard:ТЕЛЕФОН]
Заголовок раздела «Контакт (визитка) — [=vcard:ТЕЛЕФОН]»Отправляет контактную карточку с номером телефона.
Синтаксис:
[=vcard:ТЕЛЕФОН]Пример:
Контакт нашего менеджера:[=vcard:79001234567]Номер телефона нормализуется автоматически: удаляются пробелы, скобки и дефисы; номер в формате 8XXXXXXXXXX преобразуется в 7XXXXXXXXXX.
Ссылка с превью — [=link:URL|ЗАГОЛОВОК|ПРЕВЬЮ|ОПИСАНИЕ]
Заголовок раздела «Ссылка с превью — [=link:URL|ЗАГОЛОВОК|ПРЕВЬЮ|ОПИСАНИЕ]»Отправляет ссылку с визуальным превью (заголовок, изображение, описание).
Синтаксис (полный):
[=link:URL|ЗАГОЛОВОК|ПРЕВЬЮ_URL|ОПИСАНИЕ]Синтаксис (автоматическое превью):
[=link:URL]Параметры:
| Параметр | Обязателен | Описание |
|---|---|---|
| URL | Да | Адрес ссылки |
| ЗАГОЛОВОК | Нет | Заголовок ссылки |
| ПРЕВЬЮ_URL | Нет | URL изображения для превью |
| ОПИСАНИЕ | Нет | Текстовое описание ссылки |
Пример:
[=link:https://olchat.io|Олчат|https://olchat.io/preview.png|Интеграция мессенджеров с Битрикс24]Если указан только URL без дополнительных параметров, система попытается сформировать превью автоматически.
Геолокация — [=location:ШИРОТА|ДОЛГОТА|АДРЕС]
Заголовок раздела «Геолокация — [=location:ШИРОТА|ДОЛГОТА|АДРЕС]»Отправляет местоположение на карте.
Синтаксис:
[=location:ШИРОТА|ДОЛГОТА|АДРЕС]Пример:
Наш офис:[=location:55.7558|37.6173|Москва, Красная площадь, 1]Адрес может состоять из двух частей, разделённых |:
[=location:55.7558|37.6173|Москва|Красная площадь, 1]YouTube-видео — [=youtube:КОД]
Заголовок раздела «YouTube-видео — [=youtube:КОД]»Отправляет ссылку на YouTube-видео с превью.
Синтаксис:
[=youtube:КОД_ВИДЕО]Пример:
Посмотрите наш обзор:[=youtube:dQw4w9WgXcQ]Где dQw4w9WgXcQ — код видео из URL YouTube (часть после v=).
Файл из CRM — [=crm_file:ТИП|ID|ПОЛЕ]
Заголовок раздела «Файл из CRM — [=crm_file:ТИП|ID|ПОЛЕ]»Отправляет файл из поля CRM-сущности Битрикс24.
Синтаксис (по полю CRM):
[=crm_file:ТИП_СУЩНОСТИ|ID_СУЩНОСТИ|ИМЯ_ПОЛЯ]Синтаксис (по ID файла):
[=crm_file:ID_ФАЙЛА]Примеры:
[=crm_file:deal|7303|UF_CRM_FILE][=crm_file:12345]| Параметр | Описание |
|---|---|
| ТИП_СУЩНОСТИ | Тип CRM-сущности: deal, lead, contact, company |
| ID_СУЩНОСТИ | Числовой идентификатор сущности |
| ИМЯ_ПОЛЯ | Системное имя поля, содержащего файл |
| ID_ФАЙЛА | Идентификатор файла на диске Битрикс24 |
Голосовое из CRM — [=crm_voice:ТИП|ID|ПОЛЕ]
Заголовок раздела «Голосовое из CRM — [=crm_voice:ТИП|ID|ПОЛЕ]»Аналогично crm_file, но файл отправляется как голосовое сообщение.
Синтаксис:
[=crm_voice:ТИП_СУЩНОСТИ|ID_СУЩНОСТИ|ИМЯ_ПОЛЯ][=crm_voice:ID_ФАЙЛА]Примеры использования
Заголовок раздела «Примеры использования»Шаблон с файлом и текстом
Заголовок раздела «Шаблон с файлом и текстом»Здравствуйте, {{contact_name}}!
Направляю коммерческое предложение по вашему запросу:[=file:https://example.com/files/commercial-offer.pdf]
Если возникнут вопросы — пишите, я на связи.Шаблон с контактом и геолокацией
Заголовок раздела «Шаблон с контактом и геолокацией»Контакт вашего менеджера:[=vcard:79001234567]
Адрес нашего офиса:[=location:55.7558|37.6173|Москва, ул. Примерная, д. 1]Робот с файлом из CRM
Заголовок раздела «Робот с файлом из CRM»В роботе Битрикс24 можно использовать шорткод вместе с переменными бизнес-процесса:
Документы по сделке "{{deal_title}}":[=crm_file:deal|{{deal_id}}|UF_CRM_DOCS]Несколько вложений в одном сообщении
Заголовок раздела «Несколько вложений в одном сообщении»В одном сообщении можно использовать несколько шорткодов:
Материалы для подготовки:[=file:https://example.com/docs/manual.pdf][=file:https://example.com/docs/checklist.pdf][=youtube:dQw4w9WgXcQ]Использование в роботах
Заголовок раздела «Использование в роботах»Шорткоды поддерживаются в следующих роботах Олчат:
- Отправка сообщения — текст сообщения может содержать шорткоды
- Отправка через SMS — шорткоды в тексте SMS-сообщения
Подробнее о шорткодах в роботах: Шорткоды в быстрых ответах.
Что дальше
Заголовок раздела «Что дальше»- Шаблоны сообщений — использование шорткодов в шаблонах
- Роботы и бизнес-процессы — автоматизация с шорткодами
- Форматирование текста — форматирование текстовых сообщений