Zenvia



Tutorial de Integra??oHTMLSumário TOC \h \z \t "Titulo;1" Tutorial de Integra??o - HTML PAGEREF _Toc336846297 \h 3Configurando Envio PAGEREF _Toc336846298 \h 4Enviando Múltiplas SMS PAGEREF _Toc336846299 \h 6Enviando Múltiplos SMS a partir de um arquivo CSV PAGEREF _Toc336846300 \h 7Glossário PAGEREF _Toc336846301 \h 8Tutorial de Integra??o - HTMLObjetivoO objetivo do tutorial de integra??o é guiar os desenvolvedores que desejam integrar suas aplica??es ao gateway de SMS da Zenvia, automatizando assim seus envios de SMS conforme sua necessidade.Mostraremos em simples passos como fazer seus sites em HTML enviarem SMS por meio da API de integra??o que disponibilizamos para facilitar os envios.Pré-requisitosPara executar a biblioteca, basta abrir os arquivos com qualquer navegador (Internet Explorer, Mozilla Firefox, Google Chrome, entre outros em quaisquer vers?es). A Zenvia recomenda o uso de navegadores mais atuais, tais como Internet Explorer 8 ou superior, Mozilla Firefox 3 ou superior, Google Chrome 8 ou superior.Entendendo a biblioteca HTMLA biblioteca HTML é composta de arquivos no formato HTML que fazem o acesso direto aos servi?os de SMS que a Zenvia disponibiliza, facilitando o uso pelos clientes. Cada arquivo HTML contém um acesso específico a um servi?o, que pode ser utilizado diretamente do seu site ou de seu computador para enviar SMS ou fazer consultas a status de envio. Pode-se também copiar seu código fonte e incluir dentro de uma página HTML que já exista.Configurando Envio1? PassoFa?a o download da biblioteca de integra??o por meio do link descompacte o conteúdo do arquivo dentro da pasta onde se encontr?o os arquivos do seu site ou em qualquer diretório de seu computador.2? PassoPara fazer o envio de SMS e/ou consultas ao gateway de SMS, ser?o necessárias algumas configura??es na tag FORM do arquivo, tais como:METHOD“POST”CHARSET"ISO-8859-1"ACTION“”ENCTYPE"application/x-www-form-urlencoded"ou em caso de envios de Mensagem de texto por arquivo:ENCTYPE"multipart/form-data"Exemplo:<form method="post" enctype="application/x-www-form-urlencoded" charset="ISO-8859-1"action="">Obs. As tags FORMs devem estar entre as tags BODY do código.Exemplo:<body...><form...></form></body>3? PassoPara qualquer opera??o do gateway de SMS, é preciso identificar-se com sua conta e código de acesso.Trabalharemos com dois campos de texto obrigatórios, que ter?o os nomes de account e code e que conter?o os valores da conta e do código de acesso. Tais dados s?o cedidos pela Zenvia juntamente com a negocia??o do contrato firmado com a empresa.Exemplo:<input type="text" name="account" /><input type="text" name="code" />Enviando Múltiplos SMS1? PassoTodos os campos a seguir dever?o estar entre as tags FORM.Um campo obrigatório, que também é comum a todos os servi?os que acessaremos com HTML, é o campo dispatch. Esse campo define o que a nossa página estará acessando no gateway de SMS da Zenvia. Esse campo deverá estar escondido, ou seja, deve ser do tipo hidden, para que n?o seja alterado, e deve ser chamado de dispatch. Para o envio múltiplo de SMS, o valor atribuído a esse campo deve ser sendMultiple.Exemplo:<input type="hidden" name=" dispatch " />2? PassoPara que possamos escolher o tipo de layout de mensagem que enviaremos, será necessária a inclus?o de um campo de sele??o com as op??es de acordo com os tipos de layouts aceitos pelo gateway de SMS.Esse campo deve conter obrigatoriamente as op??es A, B, C, D e E e o nome do campo deverá ser type.Exemplo:<select name="type"><option value="A">A - destino;mensagem</option><option value="B">B - destino;mensagem;origem</option><option value="C">C - destino;mensagem;id</option><option value="D">D - destino;mensagem;id;origem</option><option value="E">E - destino;mensagem;id;origem;data de agendamento</option></select>3? PassoAgora incluiremos o campo de texto que receberá o conteúdo da mensagem, número de telefone, entre outras informa??es, conforme a escolha do tipo de layout de mensagem.Basta incluir um campo do tipo textarea, com o nome list, e logo abaixo um bot?o para enviar as informa??es do formulário, do tipo submit.Exemplo:<textarea name="list"></textarea><input type="submit" />Enviando Múltiplos SMS a partir de um arquivo CSV1? PassoO envio de múltiplos SMS a partir de um arquivo CSV é muito semelhante ao envio de mensagens múltiplas a partir de uma string. A diferen?a básica é que, em vez de uma string, passaremos por par?metro o caminho do arquivo. Para isso, precisamos de um campo do tipo file, em vez de um campo textarea.Exemplo:<input type="file" name="file" />2? PassoDevemos agora trocar o valor par?metro enctype da tag form, de "application/x-www-form-urlencoded" para "multipart/form-data". Exemplo:<form method="post" enctype="multipart/form-data" charset="ISO-8859-1"action="">GlossárioItemPropriedadeDescri??o1StringConjunto de caracteres.2Tipos de layoutTipo A: to;messageTipo B: to;message;fromTipo C: to;message;idTipo D: to;message;id;fromTipo E: to;message;from;id;schedule ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download