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 PitchWink através da Central de Suporte para cadastro.
2. Parâmetros
| Parâmetro | Requerimento | Descrição |
|---|---|---|
| USER | Número do Usuário no PitchWink | |
| CODEPROJECT | Código do Projeto | |
| CREDENTIAL | Credencial da Conta PitchWink | |
| 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)