Este documento apresenta e explica como fazer a integração e receber as notificações do status das mensgens enviadas a partir de sua conta.

Tipicamente, essas notificações devem ser integradas ao seu sistema de gerência interna para que você possa realizar um controle preciso de todas as mensagens.

Para fazer uma integração com nosso sistema e simples basta fazer o envio das informações como post ou get veja a descrição técnica para o perfeito funcionamento:

Faça o envio das variáveis para o seguinte endereço:

Download Exemplo

GET: http://smsbr.com.br/get.php

Dados para o envio como $_GET
Variavel de envio	Descrição
chaveAPI	Chave API do Usuario
usuarioNome	Nome de usuario Login
numeroTel	Celular para o envio da mensagem formato internacional (Ex. 558488998899)
mensText	Mensagem de texto no maxímo de 140 caractéres

API para integração PHP utlizando $_POST - Envio de instrução unica.

<?php

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

$Url = "http://smsbr.com.br/enviosms.php";

#------------------[Envio dos dados]-----------------------------------
$sessao_curl = curl_init();
curl_setopt($sessao_curl, CURLOPT_URL, $Url);
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");

$resultado = curl_exec($sessao_curl);
curl_close($sessao_curl);

$APIMsgID= substr($resultado, 0, -1); #Recebe o ID da Mensagem

echo "Successo ID: ".$APIMsgID;

?>

API para integração PHP utlizando $_POST - Envio de instrução em massa para mais de 10 destinatários.

Esse script deve ser utilizado quando a necessidade de enviar um grande volume de mensagens, tipo uma campanha publicitária onde são enviados um numero de mensagens superior a 1000 destinatários.

<?php

$celular_numero = $_POST["celular_numero"]; #Celular de destino Ex. (558499998888)
$assinatura= $_POST["assinatura"]; #Assinatura para a mensagem
$mensagem = $_POST["mensagem"]; #Mensagem
$api = $_POST["api "]; #Chave API do Usuario
$login = $_POST["login"]; #Nome de usuario Login

#-------------------[Gerando o ID propio da mensagem]-------------------------

$numero = rand(00000000,99999999); # Gera o ID: propio da Mensagem

$Url = "http://smsbr.com.br/restrito/integracaoGrupoSMS.php";

#------------------[Envio dos dados]-----------------------------------
$sessao_curl = curl_init();
curl_setopt($sessao_curl, CURLOPT_URL, $Url);
curl_setopt($sessao_curl, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($sessao_curl, CURLOPT_POST, 1);
curl_setopt($sessao_curl,CURLOPT_POSTFIELDS, "celular_numero=$celular_numero&assinatura=$assinatura&mensagem=$mensagem&api=$api&login=$login&id_propio=$numero");

$resultado = curl_exec($sessao_curl);
curl_close($sessao_curl);

echo "ID Mensagem :".$numero;

?>

Notificação de Status de Mensgens

Para receber as notificações, você deve preparar seus sistema na Internet para processar as notificações enviadas pelo Gateway smsbr.
Inicialmente você deve cadastrar o URL no site do SMSbr, Vá no menu lateral e click em Preferências e digite o endereço completo do serviço que você criou no campo URL de notificação.

Após o processamento de qualquer envio, o SMSbr irá enviar um POST para esse URL com os parâmetros abaixo:

Dados que são enviados para o endereço URL cadastrado na Preferências
Variavel de envio	Descrição
envioData	Data do envio Formato (d/m/Y)
APIMsgID	ID da Mensagem Max- 8 (3ae2d58e)
status	Statual atual da mensagem (001,002,003...) Ver lista abaixo
valor	Valor cobrado pelo envio
Valor dos status e mensagens correspondentes
	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