ВОЗМОЖНОСТИ
Шорткоды
Шорткоды – это конструкции, которые позволяют гибко использовать различные типы сообщений. С их помощью можно выполнять какое-либо действие непосредственно в текстовом сообщении. Они могут быть использованы в роботах, бизнес-процессах, в карточке CRM, в чатах и группах для отправки приложением OLChat файлов, голосовых сообщений, ссылок, визиток и месторасположения.
Ниже представлен список поддерживаемых шорткодов:
Описание
Шорткод
Условные обозначения
Файл с диска
[=disk:<file_id>]
file_id – id файла на Битрикс.Диск. Желательно использовать файлы из Общей папки
Файл по ссылке
[=file:<url>]
url – прямая ссылка на файл
Файл из поля crm
[=crm_file:<crm_type>|<crm_id>|<field>]
crm_type – тип сущности
crm_id – ИД сущности
field – ИД поля в сущности
Файл из прикрепленного файла поля crm
[=crm_file:<file_id>]
file_id – id прикрепленного файла поля CRM
Голосовое по ссылке
[=voice:<url>]
url – прямая ссылка на файл
Голосовое из поля crm
[=crm_voice:<crm_type>|<crm_id>|<field>]
crm_type – тип сущности
crm_id – ИД сущности
field – ИД поля в сущности
Голосовое из прикреплённого файла поля crm
[=crm_voice:<file_id>]
file_id – id прикрепленного файла поля CRM
Визитка
[=vcard:<phone>]
phone – номер телефона визитки
Ссылка
[=link:<url>|<title>|<<preview_link>>|<<description>>]
url – ссылка для отправки
title – заголовок
preview_link – прямая ссылка на картинку предпросмотра
description – описание к ссылке
Ссылка с автосбором информации
[=link:<url>]
url – ссылка для отправки
Месторасположение
[=location:<lat>|<lng>|<address>|<<address_2>>]
lat – Широта
lng – Долгота
address – Адрес
address_2 – вторая строка адреса
Ссылка на youtube видео
[=youtube:<v_code>]
v_code – код видео
Варианты использования шорткодов:
  • Быстрые ответы в чате
  • В шаблонах сообщений в приложении
  • В роботах и бизнес-процессах
  • В карточке сущности в виджете
Шорткоды следует использовать без угловых скобок < > и << >>. Скобки указывают на обязательность и необязательность значений, содержащихся внутри скобок.
Значения, указанные в одинарных угловых скобках, вида: <file_id>, <url> и т. д. – являются обязательными к заполнению. Без указания данных значений, шорткод корректно не отработает!
Значения, указанные в двойных угловых скобках, вида: <<preview_link>>, <<description>> и т. д. не обязательны к заполнению. Их отсутствие не повлияет на корректную работу шорткода.

Пример использования шорткодов

Предположим, что нам необходимо отправить оформленную ссылку с превью и описанием. Для этого воспользуемся шорткодом Ссылка: [=link:<url>|<title>|<<preview_link>>|<<description>>]
Подготовим конструкцию для отправки:
  1. 1.
    Вместо <url> подставим значение https://olchat.io/ . Это та ссылка, которую мы хотим отправить.
  2. 2.
    Вместо <title> подставим текст: Профессиональный сервис для интеграции WhatsApp и Битрикс24.
  3. 3.
    Вместо <<preview_link>> подставим ссылку на картинку, которая будет отображаться на превью ссылки. Это должна быть прямая ссылка на файл. В нашем случае это https://util.1c-bitrix.ru/upload/bx24vendor/6ce/tcuggxbty712a60mb8zas05xb4cutqte/OLChat_logo.png
  4. 4.
    Вместо <<description>> подставим текст: OLChat — Чаты и Группы WhatsApp.
Соберём подготовленные данные в единое целое:
[=link:https://olchat.io/|Профессиональный сервис для интеграции WhatsApp и Битрикс24|https://util.1c-bitrix.ru/upload/bx24vendor/6ce/tcuggxbty712a60mb8zas05xb4cutqte/OLChat_logo.png|OLChat — Чаты и Группы WhatsApp]
Полученный шорткод отправим клиенту, используя виджет в карточке сделки
В результате, в WhatsApp придёт сообщение такого вида:
Используя роботы и активити бизнес-процессов, данную конструкцию шорткода можно собирать и отправлять в автоматическом режиме, указывая в значениях переменные и поля, откуда робот или активити должны взять информацию.
Copy link
Contents