Manual de Utilizao Servio de SMS

Reviso 1.8

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

Pgina: 1

Histrico de Revises
Reviso 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 $ $ $ $ $ $ $ Histrico Primeira reviso do doc"mento Pe%"enas corre&es de te'to no doc"mento (crescentado o servi&o atrav)s de chamadas H**P -nc."so 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."so 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

Pgina: !

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

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

Pgina: +

Descrio do Servio
F /0/ 8eb /ervice ) "m servi&o inovador %"e possibi.ita o envio de mensagens de te'tos /0/ 5*orpedos6 para %"a.%"er ce.".ar do @rasi. e do m"ndo. Por "ti.i>ar a inter3ace de 8eb /ervice o mesmo pode ser incorporado em %"a.%"er ap.ica&o: no importa a .ing"agem %"e a s"a ap.ica&o 3oi desenvo.vida. = o 8eb /ervice "ti.i>a m)todos simp.es %"e possibi.itam "ma integra&o rpida e com bai'o c"sto K s"a ap.ica&o.

Usos do Servio
AeLa a.g"ns "sos do /0/ 8eb /ervice na s"a ap.ica&o:

(.erta de eventos 3"t"ros (.erta de a.g"ma ocorrMncia no sistema =nvio de mensagens de con3irma&o do nDmero do ce.".ar =nvio de mensagens dirias: semanais e mensais Aa.ida&o de "s"rios 0a.a direta 0"itos o"tros "sos

Utilizando o servio como WEB SER !"E

( ap.ica&o de envio de /0/ pode ser chamada atrav)s de 8eb /ervice. /endo assim ) necessrio %"e seLa adicionado ao se" proLeto a re3erMncia do servi&o de /0/. F 8eb /ervice ) s"portado por %"a.%"er .ing"agem de programa&o com s"porte ao protoco.o /F(P. ( maioria das -D= de programa&o: criam "ma camada de 3ci. integra&o com a ap.ica&o. (.g"mas .ing"agens: Ais"a. @asic.<=* e Bsharp De.phi Co' Pro Ais"a. @asic 1 5Bom o /oap *oo. Nit6 etc

Dados do Servio
O necessrio as seg"intes in3orma&es: =ndere&o do /ervi&o http://www.bILg.com.br/site/webservice.php/ws/sms Descritor do /ervi&o 58/D96 5"se este a%"i para adicionar a re3erMncia em s"a ap.ica&o6 http://www.bILg.com.br/site/webservice.php/ws/smsP8/D9
ByJG.com.br http://www.smswebservice.com.br
Pgina: ,

Web Mtodos
obterVersao()
Descri&o: Devo.ve a verso do 8eb /ervice Par4metros de =ntrada: <enh"m Retorno ( verso at"a. do 8eb /ervice ='emp.o de ?ti.i>a&o string s Q smsweb.obterAersao56;

enviarSMS()
Descri&o: Permite enviar "m /0/ para ce.".ares do @rasi. de acordo com os dados 3ornecidos. Par4metros de =ntrada: ddd: F cdigo de rea do ce.".ar. ='emp.o: !1: 71: 11: etc ce.".ar: F nDmero de ce.".ar a receber o /0/. Deve ter 8 digitos: sem espa&os o" tra&os mensagem: ( mensagem %"e dever ser enviada. <ote %"e a mensagem deve conter no m'imo 11 caracteres. Fs acentos sero despre>ados "s"ario: F "s"rio do servi&o senha: ( senha do "s"rio do servi&o /ender-D 5opciona.6: Permite m"dar o /ender-D %"e ser enviado na mensagem: o" seLa o remetente. =sse servi&o deve ser contrato K parte. Retorno ( sit"a&o do envio no 3ormato Rcodigo: mensagemS. ='emp.o de ?ti.i>a&o

string res".t Q smsweb.enviar/0/5T!1T: T$$$$$$$$T: T*este 0sgT: T"s"arioT: TsenhaT6; stringUV resp Q res".t.sp.it5T:T6; i3 5respU V QQ W W6 Bonso.e.8rite9ine5T/"cessoT6; e.se Bonso.e.8rite9ine5TCa.ha. T X res".t6;

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

Pgina: #

enviarSMSInternacional()
Descri&o: Permite enviar "m /0/ para ce.".ares do @rasi. de acordo com os dados 3ornecidos. Par4metros de =ntrada: codPais: F cdigo do paJs %"e est o ce.".ar. Por e'emp.o: ## para o @rasi.: 1 para os =stados ?nidos e etc. ddd: F cdigo de rea do ce.".ar. ='emp.o: !1: 71: 11: etc ce.".ar: F nDmero de ce.".ar a receber o /0/. Deve ter 8 digitos: sem espa&os o" tra&os mensagem: ( mensagem %"e dever ser enviada. <ote %"e a mensagem deve conter no m'imo 11 caracteres. Fs acentos sero 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. ='emp.o de ?ti.i>a&o

string res".t Q smsweb.enviar/0/5T1T: T!8#T: T$$$$$$$$T: T*este 0sgT: T"s"arioT: TsenhaT6; stringUV resp Q res".t.sp.it5T:T6; i3 5respU V QQ W W6 Bonso.e.8rite9ine5T/"cessoT6; e.se Bonso.e.8rite9ine5TCa.ha. T X res".t6;

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. =': (RR(YZ1Z,$ :! 1 G !G!# : : <a resposta: ,$ ) %"antidade de cr)ditos restantes e ! 1 ) data de va.idade.

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

Pgina: 1

recursos()
Descri&o: Fbt)m os rec"rsos habi.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 =': .ista dos rec"rsos disponJveis em s"a conta.

: *im:Fi:B.aro:Aivo:n/0/:Cast:1/0/:/ender-D:/"p.Portab.

enviarListaSMS()
Descri&o: Permite enviar vrios /0/ de "ma Dnica ve>. =sse comando a"menta considerave.mente a %"antidade de /0/ enviados por seg"ndo. Par4metros de =ntrada: .ista: Fs nDmeros de ce.".ares aos %"ais se deseLa enviar o /0/. F 3ormato deve ser: B=9?9(RZB=9?9(RZB=9?9(R.... F nDmero do ce.".ar deve ter o DDDX<"mero: e'emp.o: !1$$$$1111. mensagem: ( mensagem %"e dever ser enviada. <ote %"e a mensagem deve conter no m'imo 11 caracteres. Fs acentos sero despre>ados "s"ario: F "s"rio do servi&o senha: ( senha do "s"rio do servi&o /ender-D 5opciona.6: Permite m"dar o /ender-D %"e ser enviado na mensagem: o" seLa o remetente. =sse servi&o deve ser contrato K parte. =nvie "m te'to va>io no se" ."gar. Retorno ?m (rraI com a resposta. =': (RR(YZ!Z!1$$$$1111Q Z!18888!!!!Q ='emp.o de ?ti.i>a&o

string res".t Q smsweb.enviar9ista/0/5T!1$$$$1111Z!18888!!!!T: T0sgT: T"s"arioT: TsenhaT: TT6; stringUV resp Q res".t.sp.it5TZT6; i3 5respU V QQ W(RR(YW6 [ 3or5int i Q ; i\Bonvert.*o-nt+!5respU!V6;iXX6 [ Bonso.e.8rite9ine5respUiX+V6; ] e.se Bonso.e.8rite9ine5TCa.ha. T X res".t6;

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

Pgina: 7

agendarEnvio()
Descri&o: Permite agendar o envio de /0/ atrav)s de nossa inter3ace. Par4metros de =ntrada: ddd: F cdigo de rea do ce.".ar. ='emp.o: !1: 71: 11: etc ce.".ar: F nDmero de ce.".ar a receber o /0/. Deve ter 8 digitos: sem espa&os o" tra&os mensagem: ( mensagem %"e dever ser enviada. <ote %"e a mensagem deve conter no m'imo 11 caracteres. Fs acentos sero 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/. ( data deve estar no 3ormato ((((/00/DD onde (((( ) o ano: 00 ) o mMs e DD ) o dia. Por e'emp.o: ! 1 / 7/ $. hora: ( hora %"e o /0/ ser enviado. ( hora deve estar no 3ormato HH:00 onde HH ) a hora 5 a !+6 e 00 ) o min"to. Por e'emp.o: $:+ o" 1+:# . periodo: 5opciona.6 /e preenchido: indicar %"a. a "nidade de repeti&o "ti.i>ada na 3re%"Mncia. Deve ser D 5dias6 o" H 5horas6 o" "m string va>io. 3re%"encia: 5opciona.6. ?m nDmero %"e indica a 3re%"Mncia de repeti&es. Por e'emp.o se periodo 3or D e 3re%"encia 3or !: indica %"e o sistema ir repetir o envio a cada ! dias. repeticoes: 5opciona.6 ^"antas ve>es o sistema ir repetir o envio respeitando o periodo e 3re%"encia de3inida acima. /ender-D 5opciona.6: Permite m"dar o /ender-D %"e ser enviado na mensagem: o" seLa o remetente. =sse servi&o deve ser contrato K parte. Retorno ( sit"a&o do agendamento no 3ormato Rcodigo: mensagemS. ='emp.o de ?ti.i>a&o

string res".t Q smsweb.agenda=nvio5T!1T: T$$$$$$$$T: T*este 0sgT: T"s"arioT: TsenhaT: T! 1 / 7/ $T: T1#: T6; stringUV resp Q res".t.sp.it5T:T6; i3 5respU V QQ W1 W6 Bonso.e.8rite9ine5T/"cessoT6; e.se Bonso.e.8rite9ine5TCa.ha. T X res".t6;

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

Pgina: 8

Utilizando o servio atrav#s de $%%&

( o"tra moda.idade para e'ec"tar o servi&o ) atrav)s de chamadas H**P. O "m m)todo mais tradiciona. e a"menta as possibi.idades de e'ec"&o do servi&o. (s chamadas H**P aceitam os m)todos _=* e PF/*: e podem ser chamados diretamente pe.o navegador: ar%"ivos de 9ote: /he.. /cript: 8indows /cript: ap.ica&es (/P +. : etc. (s mensagens de retorno so e'atamente ig"ais aos do 8eb /ervice.

Dados do Servio
F endere&o do servi&o ) o mesmo do 8eb/ervice. ( 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. =ndere&o do /ervi&o http://www.bILg.com.br/site/webservice.php/ws/sms

HTTP Metdos
obterVersao()
Par4metro httpmethod Retorno: FNZ .#. Aa.or obterversao

enviarSMS()
Par4metro httpmethod ddd ce.".ar mensagem Aa.or enviarsms /tring de ! caracteres /tring de 8 caracteres 0ensagem de 11 caracteres. Fbserva&o: /e esse par4metro 3or enviado atrav)s de _=*: ) necessrio 3a>er o ?R9 encode. /e" "s"rio /"a senha Fpciona..

"s"ario senha senderid

Retorno FNZ1: 3ai."re FNZcod: mensagem

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

enviarSMSInternacional()
Par4metro httpmethod codpais ddd ce.".ar mensagem Aa.or enviarsmsinternaciona. /tring com o cdigo do paJs. ='emp.o: ##: 1: etc. /tring de ! caracteres /tring de 8 caracteres 0ensagem de 11 caracteres. Fbserva&o: /e esse par4metro 3or enviado atrav)s de _=*: ) necessrio 3a>er o ?R9 encode. /e" "s"rio /"a senha

"s"ario senha

Retorno FNZ : s"ccess FNZ1: 3ai."re FNZcod: mensagem

creditos()
Par4metro httpmethod "s"ario senha Aa.or creditos /e" "s"rio /"a senha

Retorno FNZ(RR(YZ!Z,$ :! 1 G !G!#

Z#:! 1 G +G ,

recursos()
Par4metro httpmethod "s"ario senha Aa.or rec"rsos /e" "s"rio /"a senha

Retorno FNZ : *im:Fi:B.aro:Aivo:n/0/:Cast:1/0/:/ender-D:/"p.Portab.

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

Pgina: 1

enviarListaSMS()
Par4metro httpmethod .ista Aa.or enviar.istasms 9ista de ce.".ares separados por Z. F ce.".ar deve estar no 3ormato DDD5! digitos6 X <?0=RF58 dJgitos6. =': !1$$$$1111 0ensagem de 11 caracteres. Fbserva&o: /e esse par4metro 3or enviado atrav)s de _=*: ) necessrio 3a>er o ?R9 encode. /e" "s"rio /"a senha Fpciona..

mensagem

"s"ario senha senderid

Retorno FNZ(RR(YZ!Z!1$$$$1111Q Z!18888!!!!Q1

agendarEnvio()
Par4metro httpmethod ddd ce.".ar mensagem Aa.or enviarsms /tring de ! caracteres /tring de 8 caracteres 0ensagem de 11 caracteres. Fbserva&o: /e esse par4metro 3or enviado atrav)s de _=*: ) necessrio 3a>er o ?R9 encode. /e" "s"rio /"a senha ( data %"e ser enviado o /0/. ( data deve estar no 3ormato ((((/00/DD onde (((( ) o ano: 00 ) o mMs e DD ) o dia. Por e'emp.o: ! 1 / 7/ $. ( hora %"e o /0/ ser enviado. ( hora deve estar no 3ormato HH:00 onde HH ) a hora 5 a !+6 e 00 ) o min"to. Por e'emp.o: $:+ o" 1+:# . 5opciona.6 /e preenchido: indicar %"a. a "nidade de repeti&o "ti.i>ada na 3re%"Mncia. Deve ser D 5dias6 o" H 5horas6 o" no passar o parametro. 5opciona.6. ?m nDmero %"e indica a 3re%"Mncia de repeti&es. Por e'emp.o se periodo 3or D e 3re%"encia 3or !: indica %"e o sistema ir repetir o envio a cada ! dias.
Pgina: 11

"s"ario senha data

hora

periodo

3re%"encia

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

repeticoes senderid

5opciona.6 ^"antas ve>es o sistema ir repetir o envio respeitando o periodo e 3re%"encia de3inida acima. Fpciona..

Retorno FNZ1 : s"cesso FNZcod: mensagem

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

Pgina: 1!

'erramenta de (dministrao WEB

(.)m do 8eb /ervice o "s"rio do servi&o conta com "ma inter3ace de administra&o %"a. podero ser acompanhados os cr)ditos ad%"iridos e restantes: ver o histrico de todas as mensagens enviadas e enviar /0/ pe.a 8=@.

Tela Inicial
(o entrar na 3erramenta de administra&o vocM ter in3orma&es res"midas sobre a s"a conta como por e'emp.o compras e3et"adas: %"antidade de cr)ditos e servi&os habi.itados.

Consulta de Crditos
F "s"rio poder cons".tar o tota. de cr)ditos ad%"iridos e %"antos ainda restam para "ti.i>a&o.

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

Pgina: 1+

O possJve. atrav)s da 3erramenta 8=@ cons".tar o histrico de envio das mensagens: obtendo se ho"ve s"cesso o" se ocorre" a.g"ma mensagem de erro.

Envio de SMS Individual

(trav)s da Cerramenta 8=@ tamb)m ) possJve. enviar mensagens av".sas para %"a.%"er te.e3one ce.".ar: sem ter %"e necessariamente desenvo.ver "ma ap.ica&o para envio de /0/.

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

Pgina: 1,

Busca na Agenda
F envio de /0/ poss"i "m rec"rso %"e possibi.ita cons".tar a s"a agenda de te.e3ones e preencher a"tomaticamente o nDmero. Para "ti.i>ar esse rec"rso: cadastre se"s te.e3ones na agenda e digite no campo R<ome da agendaS o nome %"e deseLa proc"rar. (parecer "ma .ista com os nomes provveis. (o se.ecionar "m de.es: o nDmero de te.e3one a"tomaticamente ser preenchido.

Agendamento
<esta mesma inter3ace ) possJve. programar o envio do /0/ para "ma data e hora especJ3ica. Para "ti.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. Repetir a cada: R'S D-(/ o" R'S HFR(/ e %"antidade de repeti&es: obedecendo a regra de3inida.

Contatos SMS
O possJve. cadastrar Bontatos /0/ %"e podero ser "ti.i>ados para o envio individ"a. o" para enviar para "m gr"po de /0/ de "ma Dnica ve>.

Importando Contatos SMS para a Ferramenta WEB

( 3erramenta de importa&o de contatos ) tota.mente c"stomi>ve. e re%"er %"e o "s"rio tenha "m ar%"ivo B/A. =sse ar%"ivo pode ser obtido a partir de "m ='ce. com a op&o R/a.var Bomo...S /"ponhamos %"e tenhamos o seg"inte ar%"ivo B/A:
Bdigo 1 ! + <ome C".ano @e.trano /icrano DDD !1 !1 !1 *e.e3one 88888888 $$$$$$$$ 77777777

(o preencher o 3orm".rio abai'o iremos "ti.i>ar os segintes campos:

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

Pgina: 1#

&osio do "am)o *ome: ! &osico do "am)o DDD: + &osio do "am)o %ele+one: , ,in-a de %este: 1;C".ano;!1;8888888 !;@e.trano;!1;$$$$$$$

Envio de SMS Mltiplo

F sistema tamb)m conta com "ma 3erramenta 8=@ para envio de mD.tip.os /0/ atrav)s de gr"pos de envio persona.i>ados: possibi.itando o envio para "m gr"po inteiro.

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

Pgina: 11

Revenda de SMS
AocM pode so.icitar %"e o se" cadastro seLa con3ig"rado como revenda. Bomo "m revendedor vocM poder: Bomprar /0/ e trans3erir para os se"s c.ientes. (companhar os gastos de todos o" de "m c.iente em partic".ar Beder ao se" c.iente "m "s"rio e senha Dnicos de 3orma %"e e.es cons"mam apenas os cr)ditos destinados a e.es. F3erecer ao se" c.iente "ma inter3ace com o Look and Fell do se" site

&ermitir .ue seus clientes com)rem utilizando nossa in+ra/ estrutura0 )or#m sem sair do seu site0 e nesse caso0 a comisso ser1 re)assada diretamente )ara voc2.

Exe plos de !oo" and #eel custo i$ados

<osso /ite:

?m site de ='emp.o:

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

Pgina: 17

F"tro site de ='emp.o:

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

Pgina: 18

(*E34 5 / Mensa6ens de Retorno do Servio

*oda a e'ec"&o do 8eb/ervice devo.ve "m string no seg"inte 3ormato: cdigo: mensagem. ( seg"ir a .ista de mensagens de retorno reconhecidas pe.o sistema. Fs cdigos iniciados com R,S representam prob.emas de a"tentica&o e as de erro iniciados com R$S representam erros de com"nica&o e envio do /0/.

Mensa%ens de Sucesso de Envio

"7di6o Mensa6em
/"ccess / De.iverI 1 ! Cai."re /istema temporriamente indisponJve.
Aer ane'o +

Descrio
F /0/ 3oi entreg"e com s"cesso para envio pe.o sistema e "m cr)dito 3oi abatidoU1V F sistema no conseg"i" enviar o /0/. *ente novamente Baracteri>a "ma 3a.ha no permanente do envio. <enh"m /0/ ser descontado. *ente novamente em a.g"ns instantes o" contacte o s"porte.

U1V

&xx ' Mensa%ens de autentica(o e crditos

"7di6o
, , 1

Mensa6em
?s"rio T[ ]T o" senha inv.idos ?s"ario T[ ]T va.idado` /em permisso para acessar o servi&o. =ntre em contato para habi.itar. ?s"rio no poss"i cr)ditos v.idos F "s"rio no poss"i cr)ditos ?s"rio no tem permisso para /ender-D persona.i>ado ?s"rio poss"i cr)ditos s"3icientes para enviar a tota.idade de mensagens mD.tip.as so.icitadas

Descrio
F "s"rio o" senha 3ornecidas no so reconhecidas pe.o sistema. F "s"rio 3oi a"tenticado com s"cesso: entretanto no poss"i permisso para "ti.i>a&o do servi&o.

, ! , + , , , #

F "s"rio no tem nenh"ma carga de cr)ditos o" todos os cr)ditos e'piraram. Fs cr)ditos do "s"rio acabaram. F envio de /ender-D persona.i>ado dever ser contrato K parte dos cr)ditos. Para enviar vrios /0/ de "ma Dnica ve> o "s"rio dever poss"ir cr)ditos s"3icientes antes de proceder o envio. <o envio mD.tip.o: o" se envia todas: o" no se envia.

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

Pgina: 1$

)xx ' Mensa%ens de valida(o

"7di6o
# # 1 # ! # +

Mensa6em
Bampos de a"tentica&o em branco <Dmero de te.e3one inv.ido. ^"antidade m'ima de /0/ enviadas por ve> 3oi e'cedida /ervi&o contratado no s"porta envio mD.tip.o. F"tro envio para a mesma conta est sendo 3eito. *ente mais tarde.

Descrio
Fs campos de "s"rio e senha no 3oram 3ornecidos. F te.e3one deve ter 8 dJgitos e come&ar com U1G$V / ) permitido envio de # /0/ em "ma Dnica ve>. ( depender da negocia&o de pre&os ) possJve. %"e seLa atrib"Jdo K s"a conta "ma rota de envio %"e no s"porta envio de mD.tip.os /0/ por ve>. Bomo medida de prote&o s ) permitido %"e "ma chamada ao 8eb/ervice seLa 3eita por ve>. Baso mais chamadas seLam 3eitas concorrentemente recebero essa mensagem.

# ,

*xx ' Mensa%ens de a%enda ento

"7di6o
1

Mensa6em
(gendamento e3et"ado com s"cesso.

Descrio
F agendamento 3oi e3et"ado e ser e'ec"tado na data programada. ( mensagem somente ser enviada se o "s"rio tiver cr)ditos na data e hora programada.

1 1

Data de agendamento ) <o ) possJve. agendar para "ma data anterior K menor %"e a data do servidor. data de hoLe. (gendamento cance.ado. Data de agendamento ) s"perior a + dias. (gendamento cance.ado. Cormato data inv.ido. (gendamento Bance.ado. <o ) possJve. agendar para "ma data s"perior K + dias a contar da data de hoLe. F 3ormato da data dever ser: ((((/00/DD 5onde (((( ) o ano: 00 ) o mMs e DD ) o dia6. F 3ormato da hora dever ser: HH:00 5onde HH ) a hora entre e !+: e o 00 ) o min"to6 Fcorre" "m erro no esperado. Bons".te a mensagem retornada L"nto ao cdigo 1$$ para identi3icar %"a. 3oi o prob.ema.

1 !

1 +

1$$

=rro no especi3icado no agendamento. (gendamento cance.ado.

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

Pgina: !

+xx , Mensa%ens do Siste a

(o obter "ma dessas mensagens: por 3avor contacte o s"porte. "7di6o
$ $ 1

Mensa6em
<o disponJve. Resposta no reconhecida

Descrio
/ervi&o no disponJve.. =ntre em contato com o s"porte para maiores in3orma&es. F sistema no reconhece o retorno 3ornecido pe.a operadora de te.e3onia. =rro grave. Bontacte imediatamente o s"porte. =rro grave. (contece" a.g"m erro inesperado dentro do 8eb/erice. F te'to da mensagem in3orma o erro especJ3ico. Bontacte imediatamente o s"porte. =rro interno. Bontacte imediatamente o s"porte. =rro interno. Bontacte imediatamente o s"porte.

$ !

$ + $ ,

Provedor de servi&o no encontrado. Dados provedor de servi&o incomp.etos o" ine'istentes

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

Pgina: !1

(*E34 8 9 %ratamento retorno mensa6ens $%%&

F retorno H**P sempre devo.ve "m string de.imitado. /endo assim ) necessrio 3a>er "m tratamento do string.

Formato de

etorno

FNZres".tado -ndica %"e o m)todo 3oi e'ec"tado: e 3oi devo.vido o string Rres".tadoS %"e deve ser tratado. =RRZmensagem Fcorre" "m erro na e'ec"&o c"La a mensagem de erro ) o string RmensagemS: e o m)todo no pode ser e'ec"tado.

!ratamento do String de etorno

/e o res".tado 3or string: nenh"ma a&o ) necessria. =': FNZ .#. FNZ : s"cess

!ratamento do String de etorno se "or um arra#

/e o res".tado 3or "m arraI: ) necessrio tratar o string. =': FNZ(RR(YZ#Zva.or1Zva.or!Zva.or+Zva.or,Zva.or# Fnde: FN indica %"e o res".tado veio corretamente; (RR(Y indica %"e a mensagem poss"i mD.tip.as respostas: #: indica a %"antidade de .inhas do vetor; va.or1: va.or!: va.or+: va.or, e va.or# so os # e.ementos do vetor.

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

Pgina: !!

(*E34 : 9 Envio de SMS e d#bito de "r#ditos

F envio do /0/ ocorre de 3orma assJncrona para o se" ce.".ar. F processo obedece ao seg"inte 3."'o:

/e ocorrer %"a.%"er prob.ema: seLa de va.ida&o: cr)ditos: etc e o sistema retornar "m cdigo de resposta di3erente de R S: ento nenh"m cr)dito ser abatido. /e o cdigo de resposta 3oi R S: ento a operadora aceito" o envio dos dados e ento "m cr)dito ser abatido de s"a conta.

; muito im)ortante observar .ue uma vez .ue a

o)eradora aceite o envio do SMS e o cr#dito +oi abatido da sua conta no -1 como +azer o estorno desse cr#dito mesmo .ue ocorram +al-as de envio.

Poss-veis .al/as de envio

(bai'o esto .istadas as possJveis 3a.has de envio da mensagem aps o aceite do envio da mensagem:
Prob.ema Descri&o

F te.e3one est 3ora de rea o" des.igado por "m ( operadora no conseg"i" entregar a mensagem: e perJodo m"ito grande. ento a descarta. H tentativas de reenvio d"rante !, horas. ( cai'a do te.e3one est cheia e no tem mais ( mensagem ) reLeitada pe.o prprio apare.ho espa&o para arma>enar o /0/. ce.".ar. F nDmero ) ine'istente o" 3oi desativado. <o h como saber se o nDmero ) ine'istente o" antes de proceder o envio para a operadora.

( operadora detecta %"e a mensagem ) "m /P(0 (s operadoras 3a>em "ma va.ida&o de (ntiG/pam 5enviada para m"itas pessoas6 nas mensagens. /endo assim: ) possJve.: nesse caso %"e o sistema mar%"e %"e 3oi enviada: mas a mensagem n"nca cheg"e. AeLa o tpico abai'o.

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

Pgina: !+

Evitar Spa

por SMS

^"ando so enviados vrios /0/ em "m c"rto interva.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. Para evitar esse prob.ema: certifique-se que seus usurios aceitam receber mensagens de sua empresa ou servio. (s )r7)rias o)eradoras re<eitam a entre6a das mensa6ens .uando detecta esse ti)o de mensa6em. ; im)ortante observar .ue no -1 estorno dos cr#ditos mesmo .uando a mensa6em # re<eitada. Para evitar %"e as mensagens so.icitadas seLam tratadas como /P(0 aJ vo a.g"mas dicas: 16 ?ti.i>e "m /ender-D baseado em "m nDmero de te.e3one v.ido ao inv)s de "m /ender-D te'to. !6 Bo.o%"e "ma pa"sa antes de enviar as mensagens e: se possJve.: interca.e ce.".ares de operadoras di3erentes.

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

Pgina: !,