Protocolo CTI uTech/CMD DIAL
De uTech Tecnologia
(Diferença entre revisões)
(→Parâmetros) |
|||
| Linha 5: | Linha 5: | ||
<pre> | <pre> | ||
| − | >> DIAL TO:2000 | + | >> DIAL INST:9e18e45af865 TO:2000 |
| − | << DIAL RESP:OK | + | << DIAL INST:9e18e45af865 RESP:OK |
<< CALL CALLID:30303045 STATE:initiated | << CALL CALLID:30303045 STATE:initiated | ||
<< CALL CALLID:30303045 STATE:originated CALLING:2001 CALLED:2000 | << CALL CALLID:30303045 STATE:originated CALLING:2001 CALLED:2000 | ||
| Linha 18: | Linha 18: | ||
{| class="wikitable" width="65%" | {| class="wikitable" width="65%" | ||
! align="center" colspan="2" | Parâmetros enviados para o Servidor | ! align="center" colspan="2" | Parâmetros enviados para o Servidor | ||
| + | |- | ||
| + | | align="left"| INST || Instancia/Chave do comando enviado. Será retornado a mesma chave na resposta do comando. | ||
| + | * Exemplo: INST:9e18e45af865 | ||
|- | |- | ||
| align="left"| TO || numero destino da chamada. | | align="left"| TO || numero destino da chamada. | ||
| Linha 43: | Linha 46: | ||
! align="center" colspan="2" | APP CTI > SERVIDOR CTI | ! align="center" colspan="2" | APP CTI > SERVIDOR CTI | ||
|- | |- | ||
| − | | align="left " colspan="2"| '''DIAL TO:2000\r\n\r\n''' | + | | align="left " colspan="2"| '''DIAL INST:9e18e45af865 TO:2000\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"| '''DIAL RESP:OK\r\n\r\n''' || <font color=red>Chamada aceita pelo PABX</font> | + | | align="left"| '''DIAL INST:9e18e45af865 RESP:OK\r\n\r\n''' || <font color=red>Chamada aceita pelo PABX</font> |
|- | |- | ||
| − | | align="left"| '''DIAL RESP:ERROR\r\n\r\n''' || <font color=red>Erro reportado pelo PABX</font> | + | | align="left"| '''DIAL INST:9e18e45af865 RESP:ERROR\r\n\r\n''' || <font color=red>Erro reportado pelo PABX</font> |
|} | |} | ||
Edição de 20h01min de 28 de julho de 2021
Tabela de conteúdo |
O DIAL é um comando enviado pela Aplicação CTI ao Servidor para gerar uma chamada. O servidor CTI responderá com o parâmetro RESP (OK ou ERROR). Caso a resposta seja OK, a aplicação CTI PODE acompanhar o estado da chamada tratando os Eventos de chamada recebidos tratando o Evento CALL como mostrado abaixo.
Após a resposta de OK do servidor, os eventos de chamadas serão encaminhados para a aplicação CTI, sempre passando como parâmetro o identificador da chamada CALLID.
>> DIAL INST:9e18e45af865 TO:2000 << DIAL INST:9e18e45af865 RESP:OK << CALL CALLID:30303045 STATE:initiated << CALL CALLID:30303045 STATE:originated CALLING:2001 CALLED:2000 << CALL CALLID:30303045 STATE:delivered CALLING:2001 CALLED:2000 << CALL CALLID:30303045 STATE:established CALLING:2001 CALLED:2000 << HISTORY CALLS:"2001,2000,-,2015-08-17 15:12:34,2015-08-17 15:12:37,2015-08-17 15:12:41,4" << CALL CALLID:30303045 STATE:cleared CAUSE:48
Parâmetros
| Parâmetros enviados para o Servidor | |
|---|---|
| INST | Instancia/Chave do comando enviado. Será retornado a mesma chave na resposta do comando.
|
| TO | numero destino da chamada. |
| DEV | Ramal origem da chamada. Campo Opcional. Se não definido, será utilizado o ramal associado ao usuário CTI, definido na criação/edição. |
| ANSWER | Define se a chamada deve ser atendida automaticamente perlo telefone/softphone. (NOTA: os telefones/softphones DEVEM ter implementada tal opção para o funcionamento).
|
Comando
| DIAL TO:2000\r\n\r\n |
|---|
Ou
| DIAL DEV:4444 TO:2000\r\n\r\n |
|---|
Fluxo
| APP CTI > SERVIDOR CTI | |
|---|---|
| DIAL INST:9e18e45af865 TO:2000\r\n\r\n | |
| SERVIDOR CTI > APP CTI | |
| DIAL INST:9e18e45af865 RESP:OK\r\n\r\n | Chamada aceita pelo PABX |
| DIAL INST:9e18e45af865 RESP:ERROR\r\n\r\n | Erro reportado pelo PABX |
Exemplo PHP
<?php function cti_make_call($socket, $to) { $data = "DIAL TO:$to\r\n\r\n"; socket_write($socket, $data, strlen($data)); $rd = socket_read($socket, 2048); if(!$rd) return 1; return 0; } ?> |
Eventos da Chamada Realizada
Estados de uma Chamada
Causas de Desligamento da Chamada
