¶ Flash Call — сервис аутентификации по звонку
¶ Виды услуги
-
Голосовой Flash Call — это аутентификация номера с проговариванием кода в звонке от служебного номера
-
Обратный Flash Call — это аутентификация номера звонком от пользователя на служебный номер
¶ Голосовой Flash Call
Пользователь указывает свой номер телефона, ему поступает звонок, который нужно принять, прослушать код авторизации и ввести его на сайте или в приложении.
¶ Как воспользоваться
1. Включите доступ к API в личном кабинете в разделе [Тариф] / [Активный тариф]
2. Получите токен в личном кабинете в разделе [Еще] / [Разаработчикам] / [Доступ к API]
3. Создайте аккаунт Flash Call с помощью метода POST api/v1/flash-call
4. Получите список доступных пакетов в методе GET api/v1/flash-call/proposals — необходимо выбирать из тех, что с параметром flashcall_ivr = 1
5. Подключите выбранный пакет на созданный аккаунт методом PUT api/v1/flash-call/proposals/{accountId}
6. Отправьте Flash-вызов с помощью метода POST api/v1/flash-call/send и система сгенерирует пин-код
- но если Вы хотите задать пин-код сами, добавьте поле
pinс определенной комбинацией
7. Проверьте пин-код, введённый Вашим клиентом с помощью метода POST api/v1/flash-call/check
8. Для изменений настроек Flash Call воспользуйтесь методом POST api/v1/flash-call/settings — можно увеличить лимиты, а также настроить получение оператора и пин-кода в ответе.
9. Для отправки Flash Call на иностранные номера включите направление для исходящих вызовов
Внимание, Flash Call на направление МТС по умолчанию ОТКЛЮЧЕНЫ. Чтобы включить, нужно активировать оператора МТС в настройках POST api/v1/flash-call/settings, добавив объект operators:
{ mts: { allowed: true } }
¶ Сколько стоит
Доступны пакеты Flash-вызовов разного размера, не включая звонки на МТС:
| Пакет | Абон. плата | Сверх пакета | Стоимость на МТС | Международные |
|---|---|---|---|---|
| 100 шт. | 0 ₽ / мес. | 0,55 ₽ / запрос | 1,60 ₽ / запрос |  прайс-лист |
| 1 000 шт. | 500 ₽ / мес. | 0,52 ₽ / запрос | 1,60 ₽ / запрос | прайс-лист |
| 5 000 шт. | 2 250 ₽ / мес. | 0,48 ₽ / запрос | 1,60 ₽ / запрос | прайс-лист |
| 10 000 шт. | 4 000 ₽ / мес. | 0,45 ₽ / запрос | 1,60 ₽ / запрос | прайс-лист |
| 50 000 шт. | 17 500 ₽ / мес. | 0,40 ₽ / запрос | 1,60 ₽ / запрос | прайс-лист |
| 100 000 шт. | 29 000 ₽ / мес. | 0,32 ₽ / запрос | 1,60 ₽ / запрос | прайс-лист |
Flash-вызовы на оператора МТС не входят в пакеты!
Стоимость одного Flash-вызова на МТС — 1,6 ₽
Иностранные направления тарифицируются посекундно и не входят в пакеты:
Прайс-лист на международные направления
¶ Обратный Flash Call
Пользователю показывается номер телефона, на который необходимо позвонить, он звонит и тем самым проходит аутентификацию.
¶ Как воспользоваться
1. Включите доступ к API в личном кабинете в разделе [Тариф] / [Активный тариф]
2. Получите токен в личном кабинете в разделе [Еще] / [Разаработчикам] / [Доступ к API]
3. Создайте аккаунт Flash Call с помощью метода POST api/v1/flash-call
4. Получите список пакетов с помощью метода GET api/v1/flash-call/proposals
5. Подключите выбранный пакет на созданный аккаунт методом PUT api/v1/flash-call/proposals/{accountId}
6. Используйте метод обратного звонка POST api/v1/flash-call/call-to-auth с помощью Вашего обработчика, на который придёт вебхук с данными:
phone— номер, на который должен позвонить клиентkey— ключ для проверки
7. Ваш клиент звонит на отправленный в вебхуке номер и проходит авторизацию
¶ Сколько стоит
Доступны пакеты разного размера:
| Пакет | Абон. плата | Сверх пакета |
|---|---|---|
| 100 шт. | 0 ₽ / мес. | 0,45 ₽ / запрос |
| 1 000 шт. | 400 ₽ / мес. | 0,42 ₽ / запрос |
| 5 000 шт. | 1 750 ₽ / мес. | 0,38 ₽ / запрос |
| 10 000 шт. | 3 000 ₽ / мес. | 0,35 ₽ / запрос |
| 50 000 шт. | 12 500 ₽ / мес. | 0,30 ₽ / запрос |
| 100 000 шт. | 19 000 ₽ / мес. | 0,22 ₽ / запрос |
¶ Важная информация
-
Flash Call работает только при положительном балансе личного кабинета
-
Обновление текущего пакета происходит в день подключения в следующем месяце
-
Flash Call на направление МТС по умолчанию ОТКЛЮЧЕНЫ. Чтобы включить, нужно активировать оператора МТС в настройках POST api/v1/flash-call/settings, добавив объект operators: { mts: { allowed: true} }
¶ Лимиты настройки аккаунта
Настройки можно получить методом GET api/v1/flash-call/settings и обновить методом POST api/v1/flash-call/settings
| Описание | По умолчанию | Мин. | Макс. |
|---|---|---|---|
| лимит с одного аккаунта в день | 3 000 | 1 | 300 000 |
| лимит с одного аккаунта в час | 500 | 1 | 50 000 |
| лимит на один номер в день | 10 | 1 | 30 |
| лимит на один номер в час | 5 | 1 | 15 |
| время жизни токена | 30 | 30 | 300 |
лимит попыток с одним токеном  |
3 | 1 | 3 |
токен выдается на каждый запрос уникального запроса
¶ Недоступные направления
Вы можете отправить вызов на любой мобильный номер за исколючением нескольких направлений:
| Код направления | Страна |
|---|---|
52 |
Мексика |
676 |
Тонго |
678 |
Вануату |
685 |
Западное Самоа |
675 |
Папуа Новая Гвинея |
674 |
Науру |
597 |
Суринам |
686 |
Кирибати |
509 |
Гаити |
683 |
Острава Ниуэ |
228 |
Того |
687 |
Новая Каледония |
682 |
Острова Кука |
690 |
Токелау |
220 |
Гамбия |
¶ Обратная связь
Пожелания, предложения по услуге, а также вопросы Вы можете отправить:
- в службу поддержки в разделе [Помощь] / [Обращения]
- или на электронный адрес support@plusofon.ru
