Современный метод регистрации пользователя по e-mail и паролю становится вчерашним днем. Теперь компаниям все чаще нужно верифицировать своего клиента еще и по номеру телефона.
Чаще всего это нужно для того, чтобы идентифицировать личность пользователя. Классическая авторизация по СМС имеет две проблемы - она очень дорогая для компании и обходится хитрыми пользователями с помощью временного виртуального номера.
По этой причине многие переходят на верификацию пользователя посредством звонка на номер. Работает он следующим образом - пользователю звонит робот и называет код, который нужно ввести на сайте.
Реализовать это в телефонии Novofon можно с помощью метода API из нашего нового Call API. И делается это следующим образом:
В открытом API есть метод start.informer_call
URL, по которому отправлять запрос: https://callapi-jsonrpc.novofon.ru/v4.0
Запросы к API выполняются всегда с помощью метода POST
Параметры метода, которые вам понадобятся для работы:
- access_token - ваш ключ аутентификации, который вы можете получить в личном кабинете в разделе Пользователи АТС - Администратор - редактирование пользователя - API, в этом разделе активируйте использование ключей API и затем вам нужно сгенерировать Secret - именно он используется в этом параметре.
- virtual_phone_number - Виртуальный номер, арендуемый вами. Формат номера должен соответствовать международному стандарту E.164 (например, 74951270777). Всегда используется в качестве номера звонящего при звонке на номер, указанный в параметре contact. Виртуальные номера можно получить с помощью REST API метода из нашего Data API get.virtual_numbers
- contact - Номер абонента на который совершается вызов. Формат номера должен соответствовать международному стандарту E.164 (например, 79091234567).
- contact_message - определяет параметры сообщения, которое необходимо проиграть абоненту заданному в параметре contact
- type - определяет тип сообщения. media - файл или tts - текст для услуги синтеза речи Text-to-Speech
- value - если поле type имеет значение media, то в качестве значения принимается идентификатор файла для проигрывания. Файл для проигрывания может быть системным или пользовательским. Идентификатор файла для проигрывания можно получить с помощью метода DATA API - Получение списка медиафайлов
Пример запроса в формате JSON:
{
"jsonrpc": "2.0",
"id": "req1",
"method": "start.informer_call",
"params": {
"access_token": "2fRN4g217ca0b4224a67988aff3e584f91964a692045415f36fa66146f5a3c1ae1f6093d",
"virtual_phone_number": "74951270777",
"contact": "79260000000",
"contact_message": {
"type": "tts",
"value": "Добрый день. Ваш код авторизации 0 1 2 3 4 5. Повторяю 0 1 2 3 4 5"
}
}
}
Пример ответа:
{
"jsonrpc": "2.0",
"id": "req1",
"result": {
"data": {
"call_session_id": 1238694
}
}
}
Подробнее с нашей документацией по работе с Call API вы можете ознакомиться здесь: https://novofon.github.io/call_api/
С Data API здесь: https://novofon.github.io/data_api/
Что потребуется для начала работы?
Первое, что вам нужно сделать - зарегистрироваться в Novofon https://novofon.com/sign-up/ и пройти базовые 4 шага для использования сервиса:
- Подтвердить контактный номер
- Подписать договор (для физического лица необходимо иметь УКЭП).
- Пополнить счет.
- Подключить виртуальный номер.
Идентификация пользователя постепенно становится одной из главных задач многих сервисов. И поиск способов по автоматизации и снижению расходов на это волнует многие компании. Теперь вы знаете на один метод больше.