WebHooks - čo to je

WebHooks –je upozornenie aplikácií tretích strán o udalostiach, ktoré sa vyskytli v telefónnej službe alebo vo virtuálnej ústredni spoločnosti MCN Telecom zaslaním upozornení. Napríklad upozornenie na prichádzajúci hovor s cieľom získať kartu volajúceho zákazníka v systéme CRM.
Pomocou WebHooks môže klient prijímať informácie o prichádzajúcom, odchádzajúcom alebo o neprijatom hovore.

Počas hovoru server pošle požiadavku POST na adresu uvedenú v URL. Je potrebné zapamätať  že pri prichádzajúcom hovore je WebHook odoslaný presne vtedy, keď hovor prichádza priamo na  SIP účet.

Poznámka:

Dáta sa prenášajú ku klientovi vo formáte JSON pomocou HTTP v požiadavke POST, priamo v tele žiadosti (raw body) ako objekt JSON.

Informácie zasielané klientovi::

WebHooks Virtuálna ústredňa:

Prichádzajúci hovor na účastníka:

{

"event_type":"onInCallingStart", //typ udalosti signalizujúc začiatok prichádzajúceho hovoru účastníkovi Virtuálnej ústredni

"abon":"108", // číslo (klapka) účastníka, ktorý prijíma hovor

"did":"0222202999", // číslo volajúceho

"secret":"SecretToken", // tajný token

"account_id":10123 // zákaznícky účet MCN Telecom

}

Koniec prichádzajúceho hovoru na účastníka

{

"event_type":"onInCallingEnd", // typ signalizácie udalosti o koniec prichádzajúceho hovoru účastníkovi Virtuálnej ústredni

"abon":"108", // číslo (klapka) účastníka, ktorý prijíma hovor

"did":"0222202999", // číslo volajúceho

"secret":"SecretToken", // tajný token

"account_id":10123 // zákaznícky účet MCN Telecom

}

Začiatok odchádzajúceho hovoru na ľubovoľné číslo

{

"event_type":"onOutCallingStart", //typ signalizácie udalosti o začiatok odchádzajúceho hovoru od účastníka Virtuálnej ústredni

"abon":"108", // číslo (klapka) účastníka, ktorý prijíma hovor

"did":"0222202999", // volané číslo

"secret":"SecretToken", // tajný token

"account_id":10123 // лицевой счет клиента MCN Telecom

}

Koniec  odchádzajúceho hovoru na ľubovoľné číslo

{

"event_type":"onOutCallingEnd", // typ signalizácie udalosti o koniec odchádzajúceho hovoru od účastníka Virtuálnej ústredni

"abon":"108", //  číslo (klapka) účastníka, ktorý prijíma hovor

"did":"0222202999", // volané číslo

"secret":"SecretToken", // tajný token

"account_id":10123 // zákaznícky účet MCN Telecom

}

Neprijatý hovor

{

"event_type":"onInCallingMissed", // typ signalizácie udalosti, že prichádzajúci hovor na účastníka Virtuálnej ústredni bol zmeškaný

"abon":"104", //  číslo (klapka) účastníka, ktorý neodpovedal na hovor

"did":"74951059995", // číslo volajúceho

"secret":"SecretToken", // tajný token

"account_id":10123 // zákaznícky účet MCN Telecom

}

WebHooks Тelefónická služba:

Prichádzajúci hovor

{

"event_type":"InboundCallStart", // typ signalizácie udalosti o prichádzajúcom hovore

"did":"0222202999", // číslo volajúceho

"secret":"SecretToken", // tajný token

"account_id":10123 // zákaznícky účet MCN Telecom

}

Koniec prichádzajúceho hovoru

{

"event_type":"InboundCallEnd", // typ signalizácie udalosti o koniec prichádzajúceho hovoru

"did":"0222202999", // volané číslo

"secret":"SecretToken", // tajný token

"account_id":10123 // zákaznícky účet MCN Telecom

}