Conteúdo Introdução... 2 Início e comandos básicos... 2 Exemplo método GET... 3 Exemplo método POST... 3 Códigos de retorno... 4 Exemplo para envio em Cold Fusion... 4 Exemplo para envio em PHP... 5 Exemplo para envio em ASP... 8
Introdução Este é um manual que atende as especificações necessárias para o envio de uma mensagem por vez, a cada chamada HTTP para os servidores da FastSMS, via GET ou POST utilizando a porta padrão de comunicação 80. Você pode utilizar também o HTTPS que está diponível em nossa porta 443 assim seus parâmetros serão enviados de forma criptografada. Você pode acessar nossos servidores no endereço: http://www.fastsms.com.br ou https://www.fastsms.com.br. Os parâmetros enviados não tem diferença quanto maiúsculo ou minúsculo Início e comandos básicos Para começar, registre se na FastSMS. Você receberá um ID em Meu ID. Esse ID e juntamente com a sua senha definirão todas as chamadas a serem feitas nos servidores da FastSMS. A estrutura de chamada basicamente resume se a linha abaixo (esse link deve ser colado inteiro em um browser para realizar a chamada corretamente): http://www.fastsms.com.br/sms.cfm?id=meuid&senha=minhasenha¶=zzxxxxx XXX&texto=Meu+texto+vai+aqui Na URL acima, você deverá trocar: MeuID: Troque pelo Seu ID que você recebeu quando realizou seu cadastro MinhaSenha: Troque pela senha que você informou em seu cadastro ZZXXXXXXXX: Coloque aqui o número que deseja enviar a mensagem. O formato para o número de destino é: os dois primeiros algarismos são destinados para o código de área (DDD) e os oito algarismos restantes é o número do telefone móvel a receber a mensagem. Meu+texto+vai+aqui: Digite aqui o texto da sua mensagem. Esta foi a descrição do método GET, o mais fácil de utilizar. Você também pode checar a quantidade disponível para envio de SMS (seu saldo) utilizando a URL: http://www.fastsms.com.br/saldo.cfm?id=meuid&senha=minhasenha É possível também ser notificado quanto o status da sua mensagem. Assim que obtivermos o retorno da entrega da operadora faremos uma chamada em seu servidor informando os seguintes parâmetros:
http://www.seudominio.com.br/sua_página.php?id=adi158819&message_id=19016df26c4a1 daa41c10f&status=enviado O retorno será seu ID identificando sua conta, o número da mensagem que foi gerado anteriormente e seu status. Se quiser adicionar a possibilidade de receber em tempo real o status da sua mensagem, entre em contato com suporte@fastsms.com.br fornecendo sua URL para o retorno. Exemplo método GET Um exemplo da URL de chamada seria: http://www.fastsms.com.br/sms.cfm?id=jky456789&senha=xpto89¶=1191234567&tex to=isso+é+um+teste Exemplo método POST Também é possível o envio da mensagem via POST (HTML). Se for mais conveniente, pode se utilizar um formulário com os dados a serem enviados conforme o exemplo abaixo: <form action= http://www.fastsms.com.br/sms.cfm method= POST > </form> <input type= hidden name= id value= MeuID > <input type= hidden name= senha value= MinhaSenha > <input type= hidden name= para value= ZZXXXXXXXX > <input type= hidden name= texto value= Meu texto a enviar vai aqui > No formulário HTML acima, você deverá trocar: MeuID: Troque pelo Seu ID que você recebeu quando realizou seu cadastro MinhaSenha: Troque pela senha que você informou em seu cadastro ZZXXXXXXXX: Coloque aqui o número que deseja enviar a mensagem. O formato para o número de destino é: os dois primeiros algarismos são destinados para o código de área (DDD) e os oito algarismos restantes é o número do telefone móvel a receber a mensagem. Meu texto a enviar vai aqui: Digite aqui o texto da sua mensagem.
Códigos de retorno Tanto para o método POST como o GET será exibida uma página de retorno. Logo depois da chamada, os servidores da FastSMS retornará com um ID de chamda. Esse ID representa o envio com sucesso ou não. As respostas serão: ou OK: 9b502dec5e6f98ab1891f55f6f74fd23 ERR: Número do erro, descrição do erro Em caso de sucesso do envio, a página retornará um ID no formato de exemplo: 9b502dec5e6f98ab1891f55f6f74fd23 Exemplo para envio em Cold Fusion Para integração a linguagem de programação Adobe Cold Fusion, segue um exemplo: <cfhttp method="get" url="http://www.fastsms.com.br/sms.cfm?id=meuid&senha=minhasenha¶=zzx XXXXXXX&texto=Meu+texto+vai+aqui"></cfhttp> <cfoutput>#cfhttp.filecontent#</cfoutput> Na tag <cfhttp> acima, você deverá trocar: MeuID: Troque pelo Seu ID que você recebeu quando realizou seu cadastro MinhaSenha: Troque pela senha que você informou em seu cadastro ZZXXXXXXXX: Coloque aqui o número que deseja enviar a mensagem. O formato para o número de destino é: os dois primeiros algarismos são destinados para o código de área (DDD) e os oito algarismos restantes é o número do telefone móvel a receber a mensagem. Meu+texto+vai+aqui: Digite aqui o texto da sua mensagem.
Exemplo para envio em PHP Para integração com PHP disponibilizamos uma classe para acesso. Esse código está disponível para download na sua área restrita. Para isso, siga o exemplo abaixo. Serão necessários criar três arquivos, um com um HTML simples somente para simular a chamada do envio, uma para receber esses parâmetros e inicializar a classe de envio e a última com a classe. Então, crie um arquivo chamado inicio.htm onde deverá conter as seguintes instruções: <html> <body> <form action="destino.php" method="post"> Número: <input type="text" name="para"><br> Mensagem: <input type="text" name="mensagem"><br> <input type="submit" value="send SMS"> </form> </body> </html>
Agora, crie um arquivo chamado destino.php que deverá conter as seguintes informações: <html> <body> <?php // include FastSMS class include("fastsms.php"); // criando objeto $sms = new FastSMS; // setando parametros parameters $sms->setid("xpt123456"); $sms->setsenha("suasenha"); $sms->settipo("sms"); //parâmteros do formulário: $para = $_REQUEST['para'] ; $mensagem = $_REQUEST['mensagem'] ; $sms->setnumero($para); $sms->setmensagem($mensagem); // enviando e pegando resultado $smsresult = $sms->send(); print $smsresult;?> </body> </html> No arquivo destino.php, troque as seguintes informações pelas suas: MeuID: Troque pelo Seu ID que você recebeu quando realizou seu cadastro MinhaSenha: Troque pela senha que você informou em seu cadastro Agora crie o arquivo FastSMS.php, que é o nome da classe que deverá ser instanciada. Essa classe não precisa ser alterada. Ela deverá conter as seguintes informações:
<?php class FastSMS { var $user = ""; var $pass = ""; var $number = ""; var $ownnum = ""; var $message = ""; var $messageid = ""; var $type = ""; function SetID($newuser) { $this->user = $newuser; function SetSenha($newpass) { $this->pass = $newpass; function SetNumero($newnumber) { $this->number = $newnumber; function SetTipo($newtype) { $this->type = $newtype; function SetMensagem($newmessage) { $this->message = $newmessage; function SetMensagemId($newmessageid) { $this->messageid = $newmessageid; function MIMEEncode($s) { return base64_encode($s); function Send() { $Body = ""; $Body.= "para=". $this->number; $Body.= "&ID=". urlencode($this->user); $Body.= "&senha=". urlencode($this->pass); $Body.= "&texto=". urlencode($this->message); if ($this->type!= "") $Body.= "&chr_unicode=". $this->type; $ContentLength = strlen($body); $Host = "www.fastsms.com.br"; $Header = "POST /sms.cfm HTTP/1.0\n"."Host: $Host\n"."Content-Type: application/xwww-form-urlencoded\n"."content-length: $ContentLength\n\n"."$Body\n"; echo("$header\n"); $socket = fsockopen($host, 80, $errno, $errstr); if (!$socket) { return ("no_connection"); continua na próxima página...
?> fputs($socket, $Header); $SocRet = ""; while (!feof($socket)) { $SocRet.= fgets($socket, 128); print $SocRet; fclose($socket); $pos = strpos($socret, "\n\r"); $SocRet = trim(substr($socret, $pos+2)); return $SocRet; function GetID() { return $this->user; function GetSenha() { return $this->pass; function GetNumero() { return $this->number; function GetMensagem() { return $this->message; function GetTipo() { return $this->type; Pronto, coloque esses dois arquivos no mesmo diretório e execute. Você deverá conseguir realizar uma chamada PHP em nossos servidores e aguardar a resposta de confirmação do pedido. Você poderá utilizar a página destino.php para acessar seu banco de dados e realizar o envio a partir do mesmo por exemplo. Exemplo para envio em ASP Para integração a linguagem ASP, crie um documento com a extensão.asp e coloque o código abaixo, fazendo as trocas necessárias como usuário, senha, telefone e texto:
<% Dim objxmlhttp Dim strhtml Set objxmlhttp = CreateObject("Msxml2.ServerXMLHTTP") objxmlhttp.settimeouts 1000,1000,1000,1000 objxmlhttp.open "GET", "http://www.fastsms.com.br/sms.cfm?id=xpto990000&senha=suasenha¶=1191234 567&texto=Teste via ASP", False objxmlhttp.send strhtml = objxmlhttp.responsetext strstatus = objxmlhttp.status Set objxmlhttp = Nothing %> Status: <%=strstatus%><br> Retorno: <%=strhtml%> No texto acima, efetue as trocas de: XPTO990000: Troque pelo Seu ID que você recebeu quando realizou seu cadastro SuaSenha: Troque pela senha que você informou em seu cadastro 1191234567: Coloque aqui o número que deseja enviar a mensagem. O formato para o número de destino é: os dois primeiros algarismos são destinados para o código de área (DDD) e os oito algarismos restantes é o número do telefone móvel a receber a mensagem. Teste via ASP: Digite aqui o texto da sua mensagem. Nosso canal de suporte: suporte@fastsms.com.br