API- Mi az hogy WebHooks

WebHooks – harmadik féltől származó alkalmazások értesítései, melyek az MCNtelecom Virtuális alközpontjában vagy Telefonszolgáltatásban történt események küldésével jöttek. Például értesítés bejövő hívásról és az hívó fél ügyfélkártyájának beemelése a CRM rendszerben. WebHooks segítségével az ügyfél információkat kaphat a bejövő a kimenő vagy a nem fogadott hívásokról.

A hívás közben a szerver POST-kérést küld az URL-ben megadott címre. Figyelembe kell venni, hogy bejövő hívás esetén a WebHook pontosan abban a pillanatban van elküldve, amikor a hívás közvetlenül a SIP azonosítóra érkezik a hívás.

Megjegyzés:

Az adatok  JSON formátumban vannak továbbítva az ügyfélnek HTTP csatornán keresztül “POST” kérelemben közvetlenül a  kérelem tárgyában (raw body) JSON objektumként.

Az ügyfélnek küldött információk:

WebHooks Virtuális alközpont:

Belső előfizetőre érkező bejövő hívás kezdete:
{
"event_type":"onInCallingStart", // egy olyan esemény típus, mely jelzi a virtuális

alközpont belső előfizetője felé a bejövő hívás kezdetét
"abon":"108", // a VPBX belső előfizetőjének a száma (melléke) , amely fogadja a hívást "did":"0614900999", // hívó fél telefonszáma
"secret":"SecretToken", // titkosított token
"account_id":10123 // MCNtelecom ügyfélazonosító száma }

Előfizető bejövő hívásának a vége:
{
"event_type":"onInCallingEnd", // egy olyan esemény típus, mely jelzi a virtuális

alközpont belső előfizetője felé a bejövő hívás végét
"abon":"108", // a VPBX belső előfizetőjének a száma (melléke) , amely fogadja a hívást
"did":"0614900999", // hívó fél telefonszáma
"secret":"SecretToken", // titkosított token
"account_id":10123 // MCNtelecom ügyfélazonosító száma
}

Kimenő hívás kezdete véletlenszerű telefonszámra:
{
"event_type":"onOutCallingStart", // egy olyan esemény típus, mely jelzi a virtuális alközpont belső előfizetője felé a kimenő hívás kezdetét
"abon":"108", // //a VPBX belső előfizetőjének a száma (melléke) , amely kezdeményezi a kimenő hívást
"did":"0614900999", // hívott fél telefonszáma
"secret":"SecretToken", // titkosított token
"account_id":10123 // MCNtelecom ügyfélazonosító száma }

Kimenő hívás vége véletlenszerű telefonszámra:
{
"event_type":"onOutCallingEnd", // egy olyan esemény típus, mely jelzi a virtuális

alközpont belső előfizetője felé a kimenő hívás végét
"abon":"108", // a VPBX belső előfizetőjének a száma (melléke) , amely kezdeményezi a kimenő hívást

"did":"0614900999", // hívott fél telefonszáma
"secret":"SecretToken", // titkosított token
"account_id":10123 // MCNtelecom ügyfélazonosító száma
}

Elvesztett hívás:
{
"event_type":"onInCallingMissed", // egy olyan esemény típus, mely jelzi a virtuális alközpont belső előfizetője felé érkezett bejövő hívás elvesztett hívás lett.
"abon":"104", // a VPBX belső előfizetőjének a száma (melléke), amely nem fogadta a hívást
"did":"0614900099", // hívó fél telefonszáma
"secret":"SecretToken", // titkosított token
"account_id":10123 // MCNtelecom ügyfélazonosító száma
}

WebHooks Telefonszolgáltatás:

Bejövő hívás kezdete
{
"event_type":"InboundCallStart", // esemény típus, mely jelzi a bejövő hívás kezdetét
"did":"0614900099", // hívó fél telefonszáma
"secret":"SecretToken", // titkosított token
"account_id":10123 // MCNtelecom ügyfélazonosító száma
}

Bejövő hívás vége
{
"event_type":"InboundCallEnd", //a bejövő hívás végét jelző esemény típusa
"did":"0614900099", // hívó fél telefonszáma
"secret":"SecretToken", // titkosított token
"account_id":10123 // MCNtelecom ügyfélazonosító száma
}