Protocolo CTI uTech/CMD DIAL

Tabela de conteúdo

1 Parâmetros
2 Comando
3 Fluxo
4 Exemplo PHP
5 Eventos da Chamada Realizada
6 Estados de uma Chamada
7 Causas de Desligamento da Chamada

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.

Exemplo: INST:9e18e45af865

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.

true: habilitar autoatendimento.
false: Não habilitar autoatendimento.

NOTA: Para o auto atendimento funcionar, os telefones/softphones DEVEM implementar tal função. Normalmente, o auto atendimento para dispositivos SIP (telefones IP/softphones) é implementado utilizando o header SIP Alert-Info ou Call-Info. Assim, se o usuário inserir no comando DIAL o parâmetro ANSWER=true, o PABX uTech irá enviar os dois headers para o dispositivo SIP.

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 INST:9e18e45af865 TO:$to\r\n\r\n";
    socket_write($socket, $data, strlen($data));
    $rd = socket_read($socket, 2048);
    if(!$rd)
        return 1;
 
    return 0;
}
?>