Flash call — звонки для авторизации, API

Методы для совершения звонков:

1. Метод Call 2fa authorization

   Post /api/protected/api/auth/call_2fa в разделе «Интеграции» → вкладка «Методы API» → меню справа «Платные методы» → «Auth» → «Authorization methods».

   

   Метод позволяет совершить звонок с ПОДКЛЮЧЕННОГО клиентом номера на любой другой номер. Звонок после поднятия трубки сразу будет сброшен, звонок будет бесплатный, но сам вызов метода стоит 1 копейку.

   Результат выполнения из раздела «Логи»:

   Тип события: Call 2fa authorization
   
   Время события: 21.05.2026, 09:14:22
   
   Данные события:
   
   success: 1
   

2. Метод Flash Call authorization

   Post /api/protected/api/auth/flashcall в разделе «Интеграции» → вкладка «Методы API» → меню справа «Платные методы» → «Auth» → «Authorization methods».

   

   Метод позволяет совершить звонок для идентификации. Клиенту никаких номеров подключать для этого не нужно, звонки идут с наших номеров. Звонок после поднятия трубки сразу будет сброшен, звонок будет бесплатный, но сам вызов метода стоит от 15 копеек, если он происходит с российского номера и от 65 копеек, если он происходит с казахского номера. Мы автоматически звоним на российский номер с российского номера и на казахский номер с казахского номера, никак дополнительных настроек не требуется. Метод связывает запрос API с конкретным звонком с помощью верификационного кода, о нем будет сказано после описания параметров метода.

Ответ на запрос:

{
  "ok":true,
  "result": {
    "login_did":"79587654321",
    "country_id":643,
    "verification_call_uuid":"5beaad6688f7_133322",
    "account_id":133322,
    "code":"1234"
  }
}

Результат выполнения из раздела «Логи»:

Тип события: Flash Call

Время события: 21.05.2026, 11:06:21

Данные события:

linkedid: "213-1779350771.519929"
stop_time: "2026-05-21T08:06:15.767351Z"
apiRaws:
[],
q931_status: 17
number: 79587654321
final_status: "NO ANSWER"
sip_ip: "10.251.104.111"
sip_call_hash_id: "213-1779350771.519933"
uniqueid: "213-1779350771.519933"
verification_call_uuid: "5beaad6688f7_133322"
extra_info_id:
{
autodial_uuid: "137b712cc4e6_133322"
},
object_type: "pstn"
sip_port: 5060
eventType: "FlashCall"
server_id: 36
call_id: "18890a6d2e130f4306722a7b09373af1@10.251.103.113"
call_leg_id: 1068540
accountId: 133322
vpbx_id: 0
start_time: "2026-05-21T08:06:11.506349Z"
account_id: 119585
orig: false
call4raw:
{
marketplace_id: 1
mob: true
is_tech_trunk: false
prefix: 0
is_dst_number_ported: false
location_id: 1
nnp_filter_orig_ids:
[
325
],
package_credit: 0
nnp_own_operator_id: 6720
connect_time: 1779350771000000
subaccount_id: 0
open_number_plan: false
id: 1650637824
pricelist_id: 0
trunk_settings_stats_id: 0
nnp_region_id: 54
nnp_number_range_id: 2100998
stats_nnp_package_pricelist_minute_id: 0
nnp_own_region_id: 6
nnp_pricelist_filter_b_id: 58784
package_time: 0
dst_number: 79587654321
is_src_number_ported: false
geo_operator_id: 5010465
hash: "e1eae727-1cd0-210c-8ebd-5aa0c270f5fb"
disconnect_cause: 17
nnp_is_mob: true
interconnect_rate: 0
number_service_id: 2396468
numA: 73451234567
our: true
cdr_id: 793143958
numB: 79587654321
nnp_own_city_id: 7345
geo_id: 7474
src_number: 73451234567
nnp_pricelist_id: 991
geo_mob: true
is_include_vat: true
nnp_own_is_mobile: false
nnp_operator_id: 6720
nnp_rdr_count: 0
signalling_call_id: "68a243e2-3042-29a5-15df-80709a2f0d40"
stub_worked: false
nnp_rdr_ndc: 0
nnp_filter_orig_id: 0
interconnect_cost: 0
account_id: 119995
orig: true
account_tariff_light_id: 0
nnp_own_is_mob: false
operator_id: 0
destination_id: 1
is_internal_trunk: false
mcc: 0
tax_rate: 0
pbx_id: 512
tax_cost: 0
nnp_rdr_city_id: 0
trunk_group_id: 0
nnp_pricelist_filter_a_id: 5484
trunk_service_id: 0
nnp_ndc: 958
server_id: 12
nnp_own_number_range_id: 1221086
hub_id: 2
nnp_own_country_code: 643
nnp_original_operator_id: 0
number_ported: false
nnp_filter_term_id: 0
nnp_rdr_country_prefix: 0
leg_type: 1
nnp_rdr_region_id: 0
nnp_city_id: 115125
weak_match: false
nnp_country_code: 643
nnp_package_minute_id: 0
nnp_rdr_operator_id: 0
session_time: 0
sim_imsi_profile_id: 0
peer_id: 1650637825
nnp_pricelist_location_id: 19817
rate: 0
nnp_filter_term_ids:
[
330
],
nnp_own_ndc: 345
stats_nnp_package_minute_id: 0
call_type: 0
cost: 0
mnc: 0
nnp_own_country_prefix: 7
mcn_callid: "006a0ebc-f300-8000-7eef-ad5015c3d062"
nnp_country_prefix: 7
pdd: 0
billed_time: 0
nnp_package_pricelist_id: 17560
trunk_id: 2329
account_version: 5
nnp_rdr_country_code: 0
nnp_package_price_id: 0
nnp_rdr_is_mob: false
nnp_rdr_number_range_id: 0
},
call_id_md5: "68a243e2-3042-29a5-15df-80709a2f0d40"
channame: "SIP/caosips11-0000abed"
last_linked_id: "213-1779350771.519930"
hangup_cause: ""
did: 73451234567

  ⚠️Внимание!| is_with_redirect — включена ли на номере переадрессация (работает только на номерах MCNtelecom).
  |:-|:-|

Чтобы получать данные о звонке, нужно в разделе «Интеграции» подключить веб-хук «Flash call» и тогда на указанный URL будет приходить информация о звонке. В данных о звонке верификационный код, связывающий его с конкретным вызовом API можно по параметру “verification_call_uuid”: “96956ce84a4a_135722”.

Callback — статусы верификационного звонка

• Отвеченный звонок «q931_status»: 16, «final_status»: «ANSWERED»
• Занято «q931_status»: 17, «final_status»: «NO ANSWER»
• Неотвеченный звонок «q931_status»: 16, «final_status»: «NO ANSWER»
• Не прохождении вызова в системе окс7, вызов отклонил встречный оператор «q931_status»: 31

Все прочие коды «q931_status», отличные от 31, 16 или 17 — номер недоступен.

Создание веб-хука для получения информации о звонке

Для того, чтобы получить на URL информацию о звонке (CDR) в привязке к вызову API, необходимо в разделе «Интеграции» → «Веб-хуки» создать подписку на событие, следующий Веб-хук (пример заполнения):

В поле «Тело запроса» указываются внутри массива JSON список переменных, которые будут передаваться на URL. Просмотр событий также доступен в разделе «Мониторинг».

Была ли эта статья полезной

Да, полезнаНет, не полезна