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

Робот Отправка контакта ([Telegram] Отправить контакт / [MAX] Отправить контакт) отправляет карточку контакта с именем и номером телефона. Получатель видит контакт как интерактивную карточку и может сохранить его в свою адресную книгу.

Назначение

Передать клиенту контактные данные менеджера, офиса или партнёра
Автоматически отправить визитку ответственного сотрудника при назначении на сделку
Поделиться контактом третьего лица

Параметры

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

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

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

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

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

Выберите линию и укажите идентификатор получателя (номер телефона из CRM или другой идентификатор).

Шаг 3. Заполните данные контакта

Укажите имя, фамилию и номер телефона для карточки контакта. Можно использовать переменные бизнес-процесса:

Телефон контакта: {{Рабочий телефон ответственного}}
Имя контакта: {{Имя ответственного}}
Фамилия контакта: {{Фамилия ответственного}}

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

Параметры в дизайнере аналогичны настройке в роботах CRM.

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

Значение	Тип	Описание
`is_sent`	bool	Результат отправки: `Y` или `N`
`error`	string	Текст ошибки
`error_code`	string	Код ошибки

Коды ошибок

Код	Описание
`PHONE_EMPTY`	Телефон контакта не указан
`NAME_EMPTY`	Имя контакта не указано
`LINE_NOT_FOUND`	Линия не найдена или не активна
`CHAT_NOT_FOUND`	Не удалось найти чат с получателем
`CLIENT_ERROR`	Не удалось подключиться к мессенджеру
`SEND_ERROR`	Ошибка при отправке

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

Номер телефона контакта должен быть в международном формате: 79991234567
Имя контакта обязательно — без него карточка не может быть отправлена
Карточка контакта отображается в мессенджере как интерактивный элемент с кнопкой «Добавить в контакты»
Фамилия контакта необязательна, но рекомендуется для полноты информации