Академический Документы
Профессиональный Документы
Культура Документы
© 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
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
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
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
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
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.
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.
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.
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
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
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
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
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
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
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
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
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.
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
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
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
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
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
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.
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.
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.
INFORMAÇÃO PÚBLICA 44