Manual de Utilização Serviço de SMS

Revisão 1.8

ByJG.com.br http://www.smswebservice.com.br

Página: 1

Histórico de Revisões
Revisão 1. 1.1 1.! 1.+ 1., 1.# 1.1 1.7 1.8 1.$ Data !/1!/! #/ 1/! ! / 1/! !,/ 1/! 1/ ,/! ,/ 8/! + / 8/! ! / $/! $/ 7/! 1 18/1 /! 1 8 $ $ $ $ $ $ $ Histórico Primeira revisão do doc"mento Pe%"enas corre&ões de te'to no doc"mento (crescentado o servi&o atrav)s de chamadas H**P -nc."são do (ne'o + %"e trata sobre o envio de /0/ e d)bito de cr)ditos (.tera&ão no endere&o do servi&o (.tera&ão no te'to do b".2 spam e inc."são de novas 3"nciona.idades da 3erramenta de administra&ão. (dicionado o par4metro /ender-D ao m)todo enviar/0/56 (crescentado os m)todos do 8eb/ervice: enviar9ista/0/: creditos e rec"rsos; <ovas mensagens de erro. (crescentado o m)todo agendar=nvio; <ovas mensagens de retorno do /0/; (t"a.i>a&ão das te.as e da 3erramenta de administra&ão. (crescentada novas mensagens do sistema

ByJG.com.br http://www.smswebservice.com.br

Página: !

........................................................................................................11 =nvio de /0/ 0D...................11 (gendamento......................................................................................................................br Página: + ..... Bons".........................................................................................................................................................!! (<=EF ! H *ratamento retorno mensagens H**P..............................................................................has de envio.............................................................................................1 Dados do /ervi&o...............! 0ensagens de /"cesso de =nvio.................................o.........................a -nicia.........!+ *ratamento do /tring de Retorno........................!1 $'' H 0ensagens do /istema....................................................................................................................# 8eb 0)todos....................................................................................................1 enviar/0/56...........................................................................................! .......................................!........................................................................................................17 Revenda de /0/...com............................................................................................................................................................................. *e............................................................................................!................................................................11 -mportando Bontatos /0/ para a Cerramenta 8=@...................... PossJveis 3a....................1 obterAersao56......................................................................................................................................................................# ?ti..............................................................$ ?ti.............................................................!+ (<=EF + H =nvio de /0/ e d)bito de Br)ditos..........................................br http://www............tip..............7 creditos56.................................................7 rec"rsos56.....os de 9oo2 and Cee..........................................................!+ *ratamento do /tring de Retorno se 3or "m arraI....................................!1 1'' G 0ensagens de agendamento.................................1! Cerramenta de (dministra&ão 8=@...........1# @"sca na (genda....................................................................!# ByJG....................................................................................................................................................................................'' G 0ensagens de a"tentica&ão e cr)ditos.......................................i>ando o servi&o como 8=@ /=RA-B=............................................................................................................................. c"stomi>ados.......................................................................1! agendar=nvio56.....................................................18 ='emp.................................................................................................................# ?sos do /ervi&o......................................18 (<=EF 1 G 0ensagens de Retorno do /ervi&o..................................................................................................!+ Cormato de Retorno....! #'' G 0ensagens de va..................................Sumário Descri&ão do /ervi&o...1 enviar/0/56...........................................................# Dados do /ervi&o...com.............................................................ta de Br)ditos......ida&ão...................1.................................................................................................1..........................................................................11 Bontatos /0/..........................................1 H**P 0etódos....................smswebservice................................................................................................i>ando o servi&o atrav)s de H**P................................................................................1 enviar/0/-nternaciona...1 obterAersao56.................................................................................................................................................................................................................................. =nvio de /0/ -ndivid"a.................................................................56.............................................................................................................................. =vitar /pam por /0/................................................................11 enviar9ista/0/56...........................................................................................................56......8 agendar=nvio56...............8 enviar9ista/0/56..............1..............................................................................1 enviar/0/-nternaciona...................11 creditos56.............................................11 rec"rsos56......................................................

com.ica&ão de envio de /0/ pode ser chamada atrav)s de 8eb /ervice.com.br Página: . .ing"agens: ● Ais"a. @asic.i>ar a inter3ace de 8eb /ervice o mesmo pode ser incorporado em %"a. e do m"ndo.br/site/webservice.ica&ão6 http://www.ing"agem de programa&ão com s"porte ao protoco.smswebservice. integra&ão com a ap.a direta 0"itos o"tros "sos Utilizando o serviço como WEB SER !"E ( ap.bILg.itam "ma integra&ão rápida e com bai'o c"sto K s"a ap. ( maioria das -D= de programa&ão: criam "ma camada de 3áci.ita o envio de mensagens de te'tos /0/ 5*orpedos6 para %"a. = o 8eb /ervice "ti.ica&ão: não importa a . Por "ti. /endo assim ) necessário %"e seLa adicionado ao se" proLeto a re3erMncia do servi&o de /0/.phi ● Co' Pro ● Ais"a.%"er ap.%"er ce.".ing"agem %"e a s"a ap.g"ma ocorrMncia no sistema =nvio de mensagens de con3irma&ão do nDmero do ce.ica&ão.com.<=* e Bsharp ● De.Descrição do Serviço F /0/ 8eb /ervice ) "m servi&o inovador %"e possibi.i>a m)todos simp.o /F(P. F 8eb /ervice ) s"portado por %"a.ar =nvio de mensagens diárias: semanais e mensais Aa.php/ws/sms Descritor do /ervi&o 58/D96 5"se este a%"i para adicionar a re3erMncia em s"a ap.ica&ão 3oi desenvo. @asic 1 5Bom o /oap *oo.com.erta de a.es %"e possibi.bILg. (.vida.". Nit6 ● etc Dados do Serviço O necessário as seg"intes in3orma&ões: =ndere&o do /ervi&o http://www.br/site/webservice.ida&ão de "s"ários 0a.erta de eventos 3"t"ros (.ica&ão: ● ● ● ● ● ● ● (.g"ns "sos do /0/ 8eb /ervice na s"a ap.%"er .br http://www. Usos do Serviço AeLa a.ar do @rasi.php/ws/smsP8/D9 ByJG.g"mas .ica&ão.

enviar/0/5T!1T: T$$$$$$$$T: T*este 0sgT: T"s"arioT: TsenhaT6.t6.t Q smsweb.br http://www.ha.o: !1: 71: 11: etc ● ce.8rite9ine5T/"cessoT6. ='emp.com. de acordo com os dados 3ornecidos.".t.e.com. <ote %"e a mensagem deve conter no má'imo 11 caracteres.".ar a receber o /0/.8rite9ine5TCa. Fs acentos serão despre>ados ● "s"ario: F "s"ário do servi&o ● senha: ( senha do "s"ário do servi&o ● /ender-D 5opciona.it5T:T6.".Web Métodos obterVersao() Descri&ão: ● Devo. =sse servi&o deve ser contrato K parte.ve a versão do 8eb /ervice Par4metros de =ntrada: ● <enh"m Retorno ● ( versão at"a.i>a&ão ● string s Q smsweb. stringUV resp Q res". do 8eb /ervice ='emp. e. Par4metros de =ntrada: ● ddd: F código de área do ce.se Bonso. T X res".i>a&ão ● string res".br Página: # . ByJG. enviarSMS() Descri&ão: ● Permite enviar "m /0/ para ce.sp. i3 5respU V QQ W W6 Bonso.e.ar: F nDmero de ce. Retorno ● ( sit"a&ão do envio no 3ormato Rcodigo: mensagemS.ares do @rasi.smswebservice.".6: Permite m"dar o /ender-D %"e será enviado na mensagem: o" seLa o remetente.o de ?ti.obterAersao56.o de ?ti. ='emp. Deve ter 8 digitos: sem espa&os o" tra&os ● mensagem: ( mensagem %"e deverá ser enviada.ar.

enviarSMSInternacional() Descri&ão: ● Permite enviar "m /0/ para ce.o de ?ti.ar.". <ote %"e a mensagem deve conter no má'imo 11 caracteres.".ares do @rasi.sp. Deve ter 8 digitos: sem espa&os o" tra&os ● mensagem: ( mensagem %"e deverá ser enviada. stringUV resp Q res". de acordo com os dados 3ornecidos. e.br Página: 1 .". ByJG.ar.smswebservice.ha.br http://www. Par4metros de =ntrada: ● codPais: F código do paJs %"e está o ce. ='emp. T X res".".idade.com.o: ## para o @rasi. i3 5respU V QQ W W6 Bonso.t Q smsweb.e.: 1 para os =stados ?nidos e etc.com.o: !1: 71: 11: etc ● ce.enviar/0/5T1T: T!8#T: T$$$$$$$$T: T*este 0sgT: T"s"arioT: TsenhaT6. ='emp.it5T:T6.ar: F nDmero de ce.8rite9ine5TCa.8rite9ine5T/"cessoT6. creditos() Descri&ão: ● Fbt)m os cr)ditos restantes e a data de e'pira&ão Par4metros de =ntrada: ● "s"ario: F "s"ário do servi&o ● senha: ( senha do "s"ário do servi&o Retorno ● ?m (rraI contendo os cr)ditos disponJveis para a s"a conta.$ :! 1 G !G!# : : ● <a resposta: .ar a receber o /0/.t. ● ddd: F código de área do ce.i>a&ão ● string res".t6. Por e'emp.$ ) %"antidade de cr)ditos restantes e ! 1 ) data de va.e. =': (RR(YZ1Z.se Bonso. Fs acentos serão despre>ados ● "s"ario: F "s"ário do servi&o ● senha: ( senha do "s"ário do servi&o Retorno ● ( sit"a&ão do envio no 3ormato Rcodigo: mensagemS.".

Fs acentos serão despre>ados ● "s"ario: F "s"ário do servi&o ● senha: ( senha do "s"ário do servi&o ● /ender-D 5opciona.t6.8rite9ine5respUiX+V6. =nvie "m te'to va>io no se" ."..sp.t Q smsweb.6: Permite m"dar o /ender-D %"e será enviado na mensagem: o" seLa o remetente.iXX6 [ Bonso. F 3ormato deve ser: B=9?9(RZB=9?9(RZB=9?9(R.ista dos rec"rsos disponJveis em s"a conta.ar deve ter o DDDX<"mero: e'emp.it5TZT6.recursos() Descri&ão: ● Fbt)m os rec"rsos habi.8rite9ine5TCa..aro:Aivo:n/0/:Cast:1/0/:/ender-D:/"p.br Página: 7 . =sse comando a"menta considerave.e."gar. <ote %"e a mensagem deve conter no má'imo 11 caracteres.e. ● =': (RR(YZ!Z!1$$$$1111Q Z!18888!!!!Q ='emp. ] e.ista: Fs nDmeros de ce.ares aos %"ais se deseLa enviar o /0/. enviarListaSMS() Descri&ão: ● Permite enviar vários /0/ de "ma Dnica ve>. ByJG. T X res".enviar9ista/0/5T!1$$$$1111Z!18888!!!!T: T0sgT: T"s"arioT: TsenhaT: TT6.itados na s"a conta. Par4metros de =ntrada: ● "s"ario: F "s"ário do servi&o ● senha: ( senha do "s"ário do servi&o Retorno ● ?ma =': .com.o: !1$$$$1111.o de ?ti.com.mente a %"antidade de /0/ enviados por seg"ndo. : *im:Fi:B. stringUV resp Q res".se Bonso. =sse servi&o deve ser contrato K parte.. i\Bonvert. F nDmero do ce.".i>a&ão ● string res".smswebservice. Retorno ● ?m (rraI com a resposta.ha.br http://www.*o-nt+!5respU!V6. i3 5respU V QQ W(RR(YW6 [ 3or5int i Q . ● mensagem: ( mensagem %"e deverá ser enviada.Portab. Par4metros de =ntrada: ● .t.

● repeticoes: 5opciona.br http://www. ByJG.smswebservice.ar: F nDmero de ce. Fs acentos serão despre>ados ● "s"ario: F "s"ário do servi&o ● senha: ( senha do "s"ário do servi&o ● data: ( data %"e será enviado o /0/. ='emp. ● periodo: 5opciona.o: ! 1 / 7/ $. <ote %"e a mensagem deve conter no má'imo 11 caracteres.ha.".se Bonso. a "nidade de repeti&ão "ti.6 /e preenchido: indicará %"a.o se periodo 3or D e 3re%"encia 3or !: indica %"e o sistema irá repetir o envio a cada ! dias. Deve ser D 5dias6 o" H 5horas6 o" "m string va>io.o: !1: 71: 11: etc ● ce.i>ada na 3re%"Mncia.sp.".8rite9ine5TCa. Por e'emp.6: Permite m"dar o /ender-D %"e será enviado na mensagem: o" seLa o remetente.e.o de ?ti.i>a&ão ● string res". Por e'emp. e. ='emp.e.o: $:+ o" 1+:# . ( data deve estar no 3ormato ((((/00/DD onde (((( ) o ano: 00 ) o mMs e DD ) o dia. Retorno ● ( sit"a&ão do agendamento no 3ormato Rcodigo: mensagemS.t Q smsweb. ● hora: ( hora %"e o /0/ será enviado.ar.6.ar a receber o /0/.it5T:T6. stringUV resp Q res". Deve ter 8 digitos: sem espa&os o" tra&os ● mensagem: ( mensagem %"e deverá ser enviada. T X res". ● /ender-D 5opciona.".t6.br Página: 8 .agenda=nvio5T!1T: T$$$$$$$$T: T*este 0sgT: T"s"arioT: TsenhaT: T! 1 / 7/ $T: T1#: T6.8rite9ine5T/"cessoT6.com. Por e'emp.agendarEnvio() Descri&ão: ● Permite agendar o envio de /0/ atrav)s de nossa inter3ace. ?m nDmero %"e indica a 3re%"Mncia de repeti&ões.com. i3 5respU V QQ W1 W6 Bonso. ● 3re%"encia: 5opciona. ( hora deve estar no 3ormato HH:00 onde HH ) a hora 5 a !+6 e 00 ) o min"to.6 ^"antas ve>es o sistema irá repetir o envio respeitando o periodo e 3re%"encia de3inida acima.t. Par4metros de =ntrada: ● ddd: F código de área do ce. =sse servi&o deve ser contrato K parte.

". (s mensagens de retorno são e'atamente ig"ais aos do 8eb /ervice. O "m m)todo mais tradiciona.ar mensagem Aa.br http://www.o navegador: ar%"ivos de 9ote: /he. /e" "s"ário /"a senha Fpciona. /cript: 8indows /cript: ap. "s"ario senha senderid Retorno FNZ1: 3ai.Utilizando o serviço atrav#s de $%%& ( o"tra moda.smswebservice.or obterversao enviarSMS() Par4metro httpmethod ddd ce. : etc.idade para e'ec"tar o servi&o ) atrav)s de chamadas H**P. Dados do Serviço F endere&o do servi&o ) o mesmo do 8eb/ervice.ica&ões (/P +.bILg."re FNZcod: mensagem ByJG. ( di3eren&a neste caso: ) %"e devemos 3a>er "ma re%"isi&ão _=* o" PF/* ao endere&o passando obrigatoriamente o par4metro RhttpmethodS: onde httpmethod ) "m dos m)todos disponJveis no 8eb/ervice. e a"menta as possibi.br Página: $ .com.or enviarsms /tring de ! caracteres /tring de 8 caracteres 0ensagem de 11 caracteres. Fbserva&ão: /e esse par4metro 3or enviado atrav)s de _=*: ) necessário 3a>er o ?R9 encode.com.idades de e'ec"&ão do servi&o.. (s chamadas H**P aceitam os m)todos _=* e PF/*: e podem ser chamados diretamente pe.com.br/site/webservice. =ndere&o do /ervi&o http://www.#.. Aa.php/ws/sms HTTP Metódos obterVersao() Par4metro httpmethod Retorno: FNZ .

com.Portab.br Página: 1 . : : recursos() Par4metro httpmethod "s"ario senha Aa.enviarSMSInternacional() Par4metro httpmethod codpais ddd ce. ByJG.ar mensagem Aa."re FNZcod: mensagem creditos() Par4metro httpmethod "s"ario senha Aa.o: ##: 1: etc. /e" "s"ário /"a senha "s"ario senha Retorno FNZ : s"ccess FNZ1: 3ai.smswebservice. ='emp. /tring de ! caracteres /tring de 8 caracteres 0ensagem de 11 caracteres.$ :! 1 G !G!# : : Z#:! 1 G +G .".com.or rec"rsos /e" "s"ário /"a senha Retorno FNZ : *im:Fi:B.br http://www. Fbserva&ão: /e esse par4metro 3or enviado atrav)s de _=*: ) necessário 3a>er o ?R9 encode.or enviarsmsinternaciona.aro:Aivo:n/0/:Cast:1/0/:/ender-D:/"p.or creditos /e" "s"ário /"a senha Retorno FNZ(RR(YZ!Z. /tring com o código do paJs.

com.6. ( hora %"e o /0/ será enviado.6 /e preenchido: indicará %"a. /e" "s"ário /"a senha Fpciona. Por e'emp.i>ada na 3re%"Mncia.".or enviar. F ce. ( data deve estar no 3ormato ((((/00/DD onde (((( ) o ano: 00 ) o mMs e DD ) o dia.". mensagem "s"ario senha senderid Retorno FNZ(RR(YZ!Z!1$$$$1111Q Z!18888!!!!Q1 agendarEnvio() Par4metro httpmethod ddd ce.. =': !1$$$$1111 0ensagem de 11 caracteres. Deve ser D 5dias6 o" H 5horas6 o" não passar o parametro.o: $:+ o" 1+:# . a "nidade de repeti&ão "ti.com.ista Aa. Por e'emp.". ( hora deve estar no 3ormato HH:00 onde HH ) a hora 5 a !+6 e 00 ) o min"to. Fbserva&ão: /e esse par4metro 3or enviado atrav)s de _=*: ) necessário 3a>er o ?R9 encode.ar mensagem Aa. Por e'emp.enviarListaSMS() Par4metro httpmethod .br http://www. 5opciona.o: ! 1 / 7/ $. Fbserva&ão: /e esse par4metro 3or enviado atrav)s de _=*: ) necessário 3a>er o ?R9 encode. Página: 11 "s"ario senha data hora periodo 3re%"encia ByJG.o se periodo 3or D e 3re%"encia 3or !: indica %"e o sistema irá repetir o envio a cada ! dias. ?m nDmero %"e indica a 3re%"Mncia de repeti&ões.or enviarsms /tring de ! caracteres /tring de 8 caracteres 0ensagem de 11 caracteres.istasms 9ista de ce.br .ares separados por Z. 5opciona. /e" "s"ário /"a senha ( data %"e será enviado o /0/.ar deve estar no 3ormato DDD5! digitos6 X <?0=RF58 dJgitos6.smswebservice.

Retorno FNZ1 : s"cesso FNZcod: mensagem ByJG..br Página: 1! .com.br http://www.6 ^"antas ve>es o sistema irá repetir o envio respeitando o periodo e 3re%"encia de3inida acima. Fpciona.repeticoes senderid 5opciona.smswebservice.com.

'erramenta de (dministração WEB (.smswebservice.com.tar o tota. ByJG.o compras e3et"adas: %"antidade de cr)ditos e servi&os habi.br Página: 1+ . Consulta de Créditos F "s"ário poderá cons". poderão ser acompanhados os cr)ditos ad%"iridos e restantes: ver o histórico de todas as mensagens enviadas e enviar /0/ pe. de cr)ditos ad%"iridos e %"antos ainda restam para "ti.a 8=@.)m do 8eb /ervice o "s"ário do servi&o conta com "ma inter3ace de administra&ão %"a.i>a&ão.br http://www.com.itados. Tela Inicial (o entrar na 3erramenta de administra&ão vocM terá in3orma&ões res"midas sobre a s"a conta como por e'emp.

ar: sem ter %"e necessariamente desenvo.br Página: 1.".com. .e3one ce.smswebservice.tar o histórico de envio das mensagens: obtendo se ho"ve s"cesso o" se ocorre" a.com. atrav)s da 3erramenta 8=@ cons". Envio de SMS Individual (trav)s da Cerramenta 8=@ tamb)m ) possJve. ByJG.br http://www.%"er te. enviar mensagens av".O possJve.ica&ão para envio de /0/.sas para %"a.ver "ma ap.g"ma mensagem de erro.

e3one a"tomaticamente será preenchido.e3ones e preencher a"tomaticamente o nDmero. (o se.i>ar esse rec"rso deverá marcar R(gendar /0/S como R/-0S e preencher os campos: • Data do (gendamento: conterá a data %"e deseLa enviar o /0/ • Hora do (gendamento: ( hora %"e o /0/ deverá ser enviado.e3ones na agenda e digite no campo R<ome da agendaS o nome %"e deseLa proc"rar.S /"ponhamos %"e tenhamos o seg"inte ar%"ivo B/A: Bódigo 1 ! + <ome C".i>ar os segintes campos: ByJG.var Bomo. Agendamento <esta mesma inter3ace ) possJve.br Página: 1# . cadastrar Bontatos /0/ %"e poderão ser "ti.ano @e.br http://www..com. =sse ar%"ivo pode ser obtido a partir de "m ='ce.ista com os nomes prováveis.tar a s"a agenda de te.mente c"stomi>áve. • Repetir a cada: R'S D-(/ o" R'S HFR(/ e %"antidade de repeti&ões: obedecendo a regra de3inida.smswebservice. e re%"er %"e o "s"ário tenha "m ar%"ivo B/A..ecionar "m de.i>ados para o envio individ"a.Busca na Agenda F envio de /0/ poss"i "m rec"rso %"e possibi. o" para enviar para "m gr"po de /0/ de "ma Dnica ve>.ário abai'o iremos "ti. com a op&ão R/a. Para "ti. Para "ti.e3one 88888888 $$$$$$$$ 77777777 (o preencher o 3orm". (parecerá "ma .com.i>ar esse rec"rso: cadastre se"s te. Importando Contatos SMS para a Ferramenta WEB ( 3erramenta de importa&ão de contatos ) tota.trano /icrano DDD !1 !1 !1 *e. Contatos SMS O possJve.ita cons".es: o nDmero de te. programar o envio do /0/ para "ma data e hora especJ3ica.

@e.C".!1. ByJG.8888888 !.in-a de %este: 1.com.ano.itando o envio para "m gr"po inteiro.smswebservice.$$$$$$$ Envio de SMS Múltiplo F sistema tamb)m conta com "ma 3erramenta 8=@ para envio de mD.trano.br Página: 11 .!1.i>ados: possibi.tip.com. .br http://www.&osição do "am)o *ome: ! &osicão do "am)o DDD: + &osição do "am)o %ele+one: .os /0/ atrav)s de gr"pos de envio persona.

Revenda de SMS AocM pode so. Exe plos de !oo" and #eel custo i$ados <osso /ite: ?m site de ='emp.br Página: 17 .ientes. (companhar os gastos de todos o" de "m c.br http://www.com.ue seus clientes com)rem utilizando nossa in+ra/ estrutura0 )or#m sem sair do seu site0 e nesse caso0 a comissão ser1 re)assada diretamente )ara voc2.es cons"mam apenas os cr)ditos destinados a e.icitar %"e o se" cadastro seLa con3ig"rado como revenda. ● F3erecer ao se" c.iente "ma inter3ace com o Look and Fell do se" site ● ● ● ● &ermitir .smswebservice.ar Beder ao se" c.iente "m "s"ário e senha Dnicos de 3orma %"e e. Bomo "m revendedor vocM poderá: Bomprar /0/ e trans3erir para os se"s c.o: ByJG.es.iente em partic".com.

br http://www.F"tro site de ='emp.com.o: ByJG.br Página: 18 .smswebservice.com.

+ .iverI 1 ! Cai. *ente novamente em a.tip.(*E34 5 / Mensa6ens de Retorno do Serviço *oda a e'ec"&ão do 8eb/ervice devo. ( seg"ir a . Mensa%ens de Sucesso de Envio "7di6o Mensa6em /"ccess / De. Fs códigos iniciados com R.o sistema.com.g"ns instantes o" contacte o s"porte. ! .br Página: 1$ . <enh"m /0/ será descontado.ha não permanente do envio. =ntre em contato para habi. *ente novamente Baracteri>a "ma 3a.ista de mensagens de retorno reconhecidas pe."re /istema temporáriamente indisponJve.idos F "s"ário não poss"i cr)ditos ?s"ário não tem permissão para /ender-D persona.as so. F "s"ário 3oi a"tenticado com s"cesso: entretanto não poss"i permissão para "ti.com.tip.icitadas Descrição F "s"ário o" senha 3ornecidas não são reconhecidas pe.o: o" se envia todas: o" não se envia. .smswebservice. .ve "m string no seg"inte 3ormato: código: mensagem. Aer ane'o + Descrição F /0/ 3oi entreg"e com s"cesso para envio pe. U1V &xx ' Mensa%ens de autenticaç(o e créditos "7di6o . Para enviar vários /0/ de "ma Dnica ve> o "s"ário deverá poss"ir cr)ditos s"3icientes antes de proceder o envio.br http://www.i>a&ão do servi&o.i>ado ?s"ário poss"i cr)ditos s"3icientes para enviar a tota. .itar.o sistema e "m cr)dito 3oi abatidoU1V F sistema não conseg"i" enviar o /0/. Fs cr)ditos do "s"ário acabaram.o sistema.idos ?s"ario T[ ]T va. <o envio mD.S representam prob.i>ado deverá ser contrato K parte dos cr)ditos. ByJG. . ?s"ário não poss"i cr)ditos vá. 1 Mensa6em ?s"ário T[ ]T o" senha invá.idade de mensagens mD. # F "s"ário não tem nenh"ma carga de cr)ditos o" todos os cr)ditos e'piraram.idado` /em permissão para acessar o servi&o. F envio de /ender-D persona.emas de a"tentica&ão e as de erro iniciados com R$S representam erros de com"nica&ão e envio do /0/.

br http://www.te a mensagem retornada L"nto ao código 1$$ para identi3icar %"a. (gendamento cance.)xx ' Mensa%ens de validaç(o "7di6o # # 1 # ! # + Mensa6em Bampos de a"tentica&ão em branco <Dmero de te.os /0/ por ve>.ema.e3one invá. Descrição Fs campos de "s"ário e senha não 3oram 3ornecidos. F te.ado.ido. Descrição F agendamento 3oi e3et"ado e será e'ec"tado na data programada. Bons". (gendamento cance.com.e3one deve ter 8 dJgitos e come&ar com U1G$V /ó ) permitido envio de # /0/ em "ma Dnica ve>.br Página: ! . (gendamento Bance. 1 1 Data de agendamento ) <ão ) possJve.ado.smswebservice. *xx ' Mensa%ens de a%enda ento "7di6o 1 Mensa6em (gendamento e3et"ado com s"cesso. ByJG. %"e seLa atrib"Jdo K s"a conta "ma rota de envio %"e não s"porta envio de mD. (gendamento cance. ^"antidade má'ima de /0/ enviadas por ve> 3oi e'cedida /ervi&o contratado não s"porta envio mD.o. Bomo medida de prote&ão só ) permitido %"e "ma chamada ao 8eb/ervice seLa 3eita por ve>. 1 ! 1 + 1$$ =rro não especi3icado no agendamento. # .tip. *ente mais tarde. ( depender da negocia&ão de pre&os ) possJve. data de hoLe. F 3ormato da hora deverá ser: HH:00 5onde HH ) a hora entre e !+: e o 00 ) o min"to6 Fcorre" "m erro não esperado. 3oi o prob.ido.ado. ( mensagem somente será enviada se o "s"ário tiver cr)ditos na data e hora programada.com. Baso mais chamadas seLam 3eitas concorrentemente receberão essa mensagem.ado. agendar para "ma data anterior K menor %"e a data do servidor. F"tro envio para a mesma conta está sendo 3eito.tip. <ão ) possJve. Data de agendamento ) s"perior a + dias. F 3ormato da data deverá ser: ((((/00/DD 5onde (((( ) o ano: 00 ) o mMs e DD ) o dia6. Cormato data invá. agendar para "ma data s"perior K + dias a contar da data de hoLe.

br Página: !1 . F te'to da mensagem in3orma o erro especJ3ico.br http://www. Dados provedor de servi&o incomp.. Bontacte imediatamente o s"porte.e3onia. Bontacte imediatamente o s"porte. Provedor de servi&o não encontrado. Bontacte imediatamente o s"porte. Mensa%ens do Siste a (o obter "ma dessas mensagens: por 3avor contacte o s"porte. F sistema não reconhece o retorno 3ornecido pe. =rro interno. $ ! G $ + $ .a operadora de te. (contece" a.+xx . =rro grave. "7di6o $ $ 1 Mensa6em <ão disponJve. Resposta não reconhecida Descrição /ervi&o não disponJve.smswebservice. =rro interno.g"m erro inesperado dentro do 8eb/erice.com. =rro grave.com. =ntre em contato com o s"porte para maiores in3orma&ões. Bontacte imediatamente o s"porte.etos o" ine'istentes ByJG.

tip. FNZ : s"cess !ratamento do String de etorno se "or um arra# /e o res".vido o string Rres". !ratamento do String de etorno /e o res".tadoS %"e deve ser tratado.tado 3or string: nenh"ma a&ão ) necessária. Formato de etorno FNZres".(*E34 8 9 %ratamento retorno mensa6ens $%%& F retorno H**P sempre devo.smswebservice.or+Zva.or+: va.com.imitado.Zva. (RR(Y indica %"e a mensagem poss"i mD. ByJG.com. =': FNZ(RR(YZ#Zva.or.tado 3or "m arraI: ) necessário tratar o string.tado veio corretamente.ementos do vetor. =': FNZ .br http://www.or!Zva.ve "m string de.or1: va.as respostas: #: indica a %"antidade de . =RRZmensagem ➔ Fcorre" "m erro na e'ec"&ão c"La a mensagem de erro ) o string RmensagemS: e o m)todo não pode ser e'ec"tado.or1Zva.or!: va.#.inhas do vetor.br Página: !! . /endo assim ) necessário 3a>er "m tratamento do string.or# são os # e. va.tado ➔ -ndica %"e o m)todo 3oi e'ec"tado: e 3oi devo.or.or# Fnde: FN → indica %"e o res". e va.

ema Descri&ão F te.has de envio da mensagem após o aceite do envio da mensagem: Prob.istadas as possJveis 3a. AeLa o tópico abai'o. horas.ida&ão de (ntiG/pam 5enviada para m"itas pessoas6 nas mensagens.ho espa&o para arma>enar o /0/.al/as de envio (bai'o estão .e3one está 3ora de área o" des.ar.  .(*E34 : 9 Envio de SMS e d#bito de "r#ditos F envio do /0/ ocorre de 3orma assJncrona para o se" ce. /endo assim: ) possJve. ( operadora detecta %"e a mensagem ) "m /P(0 (s operadoras 3a>em "ma va.o próprio apare.igado por "m ( operadora não conseg"i" entregar a mensagem: e perJodo m"ito grande.com. ByJG. F nDmero ) ine'istente o" 3oi desativado. então a descarta.br http://www. muito im)ortante observar .".e3one está cheia e não tem mais ( mensagem ) reLeitada pe.br Página: !+ .smswebservice. /e o código de resposta 3oi R S: então a operadora aceito" o envio dos dados e então "m cr)dito será abatido de s"a conta. F processo obedece ao seg"inte 3."'o: /e ocorrer %"a.ema: seLa de va.ue uma vez . ce.ue a o)eradora aceite o envio do SMS e o cr#dito +oi abatido da sua conta não -1 como +azer o estorno desse cr#dito mesmo . <ão há como saber se o nDmero ) ine'istente o" antes de proceder o envio para a operadora. Poss-veis . ( cai'a do te.%"er prob. Há tentativas de reenvio d"rante !.: nesse caso %"e o sistema mar%"e %"e 3oi enviada: mas a mensagem n"nca cheg"e.ue ocorram +al-as de envio.".com.ida&ão: cr)ditos: etc e o sistema retornar "m código de resposta di3erente de R S: então nenh"m cr)dito será abatido.ar.

uando a mensa6em # re<eitada.: interca.br Página: !. .uando detecta esse ti)o de mensa6em.o de tempo e com o mesmo conteDdo: isso pode se caracteri>ar "m /P(0 e: nesse caso: as operadoras podem reLeitar o envio da mensagem. im)ortante observar .ue não -1 estorno dos cr#ditos mesmo . !6 Bo.icitadas seLam tratadas como /P(0 aJ vão a. .br http://www. Para evitar %"e as mensagens so.ido ao inv)s de "m /ender-D te'to.g"mas dicas: 16 ?ti.e ce. ByJG.o%"e "ma pa"sa antes de enviar as mensagens e: se possJve.com.com.smswebservice. Para evitar esse prob.".ares de operadoras di3erentes.i>e "m /ender-D baseado em "m nDmero de te. (s )r7)rias o)eradoras re<eitam a entre6a das mensa6ens .e3one vá.Evitar Spa por SMS ^"ando são enviados vários /0/ em "m c"rto interva.ema: certifique-se que seus usuários aceitam receber mensagens de sua empresa ou serviço.