Отправка сообщения

Робот Отправка сообщения ([Telegram] Отправить сообщение / [MAX] Отправить сообщение) — это основной робот для отправки текстовых сообщений клиентам в Telegram или MAX из бизнес-процессов и роботов CRM Битрикс24.

Назначение

Отправить текстовое сообщение клиенту в мессенджер
Уведомить клиента о событиях (смена стадии сделки, напоминание, подтверждение)
Отправить персонализированное сообщение с данными из CRM

Параметры

Параметр	Описание	Обязательный
Линия	Линия Олчат, через которую отправляется сообщение	Да
Тип идентификатора	Способ определения получателя: по телефону, ID чата или username	Да
ID чата / Username / Телефон	Идентификатор получателя	Да
Сообщение	Текст сообщения для отправки	Да
ID топика	ID топика в группе-форуме (если отправка в топик)	Нет
Публикация в ОЛ	Режим публикации в открытую линию	Нет (по умолчанию: Входящим сообщением)
Записать в CRM карточку	Добавить запись в таймлайн CRM	Нет (по умолчанию: Да)
Отключить превью ссылок	Не показывать предпросмотр URL в сообщении (только Telegram)	Нет (по умолчанию: Нет)
Уведомление о наборе текста	Показать статус «печатает» перед отправкой (только MAX, 0-20 сек)	Нет (по умолчанию: Нет)

Режимы публикации в открытую линию

Режим	Описание
Входящим сообщением	Сообщение отображается в ОЛ как входящее от клиента
Исходящим сообщением	Сообщение отображается в ОЛ как исходящее от оператора
Без публикации	Сообщение отправляется в мессенджер, но не появляется в ОЛ

Настройка в редакторе роботов

Шаг 1. Добавьте робота

На нужной стадии воронки добавьте робота [Telegram] Отправить сообщение или [MAX] Отправить сообщение из раздела Олчат.

Шаг 2. Выберите линию

Укажите линию, через которую будет отправлено сообщение.

Шаг 3. Укажите получателя

Выберите тип идентификатора и укажите значение. Для отправки по номеру телефона вставьте переменную из CRM-карточки.

Шаг 4. Введите текст сообщения

Напишите текст сообщения. Можно использовать переменные бизнес-процесса для персонализации:

Здравствуйте, {{Имя}}!
Ваша сделка №{{ID}} переведена на стадию "{{Стадия}}".

Шаг 5. Настройте дополнительные параметры

При необходимости измените режим публикации в ОЛ, отключите запись в CRM или превью ссылок.

Настройка в дизайнере бизнес-процессов

В дизайнере бизнес-процессов действие доступно в категории Действия приложений. Параметры полностью совпадают с настройкой в роботах CRM. Дополнительно можно использовать переменные и параметры бизнес-процесса.

Возвращаемые значения

Значение	Тип	Описание
`is_sent`	bool	Результат отправки: `Y` (успешно) или `N` (ошибка)
`chat_id`	string	ID чата получателя в мессенджере
`message_id`	string	ID отправленного сообщения
`error`	string	Текст ошибки (при `is_sent = N`)
`error_code`	string	Код ошибки

Коды ошибок

Код	Описание
`MESSAGE_EMPTY`	Текст сообщения не указан
`CHAT_ID_EMPTY`	Идентификатор чата не указан
`LINE_NOT_FOUND`	Линия не найдена или не активна
`CHAT_NOT_FOUND`	Не удалось найти чат с указанным получателем
`SEND_ERROR`	Ошибка при отправке сообщения

Примечания и рекомендации

В Telegram поддерживается форматирование текста (жирный, курсив, ссылки). Подробнее: Форматирование текста
Максимальная длина сообщения: 4096 символов для Telegram, 4096 символов для MAX
При включённом уведомлении о наборе текста (MAX) сообщение отправляется с задержкой на указанное количество секунд
Возвращаемое значение chat_id полезно для сохранения и последующего использования в других роботах (тип идентификатора: По ID чата)