Č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