Перейти к основному содержимому

InputPhoneNumber

Действие InputPhoneNumber позволяет боту запросить у пользователя номер телефона и сохранить его в переменную (поддерживаются только российские номера).

Параметры

ПараметрТипОписаниеОбязательный
promptСтрокаСообщение, которым бот должен запросить номер.
Если вы хотите использовать в сообщении HTML-разметку, оставьте этот параметр пустым (prompt =) и заполните параметр html.
Да
varNameСтрокаИмя переменной. Введенный пользователем номер будет сохранен в $session.<varName>.
Используйте символы Aa–Zz, _, 0–9. Первым символом в имени должна быть буква. Нельзя использовать зарезервированные слова JavaScript.
Да
htmlСтрокаСообщение, которым бот должен запросить номер, с использованием HTML-разметки.
Если вы не хотите использовать HTML-разметку, вы можете не указывать этот параметр и использовать только prompt.
Нет
htmlEnabledЛогическийЕсли значение параметра true, в сообщении бота будет отправлено значение параметра html, а в сообщении об ошибке — failureMessageHtml.
Если параметр не указан или установлен в false, будут использованы значение prompt и failureMessage соответственно.
Нет
failureMessageМассив строкСписок сообщений об ошибке.
Бот случайно выберет и отправит одно из этих сообщений, если пользователь введет некорректный номер телефона.
Нет
failureMessageHtmlМассив строкСписок сообщений об ошибке с использованием HTML-разметки.Нет
thenСтрокаСтейт, в который перейдет диалог, если сценарий тега будет выполнен без ошибок.Нет
actionsМассив объектовКнопки, которые будут отправлены вместе с запросом. Укажите значение в формате:
actions =
  [{
    «buttons»: [{
      «name»: «Текст кнопки»,
      «transition»: «/Путь до стейта»
    }],
    «type»: «buttons»
  }]
Нет

Использование в сценарии

state: Reminder
InputPhoneNumber:
prompt = Я могу отправить вам SMS-сообщение с подробностями визита. Только скажите ваш телефон.
failureMessage = ["Не могли бы вы ввести номер еще раз?", "Пожалуйста, назовите корректный номер телефона."]
varName = phoneNumber
then = /Reminder/Send

state: Send
Sms:
text = Терапевт Иванов Иван Иванович будет ждать вас завтра в 12:00.
destination = {{$session.phoneNumber.slice(1)}}
okState = /Reminder/Send/Success
errorState = /Reminder/Send/Failure

state: Success
a: Отправил вам сообщение на номер {{$session.phoneNumber}}!

state: Failure
a: Извините, у меня не получилось отправить SMS.