¶ Flash Call — сервис аутентификации по звонку
¶ Виды услуги
-
Голосовой Flash Call — это аутентификация номера с проговариванием кода в звонке от служебного номера
-
Обратный Flash Call — это аутентификация номера звонком от пользователя на служебный номер
¶ Голосовой Flash Call
Пользователь указывает свой номер телефона, ему поступает звонок, который нужно принять, прослушать код авторизации и ввести его на сайте или в приложении.
¶ Как воспользоваться
¶ Через ЛК
1. Создайте аккаунт Flash Call в личном кабинете [Flash call] / [Добавить]
2. Нажмите редактировать [
] для подключения пакета Flash Call
Выбор пакета
3. Отправьте Flash-вызов с помощью метода POST api/v1/flash-call/send и система сгенерирует пин-код
- но если Вы хотите задать пин-код сами, добавьте поле
pinс определенной комбинацией
4. Проверьте пин-код, введённый Вашим клиентом с помощью метода POST api/v1/flash-call/check
5. Нажмите настройки [
] созданного аккаунта , чтобы изменить лимиты и ограничения
Пример настроек
6. Для отправки Flash Call на иностранные номера включите направление для исходящих вызовов
7. Статистика отправленных Flash Call и остатков в пакете доступна в личном кабинете [Flash call] / [Статистика]
Пример статистики
¶ Через API
1. Получите токен в личном кабинете в разделе [Еще] / [Разаработчикам] / [Доступ к API]
2. Создайте аккаунт Flash Call с помощью метода POST api/v1/flash-call
3. Получите список доступных пакетов в методе GET api/v1/flash-call/proposals — необходимо выбирать из тех, что с параметром flashcall_ivr = 1
4. Подключите выбранный пакет на созданный аккаунт методом PUT api/v1/flash-call/proposals/{accountId}
5. Отправьте Flash-вызов с помощью метода POST api/v1/flash-call/send и система сгенерирует пин-код
- но если Вы хотите задать пин-код сами, добавьте поле
pinс определенной комбинацией
6. Проверьте пин-код, введённый Вашим клиентом с помощью метода POST api/v1/flash-call/check
7. Для изменений настроек Flash Call воспользуйтесь методом POST api/v1/flash-call/settings — можно увеличить лимиты, а также настроить получение оператора и пин-кода в ответе.
8. Для отправки 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. Создайте аккаунт Flash Call в личном кабинете [Flash call] / [Добавить]
2. Нажмите редактировать [] для подключения обратного пакета Flash Call
Выбор пакета
3. Используйте метод обратного звонка POST api/v1/flash-call/call-to-auth с помощью Вашего обработчика, на который придёт вебхук с данными:
phone— номер, на который должен позвонить клиентkey— ключ для проверки
4. Ваш клиент звонит на отправленный в вебхуке номер и проходит авторизацию
5. Нажмите настройки [] созданного аккаунта , чтобы изменить лимиты и ограничения
Пример настроек
6. Статистика отправленных Flash Call и остатков в пакете доступна в личном кабинете [Flash call] / [Статистика]
Пример статистики
¶ Через API
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 |
токен выдается на каждый запрос уникального запроса
¶ Часто задаваемые вопросы
- Что указывать в поле Client?
- Client неизменяемый, 10553 как и указано в инструкции
- Можно ли воспользоваться Flash сall на тестовом аккауте?
- Нет, создание аккаунта на тестовом тарие невозможно, после заключения договора Вам будет предоставлен бесплатный пакет на 100 Flash call для проверки работы.
- Списывается ли количество из пакета обратного Flash call если на номер не позвонили?
- Нет, списание происходит только после дозвона до предоставленного номера.
- На каком языке говорит робот при вводе номера другой страны?
- У нас нет локализации под конкретную страну, все звонки на любой номер идут с проговариванием кода на русском языке.
- Какой токен использовать для отправки вызова?
Ошибка "error find flashcall account: Flashcall account not found",
- Для работы Flash call необходимо использовать access_token, который выдается при создании аккаунта в личном кабинете или через API
- Какие бывают коды статусов и ошибок в API?
- Актуальный список по ссылке
- Какой период действия подключенного пакета?
- Месячный период. Начинается и заканчивается в день подключения, обновляется через месяц. Оплата за пакет списываются в начале периода.Остаток звонков не переносится на следующий месяц.
- Почему не проходит Flash call на иностранный номер?
- По умолчанию звонки доступны только на номера РФ, для других стран следуйте инструкции и откройте необходимое направление В пакет они не включеы и будут тарифицироваться отдельно.
- С какого IP адреса приходят вебхуки для добавления его в белый список?
- Единственный адрес, который используется для Flash Call - 185.54.48.1
- Можно использовать собстевнный pin код?
- Вы можете использовать желаемую комбинацию пин-кода из 4-х цифр, в параметре pin, метода отправки вызова.
¶ Недоступные направления
Вы можете отправить вызов на любой мобильный номер за исключением нескольких направлений:
| Код направления | Страна |
|---|---|
52 |
Мексика |
676 |
Тонго |
678 |
Вануату |
685 |
Западное Самоа |
675 |
Папуа Новая Гвинея |
674 |
Науру |
597 |
Суринам |
686 |
Кирибати |
509 |
Гаити |
683 |
Острава Ниуэ |
228 |
Того |
687 |
Новая Каледония |
682 |
Острова Кука |
690 |
Токелау |
220 |
Гамбия |
¶ Обратная связь
Пожелания, предложения по услуге, а также вопросы Вы можете отправить:
- в службу поддержки в разделе [Помощь] / [Обращения]
- или на электронный адрес support@plusofon.ru
