Protocolo CTI uTech/CMD HISTORY
De uTech Tecnologia
Tabela de conteúdo |
O HISTORY é um comando enviado pela Aplicação CTI ao Servidor para buscar o histórico das ultimas chamadas do usuário. No comando é retornado as ultimas chamadas realizadas e recebidas. A quantidade de chamadas retornadas no comando é definida no parâmetro LIMIT. Caso o histórico de chamadas esteja em 150 chamadas, mas o usuário passou o valor 500 para o parâmetro LIMIT, retornarão apenas as ultimas 150 chamadas.
Parâmetros
| Parâmetros enviados para o Servidor | |
|---|---|
| LIMIT | Tamanho máximo da lista. |
Comando
| HISTORY LIMIT:10\r\n\r\n |
|---|
Fluxo
| APP CTI > SERVIDOR CTI | |
|---|---|
| HISTORY LIMIT:10\r\n\r\n | |
| SERVIDOR CTI > APP CTI | |
| HISTORY CALLS:"2001,2000,-,2015-08-28 11:13:20,2015-08-28 11:13:24,2015-08-28 11:13:29,5" RESP:OK\r\n\r\n | Comando aceito pelo PABX |
| HISTORY RESP:ERROR\r\n\r\n | Erro reportado pelo PABX |
| NOTA: Quando a resposta do servidor for um OK, o servidor enviará o histórico no parâmetro CALL contendo uma lista de chamadas entre aspas duplas. |
Formato do Histórico
O histórico de chamadas retornado pelo Servidor é separado pelo caractere ; (ponto e virgula). Ex:
Dados/Campos da chamada 1 ; Dados/Campos da chamada 2 ; Dados da chamada 3
Já os dados de cada chamada, são separados pelo caractere , virgula. Ex:
Origem , Destino, Direção, Data/Hora Inicial, Data/Hora do Atendimento, Data/Hora Final, Duração da Chamada (em segundos)
2001,2000,-,2015-08-28 11:13:20,2015-08-28 11:13:24,2015-08-28 11:13:29,5
Parâmetros
| Parâmetros do Histórico | |
|---|---|
| Origem | Número origem da chamada. |
| Destino | Número destino da chamada. |
| Direção | Direção da chamada. In : Entrante Out : Sainte – : Chamada interna (Ramal/Ramal) |
| Inicio | Data/Hora inicial da chamada. |
| Atendimento | Data/Hora inicial do atendimento chamada. |
| Final | Data/Hora do desligamento da chamada. |
| Duração | Duração da chamada (em segundos). |
Exemplo PHP
<?php function get_history_call($socket, $limit) { $data = "HISTORY LIMIT:$limit\r\n\r\n"; socket_write($socket, $data, strlen($data)); $rd = socket_read($socket, 2048); if(!$rd) return 1; return 0; } ?> |
