В Telegram номер телефона — это уникальный идентификатор, и получить его можно только с разрешения пользователя.

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

После нажатия на кнопку-контакт:

  • пользователь автоматически делится именем и номером телефона;
  • вы получаете подтвержденный и корректный контакт.

Кнопка-контакт работает по тем же правилам, что и уже привычные интерактивные кнопки — она отправляется вместе с сообщением, а еще ей можно дать собственное название.

Особенности кнопки-контакта

  1. Работает только в личных чатах. Пользователю нужно подписаться на Telegram-бота и написать сообщение. В групповых чатах подключить такую кнопку невозможно.
  2. Нужна актуальная версия Telegram после 9 апреля 2016 года. В старых версиях Telegram кнопка работать не будет.
  3. К чату с пользователем привязывается только один контактный номер
  4. Если пользователь изменит номер, то новый номер сохранится, только если он снова нажмет кнопку-контакт.

Как настроить кнопку-контакт в Telegram

Кнопка-контакт настраивается внутри открытого вопроса с типом «номер телефона».

Шаг 1. Создайте открытый вопрос

  • Откройте визуальный редактор чат-ботов.
  • Добавьте блок «Открытый вопрос».
  • В поле вопроса напишите запрос, например: «Пожалуйста, поделитесь номером телефона».
  • В настройках выберите тип ответа: номер телефона.

Шаг 2. Кнопка-контакт появится автоматически

Если ваш бот уже подключен к Telegram, система сама добавит кнопку-контакт к открытому вопросу.

  • Кнопка будет отображаться только для пользователей Telegram.
  • Кнопке можно задать своё название (например, «Отправить номер»).

Шаг 3. Настройте ввод

В блоке открытого вопроса появится настройка «Разрешить ручной ввод номера». 

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

Рекомендуем запретить ручной ввод, если вам важно получать подтвержденный номер Telegram-пользователя.

Шаг 4. Протестируйте настройки

Запустите бота сами, откройте Telegram, пройдите до блока с кнопкой, нажмите ее и убедитесь, что контакт сохраняется.

Где посмотреть сохраненный номер пользователя из Telegram-бота?

Номер телефона, полученный через кнопку-контакт, можно посмотреть:

  • В карточке пользователя в личном кабинете.
  • В отчетах и аналитике — номер будет отмечен как [Telegram] Подтвержденный номер телефона.
  • В CRM, например amoCRM, если настроена интеграция.

Готово! Теперь вы можете легко и точно собирать номера телефонов пользователей в Telegram.

Примечание: старые кнопки-контакт, добавленные раньше вручную, продолжают работать, но редактировать или добавлять новые через обычные сообщения уже нельзя.

Протестируйте кнопку-контакт в нашем визуальном редакторе чат-ботов — 14 дней бесплатно.