# Запрос номера телефона

Просит у человека номер телефона и сохраняет его в данные контакта. Дальше номер можно подставлять в сообщения как `{{ phone }}`.

![Панель настроек блока «Запрос номера телефона»](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/01-messages/_images/request-phone.webp?v=1791781230)

## Настройки

- **«Сообщение о запросе номера»** — текст просьбы, до 1000 символов. Если оставить пустым, бот отправит стандартную просьбу ввести номер в международном формате.
- **«Пропускать блок, если номер уже определен»** — если телефон контакта уже известен, бот ничего не спрашивает и сразу идёт дальше. Включён по умолчанию.
- **«Подтверждать телефон через sms-код»** — бот отправляет на номер код и просит прислать его в чат.
- **«SMS провайдер»** — сервис, который отправит код: «Sms.ru (sms)», «Sms.ru (call)», «SMS.to» или «SMSala». Поле появляется, когда включено подтверждение. Выбранный провайдер должен быть подключён в разделе интеграций бота.
- **«Название кнопки»** — подпись кнопки, которой человек делится номером, до 30 символов. Если оставить пустым, кнопка будет называться «Отправить номер».

## Выходы

- «Продолжить» — номер получен, а при включённом подтверждении — ещё и подтверждён кодом. По этому же выходу бот идёт, когда блок пропущен.

## Особенности

- В Telegram и MAX под просьбой появляется кнопка — человек отправляет номер одним нажатием. Во ВКонтакте, Viber и чате на сайте человек вводит номер сам.
- Номер можно написать с «+», пробелами, скобками и дефисами; в нём должно быть от 10 до 16 цифр. Если ответ не похож на номер, бот повторит просьбу.
- С подтверждением бот отправляет код и ждёт его в чате. Код действует 3 минуты. Под сообщением есть кнопка «Назад» — она возвращает к вводу номера. С провайдером «Sms.ru (call)» вместо SMS человеку поступает звонок, а кодом служат последние 4 цифры номера, с которого звонили.
- Один контакт может запросить не больше 10 кодов в час.

> [!WARNING]
> Если включено подтверждение, а провайдер не подключён, человек вместо просьбы получит сообщение о том, что нужно подключить SMS-провайдера. Проверьте блок в окне «Проверка бота» перед запуском.