Hívásindítási módszerek

1. POST metódus  /account/{account_id}/call_for_2fa fájlt az „API” > „Telefonszolgáltatás” szakaszban.

A metódus lehetővé teszi, hogy a CSATLAKOZTATOTT számról bármely másik számra hívást kezdeményezzen. A hívásfogadást követően a hívás azonnal megszakad, a hívás ingyenes, de maga a metódushívás pár forintba kerül.

Példa: 

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Bearer <ТОКЕN>' 'https://api.mcntele.com/v2/rest/account/12345678/call_for_2fa?caller_did=3614900001&login_did=3617777777' 

Metódus paraméterei:

account_id - Az ügyfél számlája. Ezen az ügyfélszámlán kell egy szám, ahonnan hívjuk, és arról terhelve a szolgáltatás díja.

caller_did - telefonszám, amely az ügyfélszámlához, amelyről a hívást kezdeményezni fogják.

login_did - telefonszám amelyre a hívást kezdeményezve lesz.

A POST  /account/{account_id}/flash_call metódus az „API” > „Telefonszolgáltatás kezelése” szekcióban

A módszer lehetővé teszi azonosítás céljából hívás kezdeményezését. A hívások a mi számunkról érkeznek. A hívás a telefon felvétele után azonnal megszakad, a hívás ingyenes, de maga a metódusos hívás pár forintba kerül, ha MCNtelecom-os számról történik. Alapértelmezés szerint szlovák számról hívunk, de ez a beállításokkal szabályozható. A metódus egy API kérést egy adott híváshoz társít egy ellenőrző kód segítségével, amelyről a metódus paramétereinek leírása után lesz szó.

Példa:

curl -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'Authorization: Bearer <ТОКЕН>' 'https://api.mcntele.com/v2/rest/account/12345678/flash_call?login_did=361777777'

Metódus paraméterei:

account_id - Az ügyfél számlája. Ezen az ügyfélszámlán kell egy szám, ahonnan hívjuk, és arról terhelve a szolgáltatás díja. login_did - telefonszám amelyre a hívást kezdeményezve lesz. 

code - megerősítő kód. 4 számjegy, amelyel végződik a telefonszám, amelyről a hívást kezdeményezték, HA ez a mező ki van töltve. 
Ha a mező nincs kitöltve, a rendszer egy véletlen számról hívást kezdeményez.

country_id - az ország kódja. Ha a mező üres - orosz számról orosz számot hívunk, szlovák számról pedig bármely más ország számát. Ha az érték 703-ra van beállítva, akkor szlovák számról, ha 643-ra van beállítva - orosz számról indítanak hívást. A mező összes többi értékénél a hívás egy orosz számról történik.

A metódus sikeres végrehajtása után jön a ***verification_call_uuid*** paraméter - az ellenőrző kód. Így néz ki (példa) "fa278be48dc2_117793", ahol a kód első része a "_" szimbólum előtt a hívásazonosító, a "_" szimbólum utáni számok pedig az ügyfélszámlaszámot jelentik. A kód a hívásadatok (CDR) egy adott API-híváshoz való társításához szükséges. A hívás adatainak fogadásához csatlakoznia kell a „Flash call” webhookot az „Integráció” részben, majd a hívás információi elküldésre kerülnek a megadott URL-re. A hívásadatokban egy adott API-híváshoz társító ellenőrző kód a "verification_call_uuid" paraméterben található: "fa278be48dc2_117793"..

Visszahívás – a hitelesítési hívás állapotok 

Fogadott hívás
«q931_status»: 16,
«final_status»: «ANSWERED»

Foglalt
«q931_status»: 17,
«final_status»: «NO ANSWER»

Nem válaszolt
«q931_status»: 16,
«final_status»: «NO ANSWER»

Nem ment át a hívás az ox7 rendszerben, a hívást a másik operátor elutasította
«q931_status»: 31

Az összes többi "q931_status" kód a 31, 16 vagy 17 kivételével – a szám nem érhető el.

Webhook létrehozása a hívásokkal kapcsolatos információk lekéréshez

Annak érdekében, hogy információt kapjon az URL-címen az API-hívással kapcsolatos hívásról (CDR), létre kell hoznia egy esemény-előfizetést az „Integráció -> Webhookok" részben, a következő Webhook segítségével (kitöltési példa):

A „Request Body” mező a JSON belüli változók listáját tartalmazza, amelyeket a rendszer az URL-nek továbbít. Az események megtekintése a „Monitoring” részben is elérhető