SENTINELA - Protocolo CTI/CMD HISTORY
De uTech Tecnologia
(Diferença entre revisões)
(→Fluxo) |
|||
(16 edições intermediárias de um usuário não apresentadas) | |||
Linha 1: | Linha 1: | ||
__TOC__ | __TOC__ | ||
− | O '''HISTORY''' é um comando enviado pela Aplicação CTI ao Servidor para buscar o histórico | + | 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. |
+ | <br\><br\> | ||
== Parâmetros == | == Parâmetros == | ||
Linha 10: | Linha 11: | ||
| align="left"| LIMIT || Tamanho máximo da lista. | | align="left"| LIMIT || Tamanho máximo da lista. | ||
|} | |} | ||
+ | <br\> | ||
== Comando == | == Comando == | ||
{| class="wikitable" | {| class="wikitable" | ||
− | ! style="text-align: left; font-weight: bold;" | HISTORY LIMIT:10\n | + | ! style="text-align: left; font-weight: bold;" | HISTORY LIMIT:10\r\n\r\n |
|} | |} | ||
+ | <br\> | ||
== Fluxo == | == Fluxo == | ||
Linha 22: | Linha 25: | ||
! align="center" colspan="2" | APP CTI > SERVIDOR CTI | ! align="center" colspan="2" | APP CTI > SERVIDOR CTI | ||
|- | |- | ||
− | | align="left " colspan="2"| '''HISTORY LIMIT:10\n''' | + | | align="left " colspan="2"| '''HISTORY LIMIT:10\r\n\r\n''' |
|- | |- | ||
! scope="row" colspan=2 align="center"| SERVIDOR CTI > APP CTI | ! scope="row" colspan=2 align="center"| SERVIDOR CTI > APP CTI | ||
|- | |- | ||
− | | align="left"| '''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\n''' || <font color=red>Comando aceito pelo PABX</font> | + | | align="left"| '''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''' || <font color=red>Comando aceito pelo PABX</font> |
|- | |- | ||
− | | align="left"| '''HISTORY RESP:ERROR\n''' || <font color=red>Erro reportado pelo PABX</font> | + | | align="left"| '''HISTORY RESP:ERROR\r\n\r\n''' || <font color=red>Erro reportado pelo PABX</font> |
|} | |} | ||
− | {| class="wikitable" style="text-align: left;" | + | {| class="wikitable" style="text-align: left; color:red;" |
− | | '''NOTA''': Quando a resposta do servidor for um '''OK''', o servidor enviará | + | | '''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. |
|} | |} | ||
+ | <br\> | ||
+ | |||
+ | == Formato do Histórico == | ||
+ | |||
+ | O histórico de chamadas retornado pelo Servidor é separado pelo caractere ''';''' (ponto e virgula). Ex:<br> | ||
+ | <pre> | ||
+ | Dados/Campos da chamada 1 ; Dados/Campos da chamada 2 ; Dados da chamada 3 | ||
+ | </pre> | ||
+ | |||
+ | Já os dados de cada chamada, são separados pelo caractere ''',''' virgula. Ex: | ||
+ | <pre> | ||
+ | Origem , Destino, Direção, Data/Hora Inicial, Data/Hora do Atendimento, Data/Hora Final, Duração da Chamada (em segundos) | ||
+ | </pre> | ||
+ | <pre> | ||
+ | 2001,2000,-,2015-08-28 11:13:20,2015-08-28 11:13:24,2015-08-28 11:13:29,5 | ||
+ | </pre> | ||
+ | |||
+ | '''Parâmetros''' | ||
+ | |||
+ | {| class="wikitable" width="65%" | ||
+ | ! align="center" colspan="2" | Parâmetros do Histórico | ||
+ | |- | ||
+ | | align="left"| Origem || Número origem da chamada. | ||
+ | |- | ||
+ | | align="left"| Destino || Número destino da chamada. | ||
+ | |- | ||
+ | | align="left"| Direção || Direção da chamada.<br\>'''In''' : Entrante<br\>'''Out''' : Sainte<br\>'''–''' : Chamada interna (Ramal/Ramal) | ||
+ | |- | ||
+ | | align="left"| Inicio || Data/Hora inicial da chamada. | ||
+ | |- | ||
+ | | align="left"| Atendimento || Data/Hora inicial do atendimento chamada. | ||
+ | |- | ||
+ | | align="left"| Final || Data/Hora do desligamento da chamada. | ||
+ | |- | ||
+ | | align="left"| Duração || Duração da chamada (em segundos). | ||
+ | |} | ||
+ | |||
+ | |||
+ | <br\><br\> | ||
== Exemplo PHP == | == Exemplo PHP == | ||
Linha 41: | Linha 83: | ||
<source lang="php"> | <source lang="php"> | ||
<?php | <?php | ||
− | function | + | function get_history_call($socket, $limit) |
{ | { | ||
− | $data = "HISTORY LIMIT:$limit\n"; | + | $data = "HISTORY LIMIT:$limit\r\n\r\n"; |
socket_write($socket, $data, strlen($data)); | socket_write($socket, $data, strlen($data)); | ||
$rd = socket_read($socket, 2048); | $rd = socket_read($socket, 2048); |
Edição atual tal como 17h50min de 22 de junho de 2016
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.
[editar] Parâmetros
Parâmetros enviados para o Servidor | |
---|---|
LIMIT | Tamanho máximo da lista. |
[editar] Comando
HISTORY LIMIT:10\r\n\r\n |
---|
[editar] 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. |
[editar] 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). |
[editar] 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; } ?> |