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

Especificação HTTP v1.1

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&para=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

Especificação HTTP v1.1

É 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 [email protected] 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&para=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”>

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

</form>

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

Especificação HTTP v1.1

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

OK: 9b502dec5e6f98ab1891f55f6f74fd23

ou

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&para=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

Especificação HTTP v1.1

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

Especificação HTTP v1.1

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:

Especificação HTTP v1.1

<?php
class FastSMS {
var $user = "";
var $pass = "";
var $number = "";
var $ownnum = "";
var $message = "";
var $messageId = "";
var $type = "";
function SetID($newuser) {
$this->user = $newuser;
return;
}
function SetSenha($newpass) {
$this->pass = $newpass;
return;
}
function SetNumero($newnumber) {
$this->number = $newnumber;
return;
}
function SetTipo($newtype) {
$this->type = $newtype;
return;
}
function SetMensagem($newmessage) {
$this->message = $newmessage;
return;
}
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/x-
www-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...

Especificação HTTP v1.1

 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() {
Pronto, coloque esses
return dois arquivos no mesmo diretório e execute. Você deverá conseguir
$this->type;
realizar uma chamada } PHP em nossos servidores e aguardar a resposta de confirmação do
} Você poderá utilizar a página destino.php para acessar seu banco de dados e realizar o
pedido.
?> a partir do mesmo por exemplo.
envio

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&para=1191234
567&texto=Teste via ASP", False
objXmlHttp.send

strHTML = objXmlHttp.responseText
strStatus = objXmlHttp.status

Set objXmlHttp = Nothing %>

Status: <%=strStatus%><br>
Retorno: <%=strHTML%>

Especificação HTTP v1.1

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: [email protected]

Especificação HTTP v1.1