{"id":3522,"date":"2026-01-13T13:58:48","date_gmt":"2026-01-13T10:58:48","guid":{"rendered":"https:\/\/docs.unibell.tech\/?page_id=3522"},"modified":"2026-04-09T10:03:52","modified_gmt":"2026-04-09T07:03:52","slug":"call-back-api","status":"publish","type":"page","link":"https:\/\/docs.unibell.tech\/?page_id=3522","title":{"rendered":"Call Back API"},"content":{"rendered":"\n<p>Callback is an authentication method in which the user verifies their identity via a voice call. This method provides an additional level of security, as the code is delivered verbally, making it difficult for attackers to intercept or guess.<\/p>\n\n\n\n<h2 id=\"callback\" class=\"anchor\">Sending a Call Back request<\/h2>\n\n\n\n<p><strong>Request:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>POST api.unibell.ru\/apps\/flash\/calls\/flash<\/code><\/pre>\n\n\n\n<p>Data is passed in the request body:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n   \"reference\": \"e0965a38ef9c72d8156d3a157a8a50d0\",\n   \"sourceAddr\": \"7XXXXXXXXXX\",\n   \"destAddr\": \"7XXXXXXXXXX\",\n   \"code\": \"123456\"   \n}<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Parameter<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>reference (optional parameter)<\/td><td>Request identifier, which will later be returned in the status. Used for tracking requests in the client\u2019s system<\/td><\/tr><tr><td>sourceAddr<\/td><td>Phone number from which the call is made, in e.164 format for the Russian Federation (7XXXXXXXXXX)<br><strong><em>The field must not contain Cyrillic characters<\/em><\/strong><\/td><\/tr><tr><td>destAddr<\/td><td>Client service phone number that the subscriber will call, in e.164 format for the Russian Federation (7XXXXXXXXXX)<\/td><\/tr><tr><td>code<\/td><td>Code that will be spoken during the call<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<div class=\"wp-block-group is-vertical is-layout-flex wp-container-core-group-is-layout-8cf370e7 wp-block-group-is-layout-flex\">\n<p><strong>Response:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n   \"status\": \"ok\",\n   \"requestId\": \"93d91390d7c0b1f8de9d4cd0d7f6ea52\"\n}<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parameter<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>status<\/td><td>Request status<\/td><\/tr><tr><td>requestId<\/td><td>Unique request identifier on the partner\u2019s side<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p><strong>In case of an error in sourceAddr:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n    \"status\": \"invalidDataError\",\n    \"error\": \"Field sourceAddr must not contain Cyrillic\"\n}<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parameter<\/th><th>Type<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td><strong>status<\/strong><\/td><td>string<\/td><td>Request status<\/td><\/tr><tr><td><strong>error<\/strong><\/td><td>string<\/td><td>The sourceAddr field must not contain Cyrillic characters<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>After the request is sent, the subscriber must call the specified client number. If the code is found, the IVR will announce it. Otherwise, the message \u201cYour code was not found\u201d will be played. The code will be available for 5 minutes and will then be deleted if it has not been requested.<\/p>\n\n\n\n<p><\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>Callback is an authentication method in which the user verifies their identity via a voice call. This method provides an additional level of security, as the code is delivered verbally, making it difficult for attackers to intercept or guess. Sending a Call Back request Request: Data is passed in the request body: Parameter Description reference <a href=\"https:\/\/docs.unibell.tech\/?page_id=3522\" class=\"more-link\">&#8230;<span class=\"screen-reader-text\">  Call Back API<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"tpl\/http-content.php","meta":{"footnotes":""},"class_list":["post-3522","page","type-page","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3522","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3522"}],"version-history":[{"count":4,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3522\/revisions"}],"predecessor-version":[{"id":3602,"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=\/wp\/v2\/pages\/3522\/revisions\/3602"}],"wp:attachment":[{"href":"https:\/\/docs.unibell.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3522"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}