¶ Flash Call — сервис аутентификации по звонку
¶ Виды услуги
-
Flash Call с этикеткой — аутентификация номера с добавлением этикетки и МАВ для лучшего прохождения
(сервис звонит вашему клиенту) -
Голосовой Flash Call — аутентификация номера с проговариванием кода в звонке от служебного номера
(сервис звонит вашему клиенту) -
Обратный Flash Call — аутентификация номера звонком от пользователя на служебный номер
(ваш клиенту звонит сервису)
¶ Flash Call с этикеткой
Вызовы всегда приходят с этикеткой «Плюсофон: ИТ» («Plusofon: IT»), вне зависимости от того, какие этикетки вы подключали на свои номера.
Персональная этикетка с названием компании для Flash Call — отдельный вариант подключения с индивидуальными условиями.
Пользователь указывает свой номер телефона, ему поступает звонок с этикеткой «Плюсофон: ИТ», который нужно принять, прослушать код авторизации и ввести его на сайте или в приложении. Flash-вызовы отправляются с подключенной этикеткой и маркировкой массовых или автоматизированных вызовов (МАВ), что улучшает дозвон до пользователя.
Стандартный метод отправки Flash Call выбирает исходящий номер из особого пула номеров специально выделенных для сервиса. Подключенные номера из вашего ЛК при этом не используются.
¶ Сколько стоит
| Пакет Flash-вызовов | Абонентская плата | Сверх пакета |
|---|---|---|
| 0 шт. | 0 ₽/мес. | 1,60 ₽/запрос |
| 1 000 шт. | 1 490 ₽/мес. | 1,52 ₽/запрос |
| 5 000 шт. | 6 950 ₽/мес. | 1,42 ₽/запрос |
| 10 000 шт. | 12 900 ₽/мес. | 1,32 ₽/запрос |
| 50 000 шт. | 59 500 ₽/мес. | 1,22 ₽/запрос |
| 100 000 шт. | 114 000 ₽/мес. | 1,17 ₽/запрос |
Иностранные направления тарифицируются посекундно и не входят в пакеты. Уточняйте активные направления и цены в поддержке через личный кабинет Помощь → Обращения или напишите на электронный адрес support@plusofon.ru
¶ Как воспользоваться
1. Создайте аккаунт Flash Call:
Перейдите в раздел Flash call и нажмите кнопку Добавить.
Воспользуйтесь методом "POST api/v1/flash-call".
(для этого необходим API-токен из раздела Еще → Разработчикам → Доступ к API)
2. Подключите пакет Flash-вызовов:
В строке созданного аккаунта нажмите кнопку «» и выберите подходящий пакет:
Подключение номеров и оформление отдельной этикетки на компанию для текущего сценария не требуются, Flash-вызовы всегда приходят с этикеткой «Плюсофон: ИТ» («Plusofon: IT»).
Получите список доступных пакетов в методе "GET api/v1/flash-call/proposals" — необходимо выбирать из тех, что с параметром "flascall_labeled" = 1.
Подключите выбранный пакет на созданный аккаунт методом "PUT api/v1/flash-call/proposals/{account_id}".
Подключение номеров и оформление отдельной этикетки на компанию для текущего сценария не требуются, Flash-вызовы всегда приходят с этикеткой «Плюсофон: ИТ» («Plusofon: IT»).
3. Настройте на своём сайте механизм ввода номера вашего клиента, на который будет звонить сервис. Например, как здесь: lk.plusofon.ru/registration на вкладке По звонку.
4. Настройте отправку Flash-вызова:
Воспользуйтесь методом "POST api/v1/flash-call/send" и система сгенерирует пин-код.
Если вы хотите задать пин-код самостоятельно, укажите его в параметре
"pin".
Вызовы всегда приходят с этикеткой «Плюсофон: ИТ» («Plusofon: IT»), вне зависимости от того, какие этикетки вы подключали на свои номера.
5. Настройте проверку пин-кода, введённого вашим клиентом:
Воспользуйтесь методом "POST api/v1/flash-call/check"
Flash-вызовы на направление МТС по умолчанию ОТКЛЮЧЕНЫ. Чтобы включить, нужно активировать оператора МТС в настройках методом
"POST api/v1/flash-call/settings", добавив объект
"operators": { "mts": { "allowed": true } }
¶ Дополнительно
1. Посмотрите статистику отправленных Flash-вызовов и остатков в пакете:
Вся информация доступна в разделе Flash call → Статистика:
в разработке
2. Измените лимиты и ограничения:
В разделе Flash call в строке нужного аккаунта нажмите кнопку «»:
Воспользуйтесь методом "POST api/v1/flash-call/settings".
3. Разрешите отправку Flash Call на иностранные номера:
Включите нужное направление (страну) для исходящих вызовов в разделе Настройки связи → Задание направлений (подробнее об этом в статье «Настройка направлений для исходящих вызовов»).
Воспользуйтесь методом "PUT api/v1/direction".
¶ Голосовой Flash Call
Пользователь указывает свой номер телефона, ему поступает звонок, который нужно принять, прослушать код авторизации и ввести его на сайте или в приложении.
Стандартный метод отправки Flash Call выбирает исходящий номер из особого пула номеров специально выделенных для сервиса. Подключенные номера из вашего ЛК при этом не используются.
¶ Сколько стоит
| Пакет Flash-вызовов | Абонентская плата | Сверх пакета | Стоимость на МТС |
|---|---|---|---|
| 100 шт. | 0 ₽/мес. | 0,63 ₽/запрос | 1,90 ₽/запрос |
| 1 000 шт. | 570 ₽/мес. | 0,60 ₽/запрос | 1,90 ₽/запрос |
| 5 000 шт. | 2 700 ₽/мес. | 0,58 ₽/запрос | 1,90 ₽/запрос |
| 10 000 шт. | 5 000 ₽/мес. | 0,54 ₽/запрос | 1,90 ₽/запрос |
| 50 000 шт. | 22 500 ₽/мес. | 0,50 ₽/запрос | 1,90 ₽/запрос |
| 100 000 шт. | 40 000 ₽/мес. | 0,42 ₽/запрос | 1,90 ₽/запрос |
Flash-вызовы на оператора МТС не входят в пакеты!
Стоимость одного Flash-вызова на МТС — 1,9 ₽
Иностранные направления тарифицируются посекундно и не входят в пакеты. Уточняйте активные направления и цены в поддержке через личный кабинет Помощь → Обращения или напишите на электронный адрес support@plusofon.ru
¶ Как воспользоваться
1. Создайте аккаунт Flash Call:
Перейдите в раздел Flash call и нажмите кнопку Добавить.
Воспользуйтесь методом "POST api/v1/flash-call".
(для этого необходим API-токен из раздела Еще → Разработчикам → Доступ к API)
2. Подключите пакет Flash-вызовов:
В строке созданного аккаунта нажмите кнопку «» и выберите подходящий пакет:
Получите список доступных пакетов в методе "GET api/v1/flash-call/proposals" — необходимо выбирать из тех, что с параметром "flashcall_ivr" = 1.
Подключите выбранный пакет на созданный аккаунт методом "PUT api/v1/flash-call/proposals/{account_id}".
3. Настройте на своём сайте механизм ввода номера вашего клиента, на который будет звонить сервис. Например, как здесь: lk.plusofon.ru/registration на вкладке По звонку.
3. Настройте отправку Flash-вызова:
Воспользуйтесь методом "POST api/v1/flash-call/send" и система сгенерирует пин-код.
Если вы хотите задать пин-код самостоятельно, укажите его в параметре
"pin".
4. Настройте проверку пин-кода, введённого вашим клиентом:
Воспользуйтесь методом "POST api/v1/flash-call/check"
Flash-вызовы на направление МТС по умолчанию ОТКЛЮЧЕНЫ. Чтобы включить, нужно активировать оператора МТС в настройках методом
"POST api/v1/flash-call/settings", добавив объект
"operators": { "mts": { "allowed": true } }
¶ Дополнительно
1. Посмотрите статистику отправленных Flash-вызовов и остатков в пакете:
Вся информация доступна в разделе Flash call → Статистика:
в разработке
2. Измените лимиты и ограничения:
В разделе Flash call в строке нужного аккаунта нажмите кнопку «»:
Воспользуйтесь методом "POST api/v1/flash-call/settings".
3. Разрешите отправку Flash Call на иностранные номера:
Включите нужное направление (страну) для исходящих вызовов в разделе Настройки связи → Задание направлений (подробнее об этом в статье «Настройка направлений для исходящих вызовов»).
Воспользуйтесь методом "PUT api/v1/direction".
¶ Обратный Flash Call
Пользователю показывается номер телефона, на который необходимо позвонить, он звонит и тем самым проходит аутентификацию.
¶ Сколько стоит
Доступны пакеты разного размера:
| Пакет обратного Flash Call | Абонентская плата | Сверх пакета |
|---|---|---|
| 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 ₽/запрос |
¶ Как воспользоваться
1. Создайте аккаунт Flash Call:
Перейдите в раздел Flash call и нажмите кнопку Добавить.
Воспользуйтесь методом "POST api/v1/flash-call".
(для этого необходим API-токен из раздела Еще → Разработчикам → Доступ к API)
2. Подключите пакет Flash-вызовов:
В строке созданного аккаунта нажмите кнопку «» и выберите подходящий пакет.
В поле Номер выберите номер для обратного Flash Call:
-
По умолчанию — классический вариант, система сама выдаёт номер телефона из общего пула
-
подключенный номер 8-800 — персональный номер, на который будут звонить ваши клиенты без оплаты со своей стороны (предварительно нужно подключить номер 8-800)
Получите список доступных пакетов в методе "GET api/v1/flash-call/proposals" — необходимо выбирать из тех, что с параметром "flashcall_reverse" = 1.
Подключите выбранный пакет на созданный аккаунт методом "PUT api/v1/flash-call/proposals/{account_id}".
3. Подготовьтесь к приёму вызова от своего клиента:
Используйте метод обратного звонка "POST api/v1/flash-call/call-to-auth" с помощью вашего обработчика, на который придёт вебхук с данными:
-
"phone"— номер, на который должен позвонить клиент -
"key"— ключ для проверки
4. Ваш клиент звонит на отправленный в вебхуке номер.
5. На адрес вашего обработчика поступит вебхук об успешном звонке, на его основе вам нужно авторизовать пользователя.
¶ Дополнительно
1. Посмотрите статистику отправленных Flash-вызовов и остатков в пакете:
Вся информация доступна в разделе Flash call → Статистика:
в разработке
2. Измените лимиты и ограничения:
В разделе Flash Call в строке нужного аккаунта нажмите кнопку «»:
Воспользуйтесь методом "POST api/v1/flash-call/settings".
¶ Настройка лимитов аккаунта
Настройки можно получить методом "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 |
* токен выдается на каждый запрос уникального запроса
¶ Важная информация
-
Flash Call работает только при положительном балансе личного кабинета
-
Обновление текущего пакета происходит в день подключения в следующем месяце
-
Flash-вызовы на направление МТС по умолчанию ОТКЛЮЧЕНЫ. Чтобы включить, нужно активировать оператора МТС в настройках методом
"POST api/v1/flash-call/settings", добавив объект
"operators": { "mts": { "allowed": true} }
¶ Часто задаваемые вопросы
Почему подключенный номер и его этикетка не используются в исходящем Flash Call?
Стандартный исходящий Flash Call использует пул номеров сервиса. Покупка SIP-номера и оформление этикетки не меняют настройки этого сценария.
Как подключить Flash Call с названием моей компании?
Персональная этикетка предлагается при объёме от 800 тысяч звонков в месяц. Обратитесь к менеджеру для согласования условий и порядка подключения.
Что указывать в параметре Client?
Этот параметр всегда 10553, как и указано в документации.
Можно ли воспользоваться Flash сall на тестовом аккаунте?
Нет, создание аккаунта на тестовом тарифе невозможно, а после заключения договора доступен бесплатный пакет на 100 Flash-вызовов для проверки работы.
Расходуется ли пакет обратного Flash call если на номер не позвонили?
Нет, списание происходит только после дозвона до предоставленного номера.
На каком языке говорит робот при вводе номера другой страны?
У нас нет локализации под конкретную страну, все вызовы на любой номер идут с проговариванием кода на русском языке.
Какой токен использовать для отправки Flash-вызова? (ошибка "error find flashcall account: Flashcall account not found")
Для работы Flash Сall необходимо использовать "access_token", который выдаётся при создании аккаунта в личном кабинете или через API.
Какие бывают коды статусов и ошибок в API?
Актуальный список в статье «Коды статусов и ошибок Plusofon API».
Сколько действует подключенный пакет?
Месячный период, начинается и заканчивается в день подключения, обновляется через месяц. Оплата за пакет списываются в начале периода. Остаток звонков не переносится на следующий месяц.
Почему не проходит Flash-вызов на иностранный номер?
По умолчанию вызовы доступны только на номера РФ, для других стран откройте необходимое направление. В пакет они не включены и будут тарифицироваться отдельно. Активные направления уточняйте в поддержке
С какого IP-адреса приходят вебхуки для добавления его в белый список?
Единственный адрес, который используется для Flash Call — 185.54.48.1
Можно ли использовать собственный пин-код?
Да, его можно отправить в параметр "pin".
Как происходит списание за обратный Flash Call на номер 8-800?
Как и при стандартном варианте, после отправки запроса с номером 8-800 списывается одна авторизация из подключенного пакета, за минуты платить не нужно. Для клиента вызов бесплатный.
¶ Обратная связь
Пожелания и предложения по услуге, а также вопросы вы можете отправить:
-
в службу поддержки в разделе Помощь → Обращения
-
или на электронный адрес support@plusofon.ru