Отправка геометки

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

Назначение

Отправить клиенту адрес офиса, пункта выдачи или склада
Указать точное местоположение объекта для курьера или сотрудника
Добавить геометку в автоматическое уведомление

Параметры

Параметр	Описание	Обязательный
Линия	Линия Олчат, через которую отправляется геометка	Да
Тип идентификатора	Способ определения получателя	Да
ID чата / Username / Телефон	Идентификатор получателя	Да
Широта	Географическая широта (latitude)	Да
Долгота	Географическая долгота (longitude)	Да
Название места	Название точки на карте	Нет
Адрес	Текстовый адрес	Нет
Публикация в ОЛ	Режим публикации в открытую линию	Нет
Записать в CRM карточку	Добавить запись в таймлайн CRM	Нет (по умолчанию: Да)

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

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

На нужной стадии воронки добавьте робота отправки геометки из раздела Олчат.

Шаг 2. Укажите координаты

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

Примеры координат:

Москва, Красная площадь: широта 55.7539, долгота 37.6208

Шаг 3. Добавьте описание места

При необходимости укажите название места и текстовый адрес. Эта информация отображается вместе с картой.

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

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

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

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

Коды ошибок

Код	Описание
`COORDS_EMPTY`	Координаты не указаны
`COORDS_INVALID`	Некорректные координаты (не числовое значение)
`LINE_NOT_FOUND`	Линия не найдена или не активна
`CHAT_NOT_FOUND`	Не удалось найти чат с получателем
`CLIENT_ERROR`	Не удалось подключиться к мессенджеру
`SEND_ERROR`	Ошибка при отправке

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

Широта должна быть в диапазоне от -90 до 90, долгота — от -180 до 180
Координаты указываются в десятичном формате с точкой в качестве разделителя: 55.7539, а не 55,7539
Название места и адрес отображаются в сообщении под картой (поддержка зависит от мессенджера)
Получатель может нажать на карту для построения маршрута через приложение навигации