Отправка контакта в группу

Робот «Отправка контакта в группу» позволяет автоматически отправлять карточку контакта (визитку) в групповой чат мессенджера из бизнес-процесса Битрикс24.

Описание

Робот отправляет карточку контакта с номером телефона и именем в указанный групповой чат Telegram или MAX. Карточка контакта отображается в мессенджере как интерактивный элемент, позволяющий участникам группы сохранить контакт или позвонить по указанному номеру.

Параметры

Параметр	Тип	Обязательный	Описание
Мессенджер	Выбор	Да	Тип мессенджера: Telegram или MAX
Открытая линия	Выбор	Да	Открытая линия, к которой подключена группа
ID группы	Строка	Да	Идентификатор группового чата
Имя	Строка	Да	Имя контакта
Фамилия	Строка	Нет	Фамилия контакта
Телефон	Строка	Да	Номер телефона контакта

Формат номера телефона

Номер телефона необходимо указывать в международном формате:

+79001234567 — рекомендуемый формат
79001234567 — допустимый формат

Настройка робота

Шаг 1. Добавьте робота в бизнес-процесс

Добавьте робота Олчат: Отправка контакта в группу на нужную стадию бизнес-процесса.

Шаг 2. Настройте параметры

Выберите мессенджер и открытую линию
Укажите ID группы
Заполните данные контакта: имя, фамилию (необязательно), телефон
Используйте переменные бизнес-процесса для автоматического заполнения

Пример с переменными:

Имя: {{Имя контакта}}
Фамилия: {{Фамилия контакта}}
Телефон: {{Телефон контакта}}

Шаг 3. Сохраните и активируйте

Сохраните настройки и активируйте бизнес-процесс.

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

Значение	Тип	Описание
Статус	Строка	Результат отправки: `success` или `error`
ID сообщения	Строка	Идентификатор сообщения с контактом
Описание ошибки	Строка	Текст ошибки (при неудачной отправке)

Пример использования

Сценарий: При создании проектной группы отправить контакт менеджера проекта всем участникам.

Настройка:

Мессенджер: Telegram
Открытая линия: Проектные группы (#3)
ID группы: {{ID проектной группы}}
Имя: {{Имя ответственного}}
Фамилия: {{Фамилия ответственного}}
Телефон: {{Рабочий телефон ответственного}}

Что дальше

Отправка сообщения в группу — отправка текста
Отправка геометки в группу — отправка местоположения
Особенности номеров — форматы телефонных номеров