Este documento apresenta e explica como fazer a integração e receber as notificações do status das mensagens 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
| |
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 |
| |
|
|
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 |
