mensagem fonadas processamento e envio de mensagens voz€¦ · tww.com. br rua do rocio, 220 - 6º...
TRANSCRIPT
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
Rua do Rocio, 220 - 6º andar. Vila Olímpia - São Paulo, SP CEP 04552-000 - Brasil [email protected]
+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.
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
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
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
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
Rua do Rocio, 220 - 6º andar. Vila Olímpia - São Paulo, SP CEP 04552-000 - Brasil [email protected]
+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
Rua do Rocio, 220 - 6º andar. Vila Olímpia - São Paulo, SP CEP 04552-000 - Brasil [email protected]
+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
Rua do Rocio, 220 - 6º andar. Vila Olímpia - São Paulo, SP CEP 04552-000 - Brasil [email protected]
+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
Rua do Rocio, 220 - 6º andar. Vila Olímpia - São Paulo, SP CEP 04552-000 - Brasil [email protected]
+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
Rua do Rocio, 220 - 6º andar. Vila Olímpia - São Paulo, SP CEP 04552-000 - Brasil [email protected]
+55 11 3444 5010
EnviaFonada – Envia uma mensagem voz. Retorna OK, NOK, Erro ou NA (não disponível).
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.
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.
Var3 – Do tipo STRING recebe um valor referente ao variável atribuída ao layout².
Var4 – 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²
Var6 – Do tipo STRING recebe um valor referente ao variável atribuída ao layout².
* – Os campos com asteriscos são obrigatórios.
¹ – 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.
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.
* – Os campos com asteriscos são obrigatórios.
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
StatusFonada - Retorna um DataSet chamado OutDataSet contendo a tabela StatusFonada com o status de
UMA MENSAGEM já transmitida. Retorna NULL em caso de erro.
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
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
Rua do Rocio, 220 - 6º andar. Vila Olímpia - São Paulo, SP CEP 04552-000 - Brasil [email protected]
+55 11 3444 5010
Tabela de Status de mensagens
Status de VOZ:
FC: Atendida
FN: Não Atendia
F1 – Atendida e digitou 1.
F2 – Atendida e digitou 2.
F3 – Atendida e digitou 3.
F4 – Atendida e digitou 4.
F5 – Atendida e digitou 5.
F6 – Atendida e digitou 6.
F7 – Atendida e digitou 7.
F8 – Atendida e digitou 8.
F9 – Atendida e digitou 9.
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
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
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