Program na stahování nahrávek hovorů

Datum: 14.09.2018

Často se nás ptáte jak z naší ústředny stahovat a archivovat nahrávky hovorů na vašem serveru. Abychom vám tuto činnost ulehčili, připravili jsme pomocný prográmek napsaný v Javascriptu.

Prográmek (skript) je jednoduše použitelný na všech hlavních operačních systémech, ale pro jeho spuštění potřebujete tzv. runtime. To je aplikace, která spuštění skriptu zajistí. Jmenuje se Node.js a je zdarma ke stažení na stránkách https://nodejs.org/en/download/.

Jak skript funguje?

Skript funguje tak, že se mu zadá adresa ústředny a login/heslo k API. Dále se vybere časový úsek, v jakém chcete nahrávky stáhnout.

Po spuštění skriptu vidíte kolik nahrávek se bude stahovat a jak dlouho to asi bude trvat.

Nahrávky se ukládají do lokálního adresáře „download“ a vytvářejí adresářovou strukturu podle roku měsíce a dne. Např. 2018/06/22/nahravka1.mp3

Jak skript zprovoznit?

Jak bylo zmíněno výše, je třeba nainstalovat Node.js z adresy https://nodejs.org/en/download/

POZOR: Skript funguje pouze pro ústředny od verze 3.3.14 a vyšší

Dále je třeba stáhnout a rozbalit výše zmiňovaný skript, který je na adrese https://github.com/cervajs/download-recordings/archive/master.zip

Poté co skript rozbalíte např. do adresáře C:\download-recordings-master je potřeba pustit terminál (na windows cmd.exe) a do vytvořeného adresáře se přepnout Cd C:\download-recordings-master

Poté proveďte instalaci knihoven, které skript k běhu potřebuje pomocí příkazu

npm install

Nyní nám už zbývá pouze skript spustit se správnými přístupovými údaji.

Nápověda ke skriptu se spustí následovně

node index.js --help
   Usage: index [options]
   Options:
     -V, --version             output the version number
     -f, --date-from <value>   from date i.e 2018-08-01
     -t, --date-to <value>     to date i.e 2018-08-31
     -h, --host <value>        (REQUIRED) PBX name
     -k, --api-key <value>     (REQUIRED) API key
     -s, --api-secret <value>  (REQUIRED) API key secret
     -h, --help                output usage information

Pro parametr -h tedy potřebujeme název ústředny.

Dále potřebujeme API Key a API Secret pro parametry -k a -s

Najdete je v menu ústředny v sekci API -> REST a jsou pro každého zákazníka jiné.

Dále potřebujeme nastavit,  za jakou dobu chcete nahrávky stáhnout.

K tomu slouží parametry –date-from a –date-to

A nyní máme připraveno!

Využijeme puštěný terminál (na windows cmd.exe) a spustíme skript

node index.js -h vhXXX.ipex.cz -s “d513asdasd5661d/4d2asd88/cc94dasd58a” -k “1d6987b2asdasddd6b35fafa” -f “2018-08-05” -t “2018-08-07”

Případné problémy a chyby jsou zalogovány do souboru download.log.

Případné dotazy a připomínky posílejte na adresu cervenka@ipex.cz