| Řádka 4: | Řádka 4: | ||
| − | + | ==Vytočení čísla== | |
Inicializovat nový hovor je možné třemi způsoby. Liší se jen v informaci, na kterou telefonní linku má ústředna zavolat předtím, než začne spojovat hovor na cílové telefonní číslo. | Inicializovat nový hovor je možné třemi způsoby. Liší se jen v informaci, na kterou telefonní linku má ústředna zavolat předtím, než začne spojovat hovor na cílové telefonní číslo. | ||
| Řádka 31: | Řádka 31: | ||
| − | + | ===Příklady vytočení hovoru=== | |
| − | Příklady | + | |
Vytočení čísla se zadáním veřejného čísla linky - proměnná '''srcExtenPublicNum''': | Vytočení čísla se zadáním veřejného čísla linky - proměnná '''srcExtenPublicNum''': | ||
| Řádka 47: | Řádka 46: | ||
<code><nowiki>http://IP_PBX/api/api.php?action=originate&srcExtenId=5&dstNum=800123456</nowiki></code> | <code><nowiki>http://IP_PBX/api/api.php?action=originate&srcExtenId=5&dstNum=800123456</nowiki></code> | ||
| + | |||
| + | |||
| + | ==Ukončení hovoru== | ||
| + | |||
| + | Ukončit lze libovolný probíhající hovor vedený v ústředně. Seznam probíhajících hovorů a jména jejich kanálů lze zjistit pomocí další API metody '''listcalls'''. | ||
| + | |||
| + | |||
| + | Proměnné a jejich hodnoty: | ||
| + | |||
| + | |||
| + | ''PROMĚNNÁ'' - ''HODNOTA'' - ''popis'' | ||
| + | |||
| + | '''action''' - ''hangupcall'' - ústředně bude předán pokyn na ukončení probíhajícího hovoru. | ||
| + | |||
| + | '''channelName''' - ''kanál'' - jméno kanálu, na kterém probíha hovor. | ||
| + | |||
| + | |||
| + | ''Vyberte pouze jeden způsob vytočení linky (srcExtenPublicNum,srcExtenInternalNum, srcExtenId). Pokud jich vyberete více, ústředna hovor nevytočí a vrátí chybovou hlášku v JSON formátě.'' | ||
| + | |||
| + | |||
| + | ===Příklad ukončení hovoru=== | ||
| + | |||
| + | <code><nowiki>http://IP_PBX/api/api.php?action=hangupcall&channelName=SIP\5555-0000b704</nowiki></code> | ||
Verze z 14. 4. 2016, 10:00
API rozhraní
Ústředna VoIPSUN PBX disponuje mimo Asterisk API rozhraní i jednoduchým API rozhraním, přes které lze jednoduše inicializovat hovor a ukončit (click2call) nebo zobrazit seznam aktivních hovorů. Další funkce lze doprogramovat na přání klienta.
Vytočení čísla
Inicializovat nový hovor je možné třemi způsoby. Liší se jen v informaci, na kterou telefonní linku má ústředna zavolat předtím, než začne spojovat hovor na cílové telefonní číslo.
Proměnné a jejich hodnoty:
PROMĚNNÁ - HODNOTA - popis
action - originate - ústředně bude předán pokyn na vytvoření nového hovoru.
dstNum - cílové telefonní číslo - číslo, na které bude hovor spojen.
srcExtenPublicNum - veřejné číslo linky - veřejné číslo linky, na kterou ústředna zavolá před vytočením cílového telefonního čísla.
srcExtenInternalNum - interní číslo linky - interní číslo linky, na kterou ústředna zavolá před vytočením cílového telefonního čísla.
srcExtenId - ID linky - ID linky, na kterou ústředna zavolá před vytočením cílového telefonního čísla. ID lze zjistit z databáze z tabulky extensions. Tento způsob je určen především pro vývojáře informačních systémů s přístupem do databáze ústředny.
Vyberte pouze jeden způsob vytočení linky (srcExtenPublicNum,srcExtenInternalNum, srcExtenId). Pokud jich vyberete více, ústředna hovor nevytočí a vrátí chybovou hlášku v JSON formátě.
{"success":"false","reason":"Use only one of next variables: srcExtenPublicNum, srcExtenInternalNum, srcExtenId"}
Příklady vytočení hovoru
Vytočení čísla se zadáním veřejného čísla linky - proměnná srcExtenPublicNum:
http://IP_PBX/api/api.php?action=originate&srcExtenPublicNum=299299000&dstNum=800123456
Vytočení čísla se zadáním interního čísla linky - proměnná srcExtenInternalNum.
http://IP_PBX/api/api.php?action=originate&srcExtenInternalNum=100&dstNum=800123456
Vytočení čísla se zadáním ID linky - proměnná srcExtenId.
http://IP_PBX/api/api.php?action=originate&srcExtenId=5&dstNum=800123456
Ukončení hovoru
Ukončit lze libovolný probíhající hovor vedený v ústředně. Seznam probíhajících hovorů a jména jejich kanálů lze zjistit pomocí další API metody listcalls.
Proměnné a jejich hodnoty:
PROMĚNNÁ - HODNOTA - popis
action - hangupcall - ústředně bude předán pokyn na ukončení probíhajícího hovoru.
channelName - kanál - jméno kanálu, na kterém probíha hovor.
Vyberte pouze jeden způsob vytočení linky (srcExtenPublicNum,srcExtenInternalNum, srcExtenId). Pokud jich vyberete více, ústředna hovor nevytočí a vrátí chybovou hlášku v JSON formátě.
Příklad ukončení hovoru
http://IP_PBX/api/api.php?action=hangupcall&channelName=SIP\5555-0000b704
Zpátky
