Esta documentação fornecerá instruções sobre como integrar rapidamente os serviços de mensagens do SMSBR a várias soluções usando a API HTTP smsbr. A API da smsbr é baseada nos padrões REST. Para interagir com nossa API, qualquer cliente HTTP em qualquer linguagem de programação pode ser usado.

Como Começar

1 - Criar uma conta SMSBR

Para usar nossa API, você precisará de credenciais que estão disponiveis no portal do Cliente. Se você já possui uma conta SMSBR, você pode pular este passo. Caso contrário, siga este link: CRIAR CONTA.

HTTP POST ou GET

https://smsbr.com.br/enviosms.php
chaveAPI Chave API do Usuario - Obrigatório
usuarioNome Nome de usuario "Login" - Obrigatório
numeroTel Celular para o envio 5584999119988 (Padrão internacional) - Obrigatório
mensTexto Mensagem (Maximo 160 caractéres) - Obrigatório
id_propio Id propio da mensagem (Enviado no retorno) - Opcional
flash Tipo de mensagem aceita valores SIM/NAO - Opcional
   


-------------------------------------------------------------------------------------------------------------
<?php

function sendSMSBR($chaveAPI,$usuarioNome,$numeroTel,$mensTexto,$id_propio){
#------------------[Envio dos dados]-----------------------------------
$sessao_curl = curl_init();
curl_setopt($sessao_curl, CURLOPT_URL, "https://smsbr.com.br/enviosms.php");
curl_setopt($sessao_curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($sessao_curl, CURLOPT_POST, 1);
curl_setopt($sessao_curl,CURLOPT_POSTFIELDS,
"chaveAPI=".$chaveAPI."&usuarioNome=".$usuarioNome."&numeroTel=".$numeroTel."&
mensTexto=".$mensTexto."&id_propio=".$id_propio."&flash=NAO");
$resultado = curl_exec($sessao_curl);
curl_close($sessao_curl);
$aux_id = explode(":",$resultado);

if ($aux_id[0]=="sucesso"){
return $aux_id[1];
}else{
return $resultado;
}
}

#------------------[Recebendo dados via $_POST]---------------------------
$chaveAPI = "482414404"; #Chave API do Usuario
$usuarioNome = "adelmo"; #Nome de usuario Login
$numeroTel = "5584987056005"; #Celular de destino Ex. (558499998888)
$mensTexto = "Mensagem de Teste SMSBR"; #Mensagem

$envio = sendSMSBR($chaveAPI,$usuarioNome,$numeroTel,$mensTexto,$id_propio);

echo $envio;
?>


-------------------------------------------------------------------------------------------------------------
#requires necessarios, geralmente adicionado no inicio do arquivo

require "uri"
require "net/http"

#recebendo os dados via post
parametros = {'chaveAPI' => params[:chave], 'usuarioNome' => params[:usuario], 'numeroTel' => params[:tel], 'mensTexto' => params[:msg]}
#executando a acao de post dos parametros no servidor de sms
x = Net::HTTP.post_form(URI.parse('http://smsbr.com.br/enviosms.php'), parametros)



-------------------------------------------------------------------------------------------------------------
Aplicação simples , utilizando uma StringList e o componente idHttp da paleta Indy:
procedure TForm1.Button1Click(Sender: TObject);
var
D: TStringList;
begin
D := TStringList.Create;
try
D.Add('chaveAPI=' + Edit2.Text);
D.Add('usuarioNome=' + Edit1.Text);
D.Add('numeroTel=' + Edit3.Text);
D.Add('mensTexto=' + memo1.Text);
D.Add('assinatura=' + Edit3.Text);
try
Memo2.Lines.Add (idHTTP1.Post('http://smsbr.com.br/enviosms.php',D));
except
MessageBox(0,'Ocorreu um erro durante o envio. Tente novamente','Erro',MB_ICONERROR);
end;
finally
MessageBox(0,'Informações enviadas com sucesso!','Informação',MB_ICONINFORMATION);
end;
end;

Download do exemplo acima: http://www.4shared.com/rar/aKciuS8V/Simples_Post_SMSBR.html

ESPECIFICAÇÕES DE INTEGRAÇÃO EM PDF

BAIXAR ARQUIVO

Flash SMS.

Para o envio do Flash SMS nossa API tem um parâmetro opcional para indicar que a mensagem deve ser enviada como um Flash SMS. Este parâmetro chama-se “flash” e aceita os valores SIM (como Flash SMS) ou NAO (como SMS normal). Para efeitos de compatibilidade, caso o parâmetro não seja informado na requisição a mensagem será considerada um SMS normal.

Integração para retorno automático

Além da comunicação através de webservices, é possível também automatizar a atualização de status e recebimento de Mos, através dos métodos HTTP
GET, HTTP POST
Nesse caso, assim que acontece a atualização do status para uma mensagem enviada pelo cliente, o sistema envia para uma URL pré estabelecida, através do
método GET ou POST, para um endereço, o mesmo acontece para o recebimento de mensagens de resposta ( Mos ) .
Para os Mos o caminho de retorno permanece ativo durante um período de 4 dias

Após esse período, as mensagens de resposta são descartadas.

O servidor deve ser configurado para receber os eventos onde serão passados os parâmetros necessários.

O formato da URL, para o método GET é a seguinte:

Exemplo:

https://www.urldocliente.com.br/?envioData=2019-12-19T01:35:59&APIMsgID=EV018TW5&status=001&celular=5584944556655

Parâmetros de STATUS:

envioData (data do envio)

APIMsgID (ID da Mensagem)

celular (número do destinatário)

status (3 números, veja abaixo*)

 

*Legenda dos status

001: Mensagem desconhecida
002: Mensagem na fila de entrega
003: Entregue ao Gateway
004: Recebida pelo celular
005: Erro na mensagem
006: Cancelada pelo usuário
007: Erro na entrega da mensagem
008: Recebida pelo gateway
009: Erro no encaminhamento
010: Mensagem expirou
011: Enfileiradas para posterior entrega
012: Numero inválido
013: Numero de origem inválido
014: Rota não disponível

 

 
Para Bloqueio de Mensagens a Partir de nossa Plataforma Cadastre Seu Número
   
     
       
Parceria
Sistema Pré Configurado para utilizar nossos serviço.
http://www.mksolutions.com.br/
 
Todos dos direitos reservados | www.smsbr.com.br | 2009 - 2019
Email: contato@smsbr.com.br | Skype: jfrancinaldo