Отправка сообщений из робота или чатов Битрикс24 с номера WhatsApp Cloud
После того как вы подключите телефонный номер WhatsApp к своему порталу Битрикс24, в разделе «СМС» в сделке и в роботе «Отправить СМС клиенту» появится СМС провайдер WhatsApp Cloud gulin.kz_(ваш номер), с помощью которого вы сможете отправить шаблонное сообщение вашему клиенту.
Если номеров несколько, выберите нужный и в поле «Текст сообщения» введите название шаблона и его язык по схеме: template+1611785136490504 (где 1611785136490504 - это уникальный идентификатор вашего шаблона). Шорткод шаблона и его параметры вы можете посмотреть на странице WhatsApp, кликнув на нужный номер.
Что нужно знать:
- Отправка сообщений любого содержания возможна в течение 24 часов после последнего сообщения от клиента
- Чтобы написать первым за период больше чем 24 часа с момента последнего сообщения клиента нужно использовать шаблон
- Шаблонные сообщения вы можете отправлять первым любому пользователю WhatsApp
- За каждое доставленное сообщение WhatsApp взимает плату в соответствии со своими тарифами
- Шаблоны сообщений WhatsApp можно отправлять из модуля "Сообщения" (раньше СМС), с помощью роботов и из открытых линий Битрикс24
- Можно использовать шаблоны с вложениями и переменными (подстановочные параметры)
- Использование шаблонов сообщений в спам-рассылках не спасёт от бана вашего номера и бизнес аккаунта
Для создания шаблона сообщения перейдите на эту страницу и воспользуйтесь готовыми шаблонами или создайте свой.
1) Шаблон с переменными параметрами
На текущий момент поддерживаются параметры типа "Номер" и "Название"
1.1.) Нумерованные параметры
Если шаблон создан с подстановочными параметрами {{1}}, {{2}} и т.д., то для отправки этих параметров используйте следующую схему:
template+1611785136490504+текст первого параметра|текст второго параметра|и т.д.
то есть после стандартной схемы шаблона template+1611785136490504 добавляете + и текст первого параметра и, если параметров больше одного, то каждый следующий отделяйте вертикальной чертой | (pipe)
- Количество параметров не ограничено
- Параметры поддерживаются только в тексте сообщения (body). В заголовке и подвале параметры не подставляются
- Максимальная длина сообщения, включая текст шаблона и параметров не должна превышать 1024 символов
Использование шаблона с параметрами позволит вам отправлять практически уникальные сообщения без необходимости создания большого количества шаблонов.
Например, создав шаблон такого вида:
Здравствуйте. Вас приветствует компания "Рога и копыта". {{1}}. Наш адрес не дом и не улица..
вы можете отправить шаблон с любым значением {{1}}
template+1611785136490504+Время для ремонта с невероятными скидками до 60% на керамогранит, плитку, сантехнику, ламинат и многое другое. Рассрочка без переплат до 24 месяцев.
Ваш клиент получит следующее сообщение:
Здравствуйте. Вас приветствует компания "Рога и копыта". Время для ремонта с невероятными скидками до 60% на керамогранит, плитку, сантехнику, ламинат и многое другое. Рассрочка без переплат до 24 месяцев. Наш адрес не дом и не улица..
По этой же схеме вы можете создать универсальный шаблон для использования его по умлолчаню.
1.1.) Именованные параметры
Шорткод шаблона для использования в Битрикс24:
template+1611785136490504+bank:Asia | market:Sirius | name:Karim | date:20/01/12
То есть в параметрах шоткода перечисляются все их названия со значениями через двоеточие.
Параметры отделяются друг от друга вертикальной чертой |
- bank:Asia
- market:Sirius
- name:Karim
- date:20/01/12
- и т.д.
2) Шаблон с вложениям (медиафайлами)
На текущий момент поддерживаются файлы следующих типов:
- Документ (только pdf)
- Изображения
- Видео
Для того чтобы иметь возможность отправки файлов в виде вложений, создайте шаблон с указанием типа файла.
Учтите, что в одном шаблоне в качестве вложения можно передать только один тип файла и только один файл
и в шорткоде для Битрикс24 используйте следующую схему
template+1611785136490504+file_link:https://crm.bitrix24.kz/~ErxGn
где file_link - ссылка на файл. Можно использовать автоматически генерируемые Битриксом ссылки на файлы в роботах и бизнес процессах
template+1611785136490504+file_link:{{Файл > shortlink}}
Отправку файлов можно совмещать с параметрами, если шаблон был создан с ними:
template+1611785136490504+file_link:https://crm.bitrix24.kz/~ErxGn | текст первого параметра|текст второго параметра....
3) Шаблон с динамическим URL в кнопке
При создании шаблона вы можете добавить в него элемент "Кнопка" с динамическим URL.
Это позволит отправлять клиентам индивидуальные ссылки для различных действий.
Например, отслеживание статуса заказа на вашем сайте, ссылка на документ и т.д.
Для передачи значения используйте в шорткоде элемент button_param:
Ссылка на произвольный домен
- Если в настройках шаблона вы добавили кнопку с динамическим адресом и указали базовый URL: https://ваш-домен.com/
- То ваш шорткод будет выглядеть так: template+1611785136490504+button_param:order-001
- А клиент получит сообщение со ссылкой: https://ваш-домен.com/order-001
Ссылка на портал Битрикс24
Для удобства работы со ссылками, которые формируются в CRM Битрикс24 (например, ссылка на файл), мы добавили внутренний редирект. Данный функционал работает только для ссылок на порталы Битрикс24 на которых установлено наше приложение.
Для использования этого редиректа в настройках шаблона укажите динамическую ссылку:
https://gulin.kz/api/bitrix/?url=а в шорткод передавайте ту ссылку, которую формирует Битрикс24
Например,
- Шорткод для SMS или открытой линии: template+1611785136490504+button_param:{{Файл > shortlink}}
- Битрикс24 формирует ссылку на файл такого вида: https://crm.bitrix24.kz/~XXXXX
- В кнопку будет передана ссылка: https://gulin.kz/api/bitrix/?url=https://crm.bitrix24.kz/~XXXXX
- При клике на которую ваш клиент будет переадресован на исходную ссылку: https://crm.bitrix24.kz/~XXXXX
| Ссылка на Б24? | В шаблоне указать | Значение +button_param: | В кнопке будет ссылка | Редирект на |
|---|---|---|---|---|
| Да | https://gulin.kz/api/bitrix/?url= | https://crm.bitrix24.kz/~XXXXX | https://gulin.kz/api/bitrix/?url=https://crm.bitrix24.kz/~XXXXX | https://crm.bitrix24.kz/~XXXXX |
| Нет | https://ваш-домен.com/ | order-001 | https://ваш-домен.com/order-001 | Нет |
4) Запрос разрешения на звонки в WhatsApp
Для того чтобы получить разрешение на звонок на номер WhatsApp вашего клиента можно воспользоваться следующими способами:
- Если пользователь написал вам, то у вас есть окно в 24 часа от его последнего сообщения для отправки ему бесплатного интерактивного сообщения с запросом разрешения на звонок. Для этого из чата открытой линии или робота (через SMS провайдера) отправьте хештег #call_permission_request.
- Создайте шаблон "Запрос разрешения на звонки" и отправьте его в любое время, используя комбинацию template+1611785136490504. За отправку шаблонных сообщений WhatsApp взимает плату в соответствии со своими тарифами.
Примеры шаблонов сообщений WhatsApp Cloud с шорткодами для Битркс24
| Тип шаблона | Шаблон в Facebook | Шорткод для Битрикс24 | Клиент получит текст |
|---|---|---|---|
| Простой шаблон | Здравствуйте, как Ваши дела? | template+1611785136490504 | Здравствуйте, как Ваши дела? |
| С 1-ой переменной | Здравствуйте, {{1}}. Как Ваши дела? | template+1611785136490504+Василий | Здравствуйте, Василий. Как Ваши дела? |
| С 2-мя и более переменными | Здравствуйте, {{1}}. Как Ваши дела? Завтра в {{2}} у вас запись на приём. | template+1611785136490504+{{Контакт: Имя}}|12.00 | Здравствуйте, Василий. Как Ваши дела? Завтра в 12.00 у вас запись на приём. |
| С именованными параметрами | Здравствуйте {{name}}. Как Ваши дела? Завтра в {{time}} вы записаны на консультацию. | template+1611785136490504+name:{{Контакт: Имя}} | time:12.00 | Здравствуйте, Василий. Как Ваши дела? Завтра в 12.00 вы записаны на консультацию. |
| С документом | Здравствуйте, как Ваши дела? | template+1611785136490504+file_link:https://crm.bitrix24.kz/xxx | Здравствуйте, как Ваши дела? (Файл) |
| С документом и переменной | Здравствуйте, {{1}}. Как Ваши дела? | template+1611785136490504+file_link:{{Файл > shortlink}} | {{Контакт: Имя}} | Здравствуйте, Василий. Как Ваши дела? (Файл) |
| С динамической ссылкой | Здравствуйте, {{1}}. Как Ваши дела? | template+1611785136490504+button_param:{{Файл > shortlink}} | {{Контакт: Имя}} | Здравствуйте, Василий. Как Ваши дела? (кнопка со ссылкой) |
| Запрос разрешения на звонки | Хотите получить звонок от одного из наших представителей? | template+1611785136490504 | Хотите получить звонок от одного из наших представителей? (Разрешать всегда, разрешить на время, Запретить) |
| Интерактивный запрос разрешения на звонок (в пределах 24-ч часов) | -- | #call_permission_request | Хотите получить звонок от одного из наших представителей? |
Обновлено: 04.03.2026 19:43