EasyCall Gate XML-RPC para Sincronismo de Tela

Manual Técnico/Operacional do EasyCall Gate XML-RPC
para Sincronismo de Tela

Release do EasyCall 1.21
© 2014
por
Dígitro Tecnologia
Seção de Documentação - Departamento Técnico
Rua Profª Sofia Quint de Souza, 167 - Capoeiras
CEP 88085-040 - Florianópolis - SC
www.digitro.com
Todos os direitos são reservados. É vedada, no todo ou em parte, a sua reprodução

por toda a sorte de formas e meios conhecidos. Para tal, é imperativa a autorização,
por escrito, da DÍGITRO TECNOLOGIA LTDA. Seu conteúdo tem caráter técnico-
informativo e os editores se reservam ao direito de revisar as versões, de modo a
aproveitar a totalidade ou parte deste trabalho, sem necessidade de qualquer forma
de aviso prévio.
Florianópolis, junho de 2014.

SUMÁRIO
SUMÁRIO ................................................................................................................... iii
Sobre este Documento .............................................................................................. 5
Organização ....................................................................................................... 5
Convenções ........................................................................................................ 6
Observações Importantes ................................................................................... 7
Introdução ................................................................................................................ 10
Definição de XML ............................................................................................. 10
Definição de RPC ............................................................................................. 11
XML-RPC ......................................................................................................... 12
Método XML-RPC disponível .................................................................................. 14
cti.PEGA_VARIOS_EVENTOS ........................................................................ 14
CMD: "EVENTO_PERDEU_EVENTO"............................................................. 15
CMD: "EVENTO_SEM_EVENTO" .................................................................... 15
CMD: "EVENTO_MODO_DO_MONOFONE" ................................................... 15
CMD: "EVENTO_DE_ESTADO_MONITORACAO".......................................... 16
CMD: EVENTO_DE_MONITORACAO_DE_AUDIO" ...................................... 16
CMD: "EVENTO_DE_INICIANDO_CHAMADA" ............................................... 17
CMD: "EVENTO_DE_GERACAO_DE_CHAMADA"......................................... 17
CMD:"EVENTO_DE_CHAMADA_FORA_DE_DOMINIO" ................................ 17
CMD: "EVENTO_DE_COMPLETAMENTO" ..................................................... 18
CMD: "EVENTO_DE_ATENDIMENTO" ........................................................... 19
CMD: "EVENTO_DE_FALHA" .......................................................................... 19
INFORMAÇÃO PÚBLICA III
CMD: EVENTO_DE_NOVOS_DADOS_ASSOCIADOS" ................................. 20
CMD: "EVENTO_DE_AGENTE"....................................................................... 20
CMD: "EVENTO_DE_HOLD" ........................................................................... 21
CMD: "EVENTO_DE_RETRIEVE" ................................................................... 21
CMD: "EVENTO_DE_REDIRECIONAMENTO"................................................ 22
CMD: EVENTO_DE_TOM_DETETADO .......................................................... 23
CMD: "EVENTO_DE_CIFRAS_DTMF" ............................................................ 23
CMD: "EVENTO_DE_CAPTURA" .................................................................... 24
CMD: "EVENTO_DE_CHAMADA_CAPTURADA" ........................................... 24
CMD: "EVENTO_DE_CONFERENCIA" ........................................................... 25
CMD: "EVENTO_DE_LIBERACAO" ................................................................. 25
CMD: "EVENTO_DE_TRANSFERENCIA" ....................................................... 26
CMD: "EVENTO_DE_ENTRADA_EM_FILA" ................................................... 27
CMD: "EVENTO_DE_SAIDA_DA_FILA" .......................................................... 28
CMD: EVENTO_DE_DAC ................................................................................ 29
Falhas nas Requisições XML-RPC ......................................................................... 30
Descritivo das causas do EVENTO_DE_FALHA ................................................... 33
Exemplos de utilização do EasyCall Gate XML-RPC ............................................ 39
Glossário .................................................................................................................. 41
Anexo – Cenários Específicos................................................................................ 43
INFORMAÇÃO PÚBLICA IV
1
SOBRE ESTE DOCUMENTO
Esse manual descreve a Interface CTI EasyCall Gate XML-RPC para Sincronismo de
Tela para os equipamentos NGC.
ORGANIZAÇÃO
Capítulo 1 Apresenta descrição sobre este documento.
Capítulo 2 Apresenta os propósitos do EasyCall Gate XML-RPC.
Capítulo 3 Apresenta introdução de conceitos sobre XML e RPC.
Capítulo 4 Apresenta todos o método CTI disponível.
Capítulo 5 Apresenta as falhas nas requisições XMLRPC que podem acontecer.
Capítulo 6 Apresenta o descritivo das causas do EVENTO_DE_FALHA.
Capítulo 7 Apresenta exemplos de utilização do EasyCall Gate XML-RPC.
Capítulo 8 Apresenta o glossário.
Capítulo 9 Apresenta o anexo sobre cenários específicos (liberação e
transferência)
INFORMAÇÃO PÚBLICA 5
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Sobre este Documento
CAPÍTULO 1
CONVENÇÕES
Botões e Itens Quando no meio do texto, os nomes dos botões e dos itens
de uma janela ou tela serão grafados em negrito.
JANELAS E MENUS Os nomes das janelas e dos menus, quando aparecerem no
meio do texto, serão grafados em CAIXA ALTA.
Campos As iniciais maiúsculas identificam nome de Campos no meio
do texto.
Palavras de Origem As palavras de origem estrangeira estarão grafadas em
Estrangeira itálico.
Palavras de destaque As palavras que necessitarem de destaque em um
determinado contexto, serão sublinhadas.
CAPÍTULO 1
OBSERVAÇÕES IMPORTANTES
1. O cliente deve disponibilizar um microcomputador em rede com a plataforma,
para instalação da Interface Gráfica (configuração mínima Processador 1 GHZ,
RAM de 64 MB e HD de 10GB - sistema operacional Windows 98 ou 2000 e
Internet Explorer versão 5.5 ou superior).
2. Requisitos para o Sistema Operacional: Windows 98 (mínimo), podendo também
ser usados Windows Millenium, Windows NT (3.5 ou superior), Windows 2000 ou
Windows XP.
3. Requisitos mínimos para o Personal Computer (PC):
a) Mínimo para Windows 98 e NT: Pentium 100, 32MB RAM, HD 2GB (caso não
seja utilizada mais nenhuma aplicação em paralelo). Se for
necessário desempenho ou aplicações em paralelo, a máquina deve ser
Pentium 200 ou superior, com no mínimo 64MB de RAM e HD de 10GB.
Estas especificações podem ser insuficientes no caso de aplicações em
paralelo que consumam muitos recursos da máquina.
b) Mínimo para Windows Millenium: Pentium 200, 64MB RAM, HD de 10GB
(caso não seja utilizada mais nenhuma aplicação em paralelo).
c) Para Windows 2000 e Windows XP o requisito mínimo de máquina é Pentium
II ou AMD K6-2 300MHz com 128MB de RAM, com as mesmas ressalvas
citadas acima.
4. Para as interfaces gráficas dos programas detalhados desse manual, sugere-se
a utilização de uma resolução gráfica mínima de vídeo de 800 X 600 pixels. A
resolução 640 X 480 pixels não deve ser utilizada, pois esta configuração poderá
prejudicar determinadas janelas de configuração dos programas.
5. A Dígitro garante o produto contra eventuais falhas e defeitos durante o período
de garantia, conforme data de emissão da nota fiscal do produto.
CAPÍTULO 1
6. Eventuais intervenções por solicitação do cliente serão cobradas como serviços

adicionais, conforme tabela de preços vigente.
7. Os serviços solicitados pelo cliente, que impliquem em alterações de suas
características específicas, funções adicionais, ou outros itens não
especificados, serão considerados como adicionais ao produto, sendo
executados conforme cronograma de execução e alocação de recursos
elaborado pela Dígitro e aprovado pelo cliente, através de proposta comercial.
8. A Dígitro não atualizará este produto em função de novas versões, sendo
necessário para isso negociação comercial.
9. A Dígitro, como qualquer empresa desenvolvedora, não pode garantir que
softwares não contenham erros ou que o cliente será capaz de operá-lo sem
problemas ou interrupção, não assumindo eventuais prejuízos financeiros
decorrentes dessas falhas ou de problemas de responsabilidade de terceiros.
10. Devido ao desenvolvimento contínuo de técnicas de invasão e ataques à rede,
não é possível garantir que o equipamento (hardware e software) esteja livre da
vulnerabilidade da invasão/ ação externa.
11. A DÍGITRO não se responsabiliza por perdas de informações, devido a não
observação, por parte do cliente, de procedimentos de back-up, orientando para
que, regulamente, armazene os dados também em mídia eletrônica (CD, DVD,
etc.), de forma a possuir contingência externa.
12. Após o aceite ou a entrada em operação do sistema, se ocorrerem erros ou
falhas, estes somente serão avaliados e/ou corrigidas mediante contrato de
suporte ou autorização para pagamento de suporte avulso, conforme a tabela de
preços vigente na data da solicitação.
13. As informações preenchidas nos campos das páginas exibidas e descritas nesse
manual são apenas para ilustração.
14. A configuração do aplicativo depende dos itens adquiridos pelo cliente. O manual
descreve a versão mais atual do aplicativo. Assim, poderão existir versões de
aplicativos diferentes da versão descrita nesse manual. Os itens constantes
CAPÍTULO 1
neste documento que não estejam habilitados poderão ser adquiridos

separadamente.
15. A Dígitro mantém um processo de ciclo de vida de seus produtos devido a
inovações tecnológicas, necessidade de mercado ou outro motivo. Para maiores
informações acesse www.portaldigitro.com.br no ambiente exclusivo clientes.
.
2
INTRODUÇÃO
DEFINIÇÃO DE XML
XML (Extensible Markup Language – Linguagem de marcação Extensível), fornece
uma maneira padronizada para descrever estruturas e propriedades de dados de
forma que ela possa ser transmitida usando a Internet ou intranet. Permite a troca de
informações entre diferentes fontes de modo transparente, como browsers,
aplicativos desktop, etc. XML faz parte de um subconjunto de uma outra linguagem
chamada SGML (Standart Generalized Markup Language) que tem por característica
principal a definição de marcas para representação de informações em formato texto.
XML traz como principais características:
 Criação de novas tags: a XML permite ao desenvolvedor criar suas próprias
tags, diferente do HTML que tem tags fixas, na XML as tags apresentam o
significado das marcas e não como elas devem ser apresentadas.
 Troca de dados: permite a troca de informações estruturadas, como
registros de um BD, como também a troca de informações de documentos
desestruturados. Como é baseado em tags fica simples o envio e a leitura
dos dados do documento, pois para que seja possível a interpretação dos
dados do documento transmitido basta interpretar as tags correspondentes.
Introdução
CAPÍTULO 2
 Flexibilidade no Layout: permite uma grande flexibilidade quanto ao layout

na apresentação dos dados, já que separa as informações de dados e
layout em arquivos diferentes, por exemplo, caso seja necessário alterar o
layout de apresentação basta reformatar o arquivo de layout somente.
 Compatibilidade de plataforma e navegadores.
 Diferentemente do HTML, que define como os dados serão apresentados, a
XML não tem essa atribuição, devido a isso, requer tecnologias adicionais
para poder explorar melhor suas funcionalidades.
 CSS (Cascading Style Sheets) permite criar estilos de páginas WEB.
 XSL (Extensible Style Language) define como os dados serão formatados e
apresentados na página WEB.
 XLL (Extensible Linking Language) permite a conexão com outros
documentos.
 DTD (Document Typo Definition) define a estrutura de uma página XML.
 Princípios de Java Script.
DEFINIÇÃO DE RPC
RPC (Remote Procedure Call – Chamada de procedimento remoto) é um protocolo
utilizado pelo sistema operacional que fornece um mecanismo de comunicação entre
processos e permite que um programa de um computador execute, de forma
transparente, códigos em um sistema remoto. Basicamente, um cliente solicita
serviços ao servidor que após executá-los retorna a resposta ao cliente utilizando-se
dos serviços da rede. Este tipo de prática permite ao desenvolvedor executar
procedimentos remotos como se estivesse executando-os em sua própria máquina.
É função do RPC a especificação e interpretação da mensagem, não cabe a ele
especificar a mensagem. A sua implementação depende, portanto, de sobre qual
protocolo de transporte vai operar.
Introdução
CAPÍTULO 2
 TCP: Não é necessário preocupar-se com time-outs, retransmissões,

duplicatas.
 UDP: É necessário preocupar-se com time-outs, retransmissões,
duplicatas.
Uma chamada RPC pode ser síncrona, quando o cliente permanece bloqueado até
que o resultado do procedimento seja retornado pelo servidor, ou assíncrona, quando
o cliente não é bloqueado, podendo continuar sua execução.
Uma chamada RPC pode ser direcionada a somente um servidor (unicast) ou a

vários servidores (multicast) aumentando assim a disponibilidade de serviço,
prevenindo falhas ou mesmo para efetuar computação paralela aumentando o tempo
de resposta.
XML-RPC
XML-RPC (EXtensible Markup Language-Remote Procedure Call), é uma
especificação e um conjunto de implementações que permitem a chamada remota de
procedimentos (RPC) pela Internet. É uma forma simplificada e portável de fazer
chamadas remotas utilizando o protocolo HTTP. Utiliza HTML (Hyper Text Transfer
Protocol - Protocolo de Transferência de HiperTexto) como protocolo padrão para
transporte das informações e o XML (EXtensible Markup Language) para codificação
dos dados. Uma de suas vantagens mais significativas é a capacidade de permitir a
integração de sistemas de tipos diferentes através da troca de informações (pacotes)
utilizando-se a codificação XML.
O XML-RPC é baseado em chamadas do tipo HTTP - POST formado por requisições

e respostas. As requisições possuem o nome de um método e a lista de valores dos
parâmetros. As respostas devem conter exatamente um valor de retorno, ou uma
condição de erro.
Introdução
CAPÍTULO 2
Como uma mensagem XML-RPC é uma requisição HTTP – POST, isso faz com que
as mensagens não tenham um tamanho máximo definido, já que o método POST
divide as mensagens que são enviadas via rede. O corpo da requisição é em XML e
o procedimento é executado no servidor retornando o valor também em XML.
Parâmetros de procedimento podem ser escalares, números, strings, datas, etc., e
podem ser também dados complexos e listas de estruturas.
Como exemplo, podemos utilizar um sistema típico cliente-servidor onde o cliente

efetua uma chamada de processamento remoto para um programa que esteja sendo
executado em uma máquina remota. Utilizando XML-RPC, os procedimentos,
contendo todos os parâmetros necessários, que devem ser executados remotamente
são codificadas em documentos XML e depois enviados a um servidor por meio de
HTTP. Quando o servidor recebe, ele decodifica o documento, executa o
procedimento solicitado, “empacota” o resultado (se existir) em um documento XML e
o retorna ao cliente também por meio de HTTP. O cliente decodifica a resposta e
continua sua execução.
3
MÉTODO XML-RPC DISPONÍVEL
Neste item é apresentado o método XML-RPC disponível por esta interface CTI e
seus eventos.
CTI.PEGA_VARIOS_EVENTOS
Descrição: Requisita próximo evento relacionado ao dispositivo.
Parâmetros:
DISPOSITIVO: String - identifica faixas de ramais separados por '-'. Pode-se ter
diversas faixas separadas por ',' (vírgula) ou vários ramais separados por vírgulas.
SENHA_DISPOSITIVO: String - senha do dispositivo.
NUMERO_EVENTO: Int - Evento sendo requisitado.
Resposta:
EVENTOS: Contém de 1 a 50 eventos numa lista associados à requisição, no mesmo
formato das requisições PEGA_EVENTO, excetuando os campos
PROXIMO_EVENTO.
PROXIMO_EVENTO: Int - Próximo evento a requisitar.
Método XML-RPC
disponível
CAPÍTULO 3
CMD: "EVENTO_PERDEU_EVENTO"
Descrição Evento: Perdeu evento requisitado.
PROXIMO_EVENTO: Próximo evento a requisitar.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
CMD: "EVENTO_SEM_EVENTO"
Descrição Evento: Sem evento no período.
CMD: "EVENTO_MODO_DO_MONOFONE"
Descrição evento: Esta função reporta o modo de operação do monofone.
MODO_DO_MONOFONE: Indica o modo de funcionamento do dispositivo:
(NO_GANCHO / FORA_DO_GANCHO_ATEND_MANUAL /
FORA_DO_GANCHO_ATEND_AUTOM)
Método XML-RPC
disponível
CAPÍTULO 3
CMD: "EVENTO_DE_ESTADO_MONITORACAO"
Descrição evento: Indica o início e o fim da monitoração de áudio no dispositivo.
ID_CHAMADA: Este campo é a identificação da chamada que está sendo
monitorada.
DISPOSITIVO_MONITORADO: Indica o dispositivo que está sendo monitorado
(áudio).
ESTADO_MONITORACAO: Indica o início/término da monitoração no dispositivo
(SIM/NAO).
CMD: EVENTO_DE_MONITORACAO_DE_AUDIO"
Descrição evento: Esta função reporta a presença de áudio na monitoração do
dispositivo.
ID_CHAMADA: Este campo é a identificação da chamada que está sendo
monitorada.
DISPOSITIVO_MONITORADO: Indica o dispositivo que está sendo monitorado
(áudio).
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.
AUDIO_PRESENTE: Indica a presença ou não de áudio no dispositivo (SIM/NAO).
Método XML-RPC
disponível
CAPÍTULO 3
CMD: "EVENTO_DE_INICIANDO_CHAMADA"
Descrição evento: Esta função reporta o início de uma chamada.
ID_CHAMADA: Este campo é a identificação da chamada em andamento.
CMD: "EVENTO_DE_GERACAO_DE_CHAMADA"
Descrição evento: Esta função reporta a geração de uma chamada. Este evento só
ocorre em caso de sucesso na geração.
DISPOSITIVO_EVENTO: Indica o dispositivo que esta recebendo o evento.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
CONTA: Indica a conta do usuário.
FDS: Indica o Fim De Seleção recebido.
DADOS: Dados associados a chamada. (Limite de 100 caracteres)
CMD:"EVENTO_DE_CHAMADA_FORA_DE_DOMINIO"
Descrição evento: Esta função reporta a geração de uma chamada para fora do
domínio da switch. Este evento só ocorre para chamadas externas.
Método XML-RPC
disponível
CAPÍTULO 3

DADOS: Dados associados à chamada.
CMD: "EVENTO_DE_COMPLETAMENTO"
Descrição evento: Esta função reporta o completamento de uma chamada.
DISPOSITIVO_AÇÃO: Indica o dispositivo que requisitou o serviço.
NUMERO_ORIGINADOR: É o número do originador.
NUMERO_DISCADO_ORIGINAL: É o número discado.
ULTIMO_REDIRECIONAMENTO: Dispositivo que recebeu esta chamada antes de
redirecionar.
CATEGORIA: Indica a categoria da identidade associada.
Método XML-RPC
disponível
CAPÍTULO 3
CMD: "EVENTO_DE_ATENDIMENTO"
Descrição evento: Esta função reporta o atendimento de uma chamada.
DISPOSITIVO_ACAO: Indica o dispositivo que requisitou o serviço.
redirecionar.
CMD: "EVENTO_DE_FALHA"
Descrição do Evento: Esta função reporta um evento de falha na geração de uma
chamada.
ID_CHAMADA: Este campo é a identificação da chamada na qual houve algum
problema.
Método XML-RPC
disponível
CAPÍTULO 3
CAUSA_FALHA: Este campo indica a causa da falha da chamada: (DESISTENCIA

FALHA_CHAMADA_GRUPO/ FALHA_VEICULACAO_MENSAGEM/
FALHA_CHAMADA_RAMAL/ CHAMADA_A_COBRAR/ FALHA_TRANSBORDO/
DESTINO_OCUPADO/ NAO_PERTURBE/ ASSINANTE_BLOQUEADO/
FALHA_GERACAO_RAMAL/ DESTINO_INEXISTENTE/ FALHA_GERACAO/
FALHA_ESTACIONAMENTO/ FALHA_ALOCACAO_JUNTOR_CONFLITO
/FALHA_ALOCACAO_JUNTOR_LINK/
FALHA_ALOCACAO_JUNTOR/FALHA_CONGESTIONAMENTO /
FALHA_SINALIZACAO/ FALHA_NUMERO_INCOMPLETO/RAMAL_BLOQUEADO/
FALHA_TX_FAX/ FALHA_RX_FAX/FALHA_DISPOSITIVO_SEM_CREDITOS/
CAUSA_INVALIDA_FALHA)
CMD: EVENTO_DE_NOVOS_DADOS_ASSOCIADOS"
Descrição evento: Esta função reporta um evento de novos dados associados à
chamada em curso.
CMD: "EVENTO_DE_AGENTE"
Descrição evento: Esta função reporta o estado de um agente.
Método XML-RPC
disponível
CAPÍTULO 3
CONTA_AGENTE: Indica a conta do agente.

DISPOSITIVOS_DAC_LOGADOS: Indica o(s) dispositivo(s) DAC em que este ramal
está logado, separados por vírgula (,).
ESTADO_AGENTE: Indica o estado do agente:
ESTADO_AGENTE_LOGOUT / ESTADO_AGENTE_LOGIN /
ESTADO_AGENTE_POS_ATENDIMENTO / ESTADO_AGENTE_LIVRE /
ESTADO_AGENTE_OCUPADO / ESTADO_AGENTE_PAUSA)
CMD: "EVENTO_DE_HOLD"
Descrição evento: Esta função reporta a entrada em hold (música) de uma chamada
no dispositivo.
ID_CHAMADA: Este campo é a identificação da chamada colocada em espera.
CMD: "EVENTO_DE_RETRIEVE"
Descrição evento: Esta função reporta a saída de música (hold) de uma chamada
no dispositivo.
ID_CHAMADA: Este campo é a identificação da chamada retirada da espera.
Método XML-RPC
disponível
CAPÍTULO 3

CMD: "EVENTO_DE_REDIRECIONAMENTO"
Descrição evento: Esta função reporta o redirecionamento de uma chamada de um
dispositivo para outro.
ID_CHAMADA: Este campo é a identificação da chamada redirecionada.
DISPOSITIVO_TRANSFERIDO: Indica o dispositivo que está sendo transferido.
DISPOSITIVO_TRANSFERIDOR: Indica o dispositivo que está executando a
transferência.
DISPOSITIVO_TRANSFERIDO_PARA: Indica o dispositivo de destino da
transferência.
CAUSA_REDIR: Este campo indica a causa do redirecionamento:
(LINHA_OCUPADA_ORIGEM / LINHA_OCUPADA_DESTINO /
ORIGEM_NAO_ATENDE/
DESTINO_NAO_ATENDE / SIGA_ME_ORIGEM/ SIGA_ME_DESTINO / DAC /
VOICE_MAIL/
TRANSBORDO_GRUPO / FILA_GRUPO / FILA_DISPOSITIVO / DISPOSITIVO/
TRANSBORDO_ESTACIONAMENTO / ESTACIONAMENTO / GRUPO_SEM_FILA /
TEMPO_FILA_GRUPO/
GRUPO_ROUTING_POINT / GRUPO_NAO_ATENDE / CALENDARIO /
CAUSA_INVALIDA_REDIR)
Método XML-RPC
disponível
CAPÍTULO 3
CMD: EVENTO_DE_TOM_DETETADO
Descrição Evento: Esta função reporta o tom detectado no dispositivo.
TOM_DETETADO: Indica o tom detectado no dispositivo: (00 = sem tom - timeout)
(01 = detectado tom contínuo de discar 425 Hz) (02 = detectado tom de ocupado 425
Hz) (03 = detectado tom de nível vago 425 Hz) (04 = detectado tom de chamada de
425 Hz) (05 = detectado portadora de FAX) (06 = detectado portadora de modem
V8BIS) (07 = detectado portadora de modem V34) (08 = voz detectada) (09 = silêncio
detectado).
CMD: "EVENTO_DE_CIFRAS_DTMF"
Descrição evento: Esta função reporta um evento das cifras DTMF detectadas em
uma chamada estabelecida.
CIFRAS_DTMF: Indica as cifras DTMF enviadas ou detectadas.
Método XML-RPC
disponível
CAPÍTULO 3
CMD: "EVENTO_DE_CAPTURA"
Descrição evento: esta função reporta a captura de um dispositivo.
ID_CHAMADA: Este campo é a identificação da chamada capturada.
DISPOSITIVO_CAPTURADO: Indica o dispositivo que foi capturado.
CMD: "EVENTO_DE_CHAMADA_CAPTURADA"
Descrição evento: esta função reporta que o ramal capturopu uma chamada com
sucesso.
ID_CHAMADA_CAPTURADOR: Este campo é a identificação da chamada que
estava com o capturador.
ID_CHAMADA_CAPTURADO: Este campo é a identificação da chamada que estava
com o capturado.
DISPOSITIVO_CAPTURADO: Indica o dispositivo que foi capturado.
DADOS: Dados associados à chamada (Limite de 100 caracteres).
Método XML-RPC
disponível
CAPÍTULO 3
CMD: "EVENTO_DE_CONFERENCIA"
Descrição evento: Esta função reporta a entrada em conferência.
ID_CHAMADA_RETIDA: Este campo é a identificação da chamada retida (em Hold).
ID_CHAMADA_ATIVA: Este campo é a identificação da chamada atendida.
ID_CHAMADA_NOVA: Refere-se à identificação da conferência, neste caso, a
mesma é tratada como se fosse uma única chamada, identificada por esta ID.
DISPOSITIVO_DONO_CONFERENCIA: Indica o dispositivo que é dono da
conferência.
DISPOSITIVO_ENTRANDO_EM_CONFERENCIA: Indica o dispositivo que esta
sendo incluído na conferência.
CAUSA_CONF: Este campo indica a causa da conferência:
(CONFERENCIA / CAUSA_INVALIDA_CONFERENCIA)
CMD: "EVENTO_DE_LIBERACAO"
Descrição evento: Esta função reporta a saída de um dispositivo de uma chamada.
ID_CHAMADA: Este campo é a identificação da chamada em finalização.
DISPOSITIVO_ONHOOK: Indica o dispositivo que colocou o headset no gancho.
Método XML-RPC
disponível
CAPÍTULO 3

ESTADO_CHAMADA: Indica o estado da chamada:
(1) INICIANDO_CHAMADA (2) AGUARDANDO_ATENDIMENTO_CHAMADA(3)
CHAMADA_ATENDIDA (4) CHAMADA_EM_CONSULTA (5)
CONFERENCIA_EM_CONSULTA (6) CHAMADA_EM_FILA_NO_DISPOSITIVO (7)
CHAMADA_EM_FILA_NO_DISPOSITIVO_DAC (8) CONFERENCIA (9)
AGUARDANDO-ON-HOOK)
CAUSA_LIBERACAO: Este campo indica a causa da liberação da chamada:
(CHAMADA_NAO_ATENDIDA/ DESISTENCIA_DE_CHAMADA/
LIBERACAO_NORMAL/ LIBERACAO_DAC/ CAUSA_INVALIDA)
Observação: No caso de desistência em fila de grupo de uma chamada externa, a

causa da liberação é LIBERACAO_NORMAL e o estado é
CHAMADA_EM_FILA_NO_DISPOSITIVO_DAC.
CMD: "EVENTO_DE_TRANSFERENCIA"
Descrição evento: Esta função reporta uma transferência entre os dispositivos
especificados.
ID_CHAMADA_RETIDA: Este campo é a identificação da chamada retida (em Hold).
ID_CHAMADA_ATIVA: Este campo é a identificação da chamada atendida.
ID_CHAMADA_NOVA: Este campo é a identificação da nova chamada.
Método XML-RPC
disponível
CAPÍTULO 3
DISPOSITIVO_TRANSFERIDOR: Indica o dispositivo que está executando a

transferência.
DISPOSITIVO_TRANSFERIDO: Indica o dispositivo que está sendo transferido.
DISPOSITIVO_TRANSFERIDO_PARA: Indica o dispositivo de destino da
transferência.
CAUSA_TRANSF: Este campo indica a causa da transferência:
(TRANSF_CHAMANDO/ TRANSF_ATENDIDO/ TRANSF_IMEDIATA/
CAUSA_INVALIDA_TRANSF)
TRANSFERIDOR_ON_HOOK: Indica se o dispositivo transferidor está OnHook ou
OffHook (SIM/NÃO)
CMD: "EVENTO_DE_ENTRADA_EM_FILA"
Descrição evento: Esta função reporta a entrada em fila de uma chamada num
dispositivo.
ID_CHAMADA: Este campo é a identificação da chamada que entrou na fila do
dispositivo.
TAMANHO_FILA: Indica o tamanho da fila no dispositivo.
POSICAO_NA_FILA: Indica a posição na fila em que o dispositivo se encontra.
Método XML-RPC
disponível
CAPÍTULO 3

redirecionar.
DADOS: Dados associados a chamada. (Limite de 100 caracteres).
CPD: <opcional> Indica se é para detectar o tipo da chamada, verificando se a
identidade B é:
0-Indeterminado, 1-Voz humana, 2-Secretária, 3-FAX ou 4-Sem Licença.
CMD: "EVENTO_DE_SAIDA_DA_FILA"
Descrição evento: Esta função reporta a saída de fila de uma chamada num
dispositivo.
ID_CHAMADA: Este campo é a identificação da chamada que saiu da fila do
dispositivo.
TAMANHO_FILA: Indica o tamanho da fila no dispositivo.
POSICAO_NA_FILA: Indica a posição na fila em que o dispositivo se encontrava.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada .
NUMERO_ORIGINADOR: É o número do originador da chamada.
redirecionar.
Método XML-RPC
disponível
CAPÍTULO 3
CMD: EVENTO_DE_DAC
Descrição evento: Esta função reporta as variações de estado de um agente logado
(ou não) no dispositivo em questão.
CONTA_AGENTE: Indica a conta do agente.
ESTADO_AGENTE: Indica o estado do agente:
(ESTADO_AGENTE_LOGOUT/ ESTADO_AGENTE_LOGIN/
ESTADO_AGENTE_POS_ATENDIMENTO/ ESTADO_AGENTE_LIVRE/
ESTADO_AGENTE_OCUPADO/ ESTADO_AGENTE_PAUSA)
4
FALHAS NAS REQUISIÇÕES XML-RPC
 500: Erro Interno.
 501: Erro de tipo xmlrpc.
 502: Erro de índice xmlrpc.
 503: Erro de formato xmlrpc.
 504: Erro de rede xmlrpc.
 505: Erro de estouro de tempo xmlrpc.
 506: Método xmlrpc não implementado.
 507: Requisição xmlrpc negada.
 508: Introspecção xmlrpc desabilitada.
 509: Estouro de limite interno xmlrpc.
 510: Formato UTF-8 xmlrpc invalido.
 600: Erro indefinido.
 601: Estouro do tempo máximo de requisição.
 602: Erro no formato da requisição específica.
 700: Fim de Recursos Internos.
 701: Sem permissão.
Falhas nas Requisições
XML-RPC
CAPÍTULO 4
 702: Não implementado.

 703: Sem conexão com o Pabx..
 800: Erro do Pabx Operação OK?
 801: Operação Pabx já efetuada.
 802: Operação Pabx não permitida.
 803: Operação Pabx não OK.
 804: Ramal Inválido.
 805: Conta Inválida.
 806: Senha Inválida.
 807: Número discado incompleto.
 808: Prefixo bloqueado.
 809: Falha de discagem.
 810: Ramal discado nulo.
 811: Rota Inválida.
 812: Falha de protocolo Pabx.
 813: Sem ramal livre DAC.
 814: Número chamado inválido.
 815: Destino ocupado.
 816: Falha Inclusão Conferência.
 817: Recurso Não Disponível.
 818: Excedeu Limite de Conferencias.
 819: Excedeu Limite de Membros na Conferências.
 820: Excedeu limite de licenças CTI.
 821: Parâmetros incompletos.
 822: Grupo DAC inválido.
Falhas nas Requisições
XML-RPC
CAPÍTULO 4
 823: Senha Conta Inválida.

 899: Erro de Pabx Genérico.
5
DESCRITIVO DAS CAUSAS DO
EVENTO_DE_FALHA
Este capítulo apresenta as descrições das mensagens exibidas no display do
aplicativo EasyCall Agent.
Assinante bloqueado ASSINANTE_BLOQUEADO

Descrição
Esta mensagem é apresentada quando agente recebe uma chamada externa de
um número que esteja cadastrado no Padrão de Prefixos Bloqueados Entrantes do
PABX (item opcional).
Causa desconhecida CAUSA_INVALIDA_FALHA

Descrição
Esta mensagem é apresentada quando ocorre um falha devido a uma causa
desconhecida.
Descritivo das Causas do
evento-de-falha
CAPÍTULO 5
Chamada Cancelada DESISTENCIA

Descrição
Esta mensagem é apresentada quando a chamada predictiva é liberada antes do
atendimento.
Chamada a cobrar CHAMADA_A_COBRAR

Descrição
Esta mensagem é apresentada quando uma chamada entrante a cobrar for
bloqueada pelo PABX.
Chamada entrante, ramal ocupado FALHA_CHAMADA_RAMAL

Descrição
Esta mensagem é apresentada quando ocorre uma falha numa chamada entrante
para o agente, ou seja, alguém ligou para o ramal do agente e não havia recurso
disponível para atender a chamada (Voice-mail, Chamada em Espera, etc.).
Chamada grupo FALHA_CHAMADA_GRUPO

Descrição
Esta mensagem é apresenta quando o agente realiza uma chamada interna para
um ramal chave de grupo que não possui nenhum ramal presente ou agente
logado.
Congestionamento, linhas ocupadas FALHA_CONGESTIONAMENTO

Descrição
Esta mensagem indica que houve congestionamento na central ou que todos os
troncos estão ocupados
evento-de-falha
CAPÍTULO 5
Dispositivo sem créditos para gerar chamada

FALHA_DISPOSITIVO_SEM_CREDITOS
Descrição
Esta mensagem é apresentada quando o dispositivo que gerar chamada, não
possuir créditos.
Falha ao obter linha FALHA_ALOCACAO_JUNTOR_CONFLITO

Descrição
Esta mensagem é apresentada quando o agente está gerando uma chamada
externa e no tronco de saída está entrando uma chamada.
Falha ao receber fax FALHA_RX_FAX

Descrição
Esta mensagem é apresentada quando ocorre falha na recepção do FAX.
Falha ao transmitir fax FALHA_TX_FAX

Descrição
Esta mensagem é apresentada quando ocorre falha na transmissão do FAX.
Falha ao veicular mensagem FALHA_VEICULACAO_MENSAGEM

Descrição
Esta mensagem é apresentada quando ocorre falha na divulgação da mensagem
de atendimento.
evento-de-falha
CAPÍTULO 5
Falha discagem externa FALHA_GERACAO

Descrição
Esta mensagem é apresentada quando ocorre falha na geração de chamada
externa.
Falha nos links ou processadores FALHA_ALOCACAO_JUNTOR_LINK

Descrição
Esta mensagem é apresentada quando ocorre falha no link de comunicação com a
operadora.
Falha sinalização com central FALHA_SINALIZACAO

Descrição
Esta mensagem é apresentada quando ocorre falha na sinalização com a central
pública.
Não perturbe habilitado NAO_PERTURBE

Descrição
Esta mensagem é apresentada quando o destino está com programação de não-
perturbe ativa.
Número discado incompleto FALHA_NUMERO_INCOMPLETO

Descrição
Esta mensagem é apresentada quando, numa ligação externa, o número discado
está incompleto.
evento-de-falha
CAPÍTULO 5
Ramal bloqueado para as chamadas RAMAL_BLOQUEADO

Descrição
Esta mensagem é apresentada após a transferência de chamadas via EC Agent,
quando o agente está operando com o "modo de operação no gancho". Após a
transferência, o agente fica bloqueado até que o monofone do seu ramal seja
colocado novamente no gancho.
Ramal inexistente FALHA_GERACAO_RAMAL

Descrição
Esta mensagem é apresentada quando o agente gera uma chamada para um
ramal inexistente.
Sem linhas disponíveis FALHA_ALOCACAO_JUNTOR

Descrição
Esta mensagem é apresentada quando não há juntores de saída disponíveis para
gerar a chamada.
Sem privilégio para estacionamento FALHA_ESTACIONAMENTO

Descrição
Esta mensagem é apresentada quando o ramal do agente não possui privilégio
para estacionar chamadas.
Telefone inexistente DESTINO_INEXISTENTE

Descrição
Esta mensagem é apresentada quando o agente gera uma chamada para um
número inexistente.
evento-de-falha
CAPÍTULO 5
Telefone ocupado DESTINO_OCUPADO

Descrição
Esta mensagem é apresentada quando o agente gera uma chamada (interna ou
externa) e o destino está ocupado.
Transbordo FALHA_TRANSBORDO
Descrição
Esta mensagem é apresentada quando o grupo do agente não possui fila de
atendimento ou a fila está cheia e a chamada é transferida para um grupo de
transbordo.
6
EXEMPLOS DE UTILIZAÇÃO DO
EASYCALL GATE XML-RPC
ATENÇÃO
A porta que deverá ser utilizada para conexão com a plataforma Dígitro é a de
número 2551. O diretório a ser requisitado no POST para o servidor (Plataforma
Dígitro) deve ser /RPC2.
O método cti.PEGA_VARIOS_EVENTOS sempre é iniciado como número de
evento = 0 (zero), sendo que sua resposta traz o número do próximo evento a ser
solicitado. Como ilustrado a seguir.
<?xml version="1.0"?> <methodCall>

<methodName>cti.PEGA_VARIOS_EVENTOS</methodName> <params> <param>
<value><struct> <member><name>DISPOSITIVO</name> <value><string>2003-
2003</string></value> </member>
<member><name>SENHA_DISPOSITIVO</name>
<value><string>4567</string></value> </member>
<member><name>NUMERO_EVENTO</name> <value><string>0</string></value>
</member> </struct></value> </param> </params> </methodCall>
Exemplos de utilizaçãodo
EasyCall Gate XML-RPC
CAPÍTULO 6
<methodResponse> <params> <param> <value><struct>

<member><name>EVENTOS</name> <value><array> <data> <value><struct>
<member><name>CMD</name>
<value><string>EVENTO_PERDEU_EVENTO</string></value> </member>
<member><name>DISPOSITIVO_EVENTO</name> <value><string>2003-
2003</string></value> </member> </struct></value> </data> </array></value>
</member> <member><name>PROXIMO_EVENTO</name>
<value><string>100</string></value> </member> </struct></value> </param>
</params> </methodResponse>
<?xml version="1.0"?> <methodCall>

<methodName>cti.PEGA_VARIOS_EVENTOS</methodName> <params> <param>
<value><struct> <member><name>DISPOSITIVO</name> <value><string>2003-
2003</string></value> </member>
<member><name>SENHA_DISPOSITIVO</name>
<value><string>4567</string></value> </member>
<member><name>NUMERO_EVENTO</name>
<value><string>100</string></value> </member> </struct></value> </param>
</params> </methodCall>
NOTA
Os exemplos apresentados encontram-se sempre referenciados ao dispositivo que
está solicitando ou recebendo um evento ou comando.
GLOSSÁRIO
API: sigla de "Application Program Interface", que é um formato de linguagem e
mensagem usado por um programa aplicativo para comunicar-se com um outro
programa que fornece serviços para ele. As APIs geralmente são implementadas
escrevendo-se funções. Exemplos de APIs são as chamadas feitas por um programa
aplicativo para programas como o sistema operacional, o sistema de mensagem ou o
DBMS (DataBase Management System ou Sistema de Gerenciamento de Banco de
Dados).
CTI: sigla em inglês correspondente a Computer Telephone Integration. Combinar
dados a sistemas de voz a fim de melhorar os serviços telefônicos.
DISPOSITIVO: Qualquer elemento numa chamada telefônica. Pode ser um ramal
lógico (chave de grupo, por exemplo), um ramal real (analógico, digital, IP) ou
qualquer telefone representado por um valor alfanumérico (fixo ou móvel)
DISPOSITIVOS_ASSOCIADOS: São os elementos que compõe uma chamada, uma
ligação. Basicamente, é a identidade dos interlocutores, sejam estes ramais,
telefones celulares ou telefones fixos.
DISPOSITIVO_ACAO: É o elemento em uma chamada responsável por uma ação,
ou requisição ou pela geração de um evento. Por exemplo: Em uma chamada, o
dispositivo que atenderá a ligação será o responsável pela ação de atendimento.
DISPOSITIVO_EVENTO: É o dispositivo que está sendo controlado, gerenciado; o
alvo da aplicação cliente. Qualquer evento que ocorra sobre ele, ou por meio dele,
será reportado à aplicação para tomada de decisão.
Interface: A conexão e interação entre hardware, software e o usuário. Construir
interfaces é a maior parte do que fazem os engenheiros, programadores e
consultores. Os usuários "conversam" com o software. O software "conversa" com o
hardware e outros softwares. O hardware "conversa" com outro hardware. Tudo isto
Glossário
é feito por meio de interfaces. Elas têm de ser projetadas, desenvolvidas, testadas e
reprojetadas e, com cada nova versão, nasce uma nova especificação que pode se
tornar um padrão de fato ou regulamentado.
Protocolo: Conjunto de regras e procedimentos de comunicação, que permitem o
intercâmbio ordenado de dados entre dois equipamentos (no caso, órgãos de
centrais telefônicas).
RPC: Sigla de "Remote Call Procedure" ou "Chamada de Procedimento Remoto.
Consiste em um tipo de interface que permite que um programa chame outro numa
localização remota. Usando um padrão RPC, ele permite que um aplicativo seja
usado numa variedade de redes sem mudanças.
Script: Um programa escrito numa linguagem de programação de uso especial, tal
como aquela usada num programa de comunicações ou editor de texto.
Servidor: Um computador compartilhado numa rede por vários usuários.
Site: O mesmo que localidade, um servidor de dados.
Switch: Possui três significados possíveis: (1) Um dispositivo mecânico ou eletrônico
que direciona o fluxo de sinais elétricos ou ópticos de um lado para outro. Com
relação a uma chave comutadora liga/desliga". (2) Em programação, um bit ou byte
usado para controlar algo. (3) Um modificador de um comando. Simplificando, é uma
caixa comutadora que direciona uma linha para a outra.
Tag: Um nome (rótulo, mnemônico) atribuído a uma estrutura de dados, como um
campo, arquivo, parágrafo ou outro objeto.
XML: sigla de eXtensible Markup Language (Linguagem de Marcação Expansível). é
um sistema de codificação que permite que qualquer tipo de informação seja
distribuído através da WWW. Ao contrário do HTML, a XML é verdadeiramente para
todos os propósitos. A XML oferece o panorama de uma ampla variedade de
aplicações, cada uma servindo a uma função em particular e usando a WEB como
um mecanismo de distribuição.
ANEXO – CENÁRIOS ESPECÍFICOS
Liberação:
Um dispositivo pode trabalhar em um dos três estados definidos no PABX: monofone
no gancho, monofone fora do gancho com atendimento manual e monofone fora do
gancho com atendimento automático.
Quando se opera com o estado monofone no gancho, deve-se atentar para um

procedimento específico.
Por exemplo: A está falando com B. Caso B finalize a chamada e A mantenha seu
monofone fora do gancho, ocorrerá um caso típico de dispositivo ocupado devido ao
monofone se encontrar fora do gancho, impossibilitando o recebimento de uma nova
chamada entrante. Para que a aplicação CTI não encaminhe chamadas para A sem
que o dispositivo esteja liberado, foi inserido um novo parâmetro, o campo
“Dispositivo_OnHook=”
Para que o dispositivo seja liberado, é necessário colocar o monofone no gancho.

Quando esse procedimento for executado a plataforma gerará um evento de
“liberação”, passando como parâmetro o campo “Dispositivo_OnHook=” com o valor
do dispositivo que liberou a chamada; é nesse ponto que o equipamento Digitro – e
conseqüentemente a aplicação CTI – reconhecerá que o dispositivo está livre para
receber nova chamada.
Transferência:
A mudança pode ser tipicamente explicada no caso de “single step transfer”, isto é,
transferência executada via aplicativo CTI com o ramal trabalhando no estado
monofone no gancho. Por exemplo, tem-se A falando com B e transferindo a
chamada via CTI para C. O usuário A escuta uma mensagem avisando que a
Anexo
programação foi aceita e, em seguida, tom de ocupado, pois o sistema aguarda que
o monofone seja recolocado no gancho.
Neste momento, a aplicação CTI recebe um comando

“Evento_de_Iniciando_Chamada”, seguido de um “Evento_de Falha”, que serve para
destacar o fato de que aquele ramal ainda não está livre. Quando o usuário
finalmente recolocar o monofone no gancho, será encaminhado um “Evento_de_
Liberação”, com o ramal A destacado no campo “Dispositivo_OnHook=”, indicando
que o mesmo encontra-se disponível para gerar e receber ligações.

EasyCall Gate XML-RPC para Sincronismo de Tela

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

EasyCall Gate XML-RPC para Sincronismo de Tela

Enviado por

Direitos autorais:

Formatos disponíveis

Manual Técnico/Operacional do EasyCall Gate XML-RPC

para Sincronismo de Tela

Todos os direitos são reservados. É vedada, no todo ou em parte, a sua reprodução

Florianópolis, junho de 2014.

6. Eventuais intervenções por solicitação do cliente serão cobradas como serviços

neste documento que não estejam habilitados poderão ser adquiridos

 Flexibilidade no Layout: permite uma grande flexibilidade quanto ao layout

 TCP: Não é necessário preocupar-se com time-outs, retransmissões,

Uma chamada RPC pode ser direcionada a somente um servidor (unicast) ou a

O XML-RPC é baseado em chamadas do tipo HTTP - POST formado por requisições

Como exemplo, podemos utilizar um sistema típico cliente-servidor onde o cliente

ID_CHAMADA: Este campo é a identificação da chamada em andamento.

CAUSA_FALHA: Este campo indica a causa da falha da chamada: (DESISTENCIA

CONTA_AGENTE: Indica a conta do agente.

DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.

DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.

Observação: No caso de desistência em fila de grupo de uma chamada externa, a

DISPOSITIVO_TRANSFERIDOR: Indica o dispositivo que está executando a

ULTIMO_REDIRECIONAMENTO: Dispositivo que recebeu esta chamada antes de

 702: Não implementado.

 823: Senha Conta Inválida.

Assinante bloqueado ASSINANTE_BLOQUEADO

Causa desconhecida CAUSA_INVALIDA_FALHA

Chamada Cancelada DESISTENCIA

Chamada a cobrar CHAMADA_A_COBRAR

Chamada entrante, ramal ocupado FALHA_CHAMADA_RAMAL

Chamada grupo FALHA_CHAMADA_GRUPO

Congestionamento, linhas ocupadas FALHA_CONGESTIONAMENTO

Dispositivo sem créditos para gerar chamada

Falha ao obter linha FALHA_ALOCACAO_JUNTOR_CONFLITO

Falha ao receber fax FALHA_RX_FAX

Falha ao transmitir fax FALHA_TX_FAX

Falha ao veicular mensagem FALHA_VEICULACAO_MENSAGEM

Falha discagem externa FALHA_GERACAO

Falha nos links ou processadores FALHA_ALOCACAO_JUNTOR_LINK

Falha sinalização com central FALHA_SINALIZACAO

Não perturbe habilitado NAO_PERTURBE

Número discado incompleto FALHA_NUMERO_INCOMPLETO

Ramal bloqueado para as chamadas RAMAL_BLOQUEADO

Ramal inexistente FALHA_GERACAO_RAMAL

Sem linhas disponíveis FALHA_ALOCACAO_JUNTOR

Sem privilégio para estacionamento FALHA_ESTACIONAMENTO

Telefone inexistente DESTINO_INEXISTENTE

Telefone ocupado DESTINO_OCUPADO

<?xml version="1.0"?> <methodCall>

<methodResponse> <params> <param> <value><struct>

<?xml version="1.0"?> <methodCall>

Quando se opera com o estado monofone no gancho, deve-se atentar para um

Para que o dispositivo seja liberado, é necessário colocar o monofone no gancho.

Neste momento, a aplicação CTI recebe um comando

Você também pode gostar