SMS-MT API > URL CALLBACK

Versão: atual Última Atualização: 08/07/2016


1. Overview

Retorno HTTP GET de uma alteração no Status de uma mensagem enviada por SMS-MT. A chamada é realizada a uma URL pertencente ao cliente, a qual deve ser enviada a equipe de suporte do MobiPronto através da Central de Suporte para cadastro.

2. Parâmetros

Parâmetro Requerimento Descrição
USER
Número do Usuário no MobiPronto
CODEPROJECT
Código do Projeto
CREDENTIAL
Credencial da Conta MobiPronto
SMPPMESSAGEID SMPP API Message ID
SMPPSEQUENCEID SMPP API Sequence ID
MPGMESSAGEID
Mobi Pronto Message ID
USERMESSAGEID SMPP API Usuário ID
STATUS   Status da Mensagem (ver na tabela abaixo)
MOBILE   Número de Destino formato [PPP(AAAA)NNNNNNNN] ex: 55(21)999998765
CREDITS   Número de crédito debitados (padrão decimal usando "." ponto)
DATETIME   Data e Hora do CallBack (DD/MM/YYYY HH:MM:SS +GMT 0000)
CODAUX   Código Auxiliar que foi utilizado no envio do SMS 

2.1. Status das mensagens SMS

Código de Retorno Descrição
100 Não enviada
200 Enviada com confirmação de entrega
220 Enviada sem confirmação
300 Em processo de envio
400 Em processo de envio via SMPP
999 Erro não identificado
### Status não identificado

Os parâmetros são passados com encode UTF-8

2.2. Exemplo

  • VB.NET
' Exemplo de utilização em VB ASP NET
'
Dim v_st_Usr As String = Server.UrlDecode(Request.QueryString("USER"))
Dim v_st_CProj As String = erver.UrlDecode(Request.QueryString("CODPROJECT"))
Dim v_st_Cred As String = Server.UrlDecode(Request.QueryString("CREDENTIAL"))
Dim v_st_SmppMsgID As String = Server.UrlDecode(Request.QueryString("SMPPMESSAGEID"))
Dim v_st_SmppSequenceId As String = Server.UrlDecode(Request.QueryString("SMPPSEQUENCEID"))
Dim v_st_MPGMessageId As String = Server.UrlDecode(Request.QueryString("MPGMESSAGEID"))
Dim v_st_UsuarioMsgId As String = Server.UrlDecode(Request.QueryString("USERMESSAGEID"))
Dim v_st_Status As String = Server.UrlDecode(Request.QueryString("STATUS"))
Dim v_st_Mobile As String = Server.UrlDecode(Request.QueryString("MOBILE").Trim)
Dim v_st_Creditos As String = Server.UrlDecode(Request.QueryString("CREDITS"))
Dim v_st_DataRetorno As String = Server.UrlDecode(Request.QueryString("DATETIME").Trim)
Dim v_st_Cod_Aux As String = Server.UrlDecode(Request.QueryString("CODAUX").Trim)
' Transformando no Horário do Brasil
Dim v_dt_DataBrasil As Datetime
v_dt_DataBrasil = DateTime.Parse(v_st_DataRetorno,CultureInfo.CreateSpecificCulture("pt-BR"))
v_dt_DataBrasil = v_dt_DtBr.AddHours(-3) ' No horário de verão somar (-2) ao invés de (-3)