MENSAGEM FONADAS Processamento e envio de mensagens … · Rua do Rocio, 220 - 6º andar. Vila...

TWW.COM. BR

Rua do Rocio, 220 - 6º andar. Vila Olímpia - São Paulo, SP CEP 04552-000 - Brasil [email protected]

+55 11 3444 5010

MENSAGEM FONADAS

Processamento e envio

de mensagens VOZ

TWW.COM. BR


+55 11 3444 5010

Integração Unimessage

Existem várias formas de integração ao sistema TWW Unimessage, através de vários meios de comunicação como links de dados dedicados e internet. O sistema TWW Unimessage provê comunicação interativa de forma fácil, com qualidade e alta disponibilidade oferecendo o protocolo padrão da indústria de telecomunicações: Web Services, além de grande maleabilidade quando é necessária a comunicação via protocolos proprietários e customizados. Neste caso, a TWW oferece todo o suporte necessário à equipe de desenvolvimento do cliente para uma integração tranqüila. As mensagens são enviadas diretamente para o número de telefone de destino, e todas as mensagens processadas ficam armazenadas e contabilizadas no registro ( ID ) do cliente.

TWW Unimessage Webservices

Os webservices proporcionam um meio padronizado para a integração entre diferentes aplicações que podem estar rodando em uma variedade de plataformas. A integração pode ser feita utilizando.NET, Java, PHP, entre outras linguagens. Para facilitar a integração o sistema oferece o WSDL ( Linguagem de descrição dos webservices ) que pode ser acessado diretamente do ambiente de programação. ) Disponível em alguns sistemas de desenvolvimento como o .NET

Integração Unimessage Webservices

A integração com o sistema TWW Unimessage é feita através de XML “Web Services”, via internet ou link dedicado. No endereço http://webservices.fonadas.tww.com.br/ws/ está lista de comandos disponíveis para comunicação com o sistema. A visualização dos detalhes, exemplos de métodos GET, POST e, SOAP, além da possibilidade de execução de testes, pode ser feita através de navegadores como, por exemplo, MS Internet Explorer, Mozilla Firefox ou Safari.

http://webservices.fonadas.tww.com.br/ws/

TWW.COM. BR


+55 11 3444 5010

O endereço IP da máquina do cliente, que acessará os webservices deve ser informado préviamente à TWW para liberação no firewall. O acesso deve ser feito através de login ( ID do cliente ) e senha. O cadastro deve ser solicitado através do departamento comercial da TWW.

Introdução TWW Unimessage VOZ

TWW Unimessage VOZ utiliza as mensagens previamente cadastras na Interface Web disponível http://fonadas.tww.com.br, nesse ambiente encontrasse os arquivos de áudios e formatos de mensagem a serem enviados.

Página de Interface WEB TWW Unimessage VOZ

http://fonadas.tww.com.br/

TWW.COM. BR


+55 11 3444 5010

Controle de acesso.

Pagina Principal

Adicionando Arquivos de Áudio.

Para adicionar os arquivo áudio acesso MENU -> Minhas Gravações. Clique em “Selecionar Arquivo” e localize o arquivo de áudio em seu computador e click em enviar

TWW.COM. BR


+55 11 3444 5010

Os arquivos de áudio devem estar no formato WAV (Waveform Audio File Format) 16 bit 8000 Hz mono.

Criando Áudio com TTS.

O TTS (Text To Speech) permite que o usuário possa criar arquivos através da inserção de texto e assim reproduzir a fala humana.

TWW.COM. BR


+55 11 3444 5010

Para utilizar o TTS acesso MENU -> Minhas Gravações, Clique em “CRIAR”, Após a abertura da nova janela, informe o nome do arquivo de áudio e digite a mensagem, clique em Gravar e após a confirmação clique em Play para ouvir a gravação.

TWW.COM. BR


+55 11 3444 5010

Criando Novas Mensagens.

Uma mensagem é composta por um ou mais arquivos de áudio e variáveis, é usada para referenciar-se ao envio em

lote e por Webservices através do IdLayout.

A TWW disponibiliza em sua plataforma modelos padronizados de mensagem previamente estabelecidos podendo

conter até oito arquivos de áudio e seis variáveis. É possível a customização de mensagem para campanhas especificas

mediante analise técnica da TWW, após a aprovação, o novo layout será disponibilizado na interface WEB junto às

demais mensagens.

Para criar uma nova mensagem acesse MENU -> Minhas Mensagens e clique no botão Criar uma nova Mensagem,

adicione o nome que desejar e selecione o tipo de layout da mensagem, ao terminar clique em “Criar”.

TWW.COM. BR


+55 11 3444 5010

Ao termino da operação é gerado para cada mensagem criada um identificador único chamado de IdLayout utilizado

para envio via integração por Web Services.

Página de Serviços WEB TWW Unimessage CAP

Comandos Disponíveis:

BuscaFonadas- Retorna um DataSet chamado OutDataSet contendo uma Tabela chamada BuscaFonada

com TODAS AS MENSAGEM ENVIDAS. Retorna NULL em caso de erro.

Exemplos do método SOAP na interface web.

Campos necessários:

NumUsu* – Login ( ID ), com até 10 caracteres alfa-numéricos, no sistema Unimessage, fornecido

pela TWW.

Senha* – Com até 18 caracteres alfanuméricos.

DataIni * - Do tipo DATETIME, que deve ser preenchido no formato ANSI: “YYYY-MM-DD HH:MM:SS”.

DataFim* - Do tipo DATETIME, que deve ser preenchido no formato ANSI: “YYYY-MM-DD HH:MM:SS”.

* – Os campos com asteriscos são obrigatórios.

TWW.COM. BR


+55 11 3444 5010

EnviaFonada – Envia uma mensagem voz. Retorna OK, NOK, Erro ou NA (não disponível).


NumUsu* – Login ( ID ), com até 10 caracteres alfa-numéricos, no sistema Unimessage, fornecido pela

TWW.


SeuNum - Este campo é um número ou cadeia de caracteres alfanuméricos com até 10 caracteres que é

gerado pelo usuário e, armazenado junto com a mensagem, para ser utilizado no retorno em pesquisas,

sendo que pode ser utilizado na busca de mensagens individuais. Não é obrigatoriamente seqüencial, e

pode ser repetido.

DataAgendamento - Do tipo DATETIME, que deve ser preenchido no formato ANSI: “YYYY-MM-DD HH:MM:SS”.

Telefone* - (DDNNNNNNNN) – Número do celular de destino da mensagem, onde D = Código de área

e N = Número do celular

Retry – Do tipo INT recebe a quantidade de vezes que a mensagem deve ser discada enquanto não

atendida.

Retrytime – Do tipo INT, recebe o tempo em minutos que a próxima tentativa deve ser efetuada quanto

o telefone não atendido. Esse campo é descartado quanto o campo Retry não é preenchido ou menor que

1.

IdLayout* – Do tipo INT recebe o id da mensagem previamente criada na interface do usuário¹.

Var1 – Do tipo STRING recebe um valor referente ao variável atribuída ao layout².

Var2 – Do tipo STRING recebe um valor referente ao variável atribuída ao layout.



Var5 – Do tipo STRING recebe um valor referente ao variável atribuída ao layout²



¹ – O layout da mensagem deve ser previamente criado na interface WEB tal como descritos em X

² – As variáveis de mensagem são definidas na criação da mensagem na interface WEB

Retorna uma string com um dos valores abaixo:

OK – Mensagem aceita para transmissão

NOK – Mensagem não aceita para transmissão. Pode ser causado por preenchimento indevido dos

campos do formulário. Exemplo: Usuário ou senha inválidos, Numero de Telefone Invalido,

IdLayout inexistente.

Erro NA (não disponível) – Sistema não disponível

ListaMensagens - Retorna um DataSet chamado OutList contendo uma Tabela chamada layouts com as

MENSAGEM DISPONÍVEIS previamente cadastras na interface WEB¹ para envio. Retorna NULL em caso de

erro.



TWW.



TWW.COM. BR


+55 11 3444 5010

StatusFonada - Retorna um DataSet chamado OutDataSet contendo a tabela StatusFonada com o status de

UMA MENSAGEM já transmitida. Retorna NULL em caso de erro.



TWW.

Senha* – Com até 18 caracteres alfanuméricos

Seunum* - Este campo é um número ou cadeia de caracteres akfanuméricos com até 10 caracteres que

é gerado pelo usuário e, armazenado junto com a mensagem, para ser utilizado no retorno em pesquisas,

sendo que pode ser utilizado na busca de mensagens individuais. Não é obrigatóriamente seqëncial, e

pode ser repetido.

* – Os campos com asteriscos são obrigatórios

TWW.COM. BR


+55 11 3444 5010

Tabela de Status de mensagens

Status de VOZ:

FC: Atendida

FN: Não Atendia

F1 – Atendida e digitou 1.









OK: Pendente de envio

CA: Cancelada pelo usuário

CE: Cancelado no envio

Procedimentos para integração de sistemas

Sugerimos que o processo de integração seja efetuado seguindo os passos abaixo:

1- Desenvolvimento do cliente para consumo do método webservice desejado.

2- Testes iniciais de integração ( utilizando conta “dummy” )

3- Testes de carga para verificação de troughput e qualidade da comunicação ( “utilizando conta dummy”)

4- Piloto de produção

5- Entrada em produção

Para todas as fases da integração oferecemos acompanhamento, mediante agendamento prévio.

Aviso: Por se tratar de comunicação via internet, a performance de envio e a disponibilidade podem sofrer

variações resultantes de falhas ou sobrecarga em links e equipamentos de rede entre o cliente e a TWW.

Sugerimos fortemente que sejam efetuados os testes de comunicação e carga utilizando a conta dummy.

Os dados de login e senha são fornecidos no momento do início do projeto de integração.

Referencias

http://www.w3.org/TR/ws-arch/ - Web Services Architecture

http://msdn.microsoft.com/en-us/library/aa446547.aspx - Consuming Web Services with the Microsoft .NET Compact

Framework

http://www.w3.org/TR/ws-arch/

http://msdn.microsoft.com/en-us/library/aa446547.aspx

TWW.COM. BR


+55 11 3444 5010

Versão Data Modificações

1.0 07/05/2013 Novo visual do documento (mudança de marca)

Controle de Versão

Para maiores informações, comandos não descritos e solucionar quaisquer dúvidas, por favor, entrem em contato com: CService

[email protected] Tel: 55 11 3444-5010

MENSAGEM FONADAS Processamento e envio de mensagens … · Rua do Rocio, 220 - 6º andar. Vila...

Documents

Transcript of MENSAGEM FONADAS Processamento e envio de mensagens … · Rua do Rocio, 220 - 6º andar. Vila...