Você está na página 1de 44

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.

INFORMAÇÃO PÚBLICA 6
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Sobre este Documento
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.

INFORMAÇÃO PÚBLICA 7
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Sobre este Documento
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

INFORMAÇÃO PÚBLICA 8
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Sobre este Documento
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.
.

INFORMAÇÃO PÚBLICA 9
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.
INFORMAÇÃO PÚBLICA 10
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.

INFORMAÇÃO PÚBLICA 11
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.

INFORMAÇÃO PÚBLICA 12
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.

INFORMAÇÃO PÚBLICA 13
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.

INFORMAÇÃO PÚBLICA 14
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.

CMD: "EVENTO_MODO_DO_MONOFONE"
Descrição evento: Esta função reporta o modo de operação do monofone.
PROXIMO_EVENTO: Próximo evento a requisitar.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
MODO_DO_MONOFONE: Indica o modo de funcionamento do dispositivo:
(NO_GANCHO / FORA_DO_GANCHO_ATEND_MANUAL /
FORA_DO_GANCHO_ATEND_AUTOM)

INFORMAÇÃO PÚBLICA 15
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada que está sendo
monitorada.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada que está sendo
monitorada.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
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).

INFORMAÇÃO PÚBLICA 16
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada em andamento.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.

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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada em andamento.
DISPOSITIVO_EVENTO: Indica o dispositivo que esta recebendo o evento.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.
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.
PROXIMO_EVENTO: Próximo evento a requisitar.

INFORMAÇÃO PÚBLICA 17
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Método XML-RPC
disponível
CAPÍTULO 3

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


DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
DADOS: Dados associados à chamada.

CMD: "EVENTO_DE_COMPLETAMENTO"
Descrição evento: Esta função reporta o completamento de uma chamada.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada em andamento.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na 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.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
CATEGORIA: Indica a categoria da identidade associada.
DADOS: Dados associados à chamada.

INFORMAÇÃO PÚBLICA 18
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada em andamento.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.
DISPOSITIVO_ACAO: 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.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
DADOS: Dados associados à chamada.

CMD: "EVENTO_DE_FALHA"
Descrição do Evento: Esta função reporta um evento de falha na geração de uma
chamada.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada na qual houve algum
problema.
DISPOSITIVO_EVENTO: Indica o dispositivo que esta recebendo o evento.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
INFORMAÇÃO PÚBLICA 19
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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)
DADOS: Dados associados a chamada. (Limite de 100 caracteres)

CMD: EVENTO_DE_NOVOS_DADOS_ASSOCIADOS"
Descrição evento: Esta função reporta um evento de novos dados associados à
chamada em curso.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada em andamento.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
DADOS: Dados associados à chamada.

CMD: "EVENTO_DE_AGENTE"
Descrição evento: Esta função reporta o estado de um agente.
PROXIMO_EVENTO: Próximo evento a requisitar.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.

INFORMAÇÃO PÚBLICA 20
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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 (,).
DISPOSITIVO_ACAO: Indica o dispositivo que requisitou o serviço.
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada colocada em espera.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
DISPOSITIVO_ACAO: Indica o dispositivo que requisitou o serviço.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
DADOS: Dados associados à chamada.

CMD: "EVENTO_DE_RETRIEVE"
Descrição evento: Esta função reporta a saída de música (hold) de uma chamada
no dispositivo.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada retirada da espera.

INFORMAÇÃO PÚBLICA 21
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Método XML-RPC
disponível
CAPÍTULO 3

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


DISPOSITIVO_ACAO: Indica o dispositivo que requisitou o serviço.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
DADOS: Dados associados à chamada.

CMD: "EVENTO_DE_REDIRECIONAMENTO"
Descrição evento: Esta função reporta o redirecionamento de uma chamada de um
dispositivo para outro.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada redirecionada.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
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.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
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)
DADOS: Dados associados à chamada.
INFORMAÇÃO PÚBLICA 22
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada em andamento.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada em andamento.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
CIFRAS_DTMF: Indica as cifras DTMF enviadas ou detectadas.

INFORMAÇÃO PÚBLICA 23
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada capturada.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.
DISPOSITIVO_CAPTURADO: Indica o dispositivo que foi capturado.
DISPOSITIVO_ACAO: Indica o dispositivo que requisitou o serviço.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
DADOS: Dados associados à chamada.

CMD: "EVENTO_DE_CHAMADA_CAPTURADA"
Descrição evento: esta função reporta que o ramal capturopu uma chamada com
sucesso.
PROXIMO_EVENTO: Próximo evento a requisitar.
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_EVENTO: Indica o dispositivo que está recebendo o evento.
DISPOSITIVO_CAPTURADO: Indica o dispositivo que foi capturado.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
DADOS: Dados associados à chamada (Limite de 100 caracteres).
INFORMAÇÃO PÚBLICA 24
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
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_EVENTO: Indica o dispositivo que está recebendo o evento.
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.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada em finalização.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
DISPOSITIVO_ACAO: Indica o dispositivo que requisitou o serviço.
DISPOSITIVO_ONHOOK: Indica o dispositivo que colocou o headset no gancho.

INFORMAÇÃO PÚBLICA 25
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Método XML-RPC
disponível
CAPÍTULO 3

DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.


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)
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
DADOS: Dados associados à chamada.

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.
PROXIMO_EVENTO: Próximo evento a requisitar.
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.
DISPOSITIVO_EVENTO: Indica o dispositivo que esta recebendo o evento.

INFORMAÇÃO PÚBLICA 26
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
CAUSA_TRANSF: Este campo indica a causa da transferência:
(TRANSF_CHAMANDO/ TRANSF_ATENDIDO/ TRANSF_IMEDIATA/
CAUSA_INVALIDA_TRANSF)
DADOS: Dados associados a chamada. (Limite de 100 caracteres)
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada que entrou na fila do
dispositivo.
DISPOSITIVO_EVENTO: Indica o dispositivo que esta recebendo o evento.
TAMANHO_FILA: Indica o tamanho da fila no dispositivo.
POSICAO_NA_FILA: Indica a posição na fila em que o dispositivo se encontra.
DISPOSITIVOS_ASSOCIADOS: Lista com os dispositivos presentes na chamada.
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
NUMERO_ORIGINADOR: É o número do originador.
NUMERO_DISCADO_ORIGINAL: É o número discado.
INFORMAÇÃO PÚBLICA 27
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Método XML-RPC
disponível
CAPÍTULO 3

ULTIMO_REDIRECIONAMENTO: Dispositivo que recebeu esta chamada antes de


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.
PROXIMO_EVENTO: Próximo evento a requisitar.
ID_CHAMADA: Este campo é a identificação da chamada que saiu da fila do
dispositivo.
DISPOSITIVO_EVENTO: Indica o dispositivo que está recebendo o evento.
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 .
TRONCOS_ASSOCIADOS: Indicação dos troncos associados ao evento gerado.
NUMERO_ORIGINADOR: É o número do originador da chamada.
NUMERO_DISCADO_ORIGINAL: É o número discado.
ULTIMO_REDIRECIONAMENTO: Dispositivo que recebeu esta chamada antes de
redirecionar.
DADOS: Dados associados à chamada.

INFORMAÇÃO PÚBLICA 28
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
PROXIMO_EVENTO: Próximo evento a requisitar.
DISPOSITIVO_EVENTO: Indica o dispositivo que esta recebendo o evento.
CONTA_AGENTE: Indica a conta do agente.
DISPOSITIVO_ACAO: Indica o dispositivo que requisitou o serviço.
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)

INFORMAÇÃO PÚBLICA 29
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.
INFORMAÇÃO PÚBLICA 30
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.
INFORMAÇÃO PÚBLICA 31
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Falhas nas Requisições
XML-RPC
CAPÍTULO 4

 823: Senha Conta Inválida.


 899: Erro de Pabx Genérico.

INFORMAÇÃO PÚBLICA 32
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.

INFORMAÇÃO PÚBLICA 33
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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

INFORMAÇÃO PÚBLICA 34
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Descritivo das Causas do
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.

INFORMAÇÃO PÚBLICA 35
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Descritivo das Causas do
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.

INFORMAÇÃO PÚBLICA 36
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Descritivo das Causas do
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.

INFORMAÇÃO PÚBLICA 37
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
Descritivo das Causas do
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.

INFORMAÇÃO PÚBLICA 38
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>
INFORMAÇÃO PÚBLICA 39
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.

INFORMAÇÃO PÚBLICA 40
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

INFORMAÇÃO PÚBLICA 41
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.

INFORMAÇÃO PÚBLICA 42
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
INFORMAÇÃO PÚBLICA 43
DÍGITRO: INTELIGÊNCIA – TI - TELECOM MANUAL DO USUÁRIO | EASYCALL GATE XML-RPC PARA SINCRONISMO DE TELA
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.

INFORMAÇÃO PÚBLICA 44