5.7.2 api call dial

Funkce /api/call/dial umožňuje iniciovat nový odchozí hovor na zvolené telefonní číslo nebo sip uri pomocí parametru number nebo na jednoho či více uživatelů pomocí parametru users. Příkaz smí obsahovat pouze jeden z uvedených parametrů, v opačném případě bude vrácena odpověď s chybovým hlášením.

Funkce je součástí služby Phone/Call a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Telefon/hovory – řízení. 

Pro tuto funkci lze použít metody GET nebo POST.

Parametry požadavku:

Parametr

Popis

number

Povinný parametr specifikující cílové telefonní číslo nebo sip uri.

users

Seznam uuid (unikátní ID) uživatelů oddělenými čárkami.

Odpověď je ve formátu application/json a obsahuje informace o vytvořeném odchozím hovoru.

Parametr

Popis

session

Identifikátor hovoru, který lze použít např. pro sledování hovoru pomocí funkce /api/call/status, příp. pro ukončení hovoru funkcí /api/call/hangup.


Příklad:

GET /api/call/dial?number=sip:1234@10.0.23.194
{
  "success" : true,
  "result" : {
    "session" : 2
  }
}