Проверка телефона

Робот Проверка телефона ([Telegram] Найти аккаунт / [MAX] Найти аккаунт) проверяет, зарегистрирован ли номер телефона в указанном мессенджере, и возвращает информацию о найденном аккаунте. Это полезно для определения доступных каналов связи с клиентом перед отправкой сообщения.

Назначение

• Проверить, есть ли у клиента аккаунт Telegram или MAX
• Получить username, имя и фамилию из мессенджера
• Построить условную логику: если аккаунт найден — отправить сообщение, если нет — использовать другой канал

Параметры

Параметр	Описание	Обязательный
Линия	Линия Олчат, через которую выполняется проверка	Да
Тип поиска	Способ поиска: по номеру телефона или по username	Да
Номер телефона	Номер телефона в международном формате (например, 79991234567)	Нет*
Username	Имя пользователя без символа @	Нет*

* Обязательность зависит от выбранного типа поиска.

Заметка

Для поиска по username доступен только Telegram. В MAX поиск осуществляется исключительно по номеру телефона.

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

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

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

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

Укажите линию, через которую будет выполняться проверка. Линия определяет, какой мессенджер используется.

Шаг 3. Укажите тип поиска

Выберите способ поиска:

• По номеру телефона — укажите поле CRM с номером телефона
• По username — укажите username (только Telegram)

Шаг 4. Укажите идентификатор

Для поиска по телефону вставьте переменную с номером телефона из CRM-карточки, например {{Телефон}}. Подробнее: Переменные в роботах.

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

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

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

Значение	Тип	Описание
found	bool	Найден ли аккаунт: Y или N
user_id	string	ID пользователя в мессенджере
username	string	Username пользователя
first_name	string	Имя пользователя
last_name	string	Фамилия пользователя
phone	string	Номер телефона из профиля
error	string	Текст ошибки (при неуспешном выполнении)
error_code	string	Код ошибки

Коды ошибок

Код	Описание
PHONE_EMPTY	Номер телефона не указан
USERNAME_EMPTY	Username не указан
LINE_NOT_FOUND	Линия не найдена или не активна
CLIENT_ERROR	Не удалось подключиться к мессенджеру
SEARCH_ERROR	Ошибка при выполнении поиска

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

Совет

Используйте этого робота перед отправкой сообщений, чтобы убедиться, что клиент доступен в выбранном мессенджере. Это позволяет избежать ошибок отправки и построить альтернативные сценарии.

Осторожно

Частые запросы проверки могут быть ограничены API мессенджера. Не используйте этого робота в циклах с большим количеством итераций.

• Номер телефона должен быть в международном формате без пробелов и специальных символов: 79991234567
• Результат found = N не всегда означает, что у клиента нет аккаунта — возможно, номер не привязан к профилю или настройки приватности скрывают его
• Значение user_id можно использовать в последующих роботах как идентификатор чата (тип идентификатора: По ID чата)