MENSAGEM FONADAS. Processamento e envio de mensagens VOZ

Transcrição

1 MENSAGEM FONADAS Processamento e envio de mensagens VOZ

2 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 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.

3 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 nesse ambiente encontrasse os arquivos de áudios e formatos de mensagem a serem enviados. Página de Interface WEB TWW Unimessage VOZ

4 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

5 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.

6 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.

7 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.

8 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.

9 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.

10 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

11 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 - Web Services Architecture - Consuming Web Services with the Microsoft.NET Compact Framework

12 Controle de Versão Versão Data Modificações /05/2013 Novo visual do documento (mudança de marca) Para maiores informações, comandos não descritos e solucionar quaisquer dúvidas, por favor, entrem em contato com: CService cservice@tww.com.br Tel: