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ő