SMS-MT API > HTTP GET

Versão: 2.0 Última Atualização: 13/01/2015


1. EnviaSMS

Método para enviar mensagens de texto via SMS e retornar o código da operação.

1.1. Parâmetros do EnviaSMS

Parâmetro Requerido? Formato Descrição
CREDENCIAL Sim A(40) Credencial da sua conta no MobiPronto
PRINCIPAL_USER Não
Uso interno (favor ignorar este parâmetro)
AUX_USER Não A(20) O valor atribuído a este parâmetro pode ser utilizado como referência em filtros, facilitando a identificação de mensagens específicas em relatórios criados por você a partir da plataforma
MOBILE Sim N Número celular do destinatário em formato internacional [PPP(AAAA)NNNNNNNNN]. Exemplo para o Brasil: 55(21)999999999
SEND_PROJECT Não A Se usa o remetente na mensagem. Opções possíveis SIM, S NÃO, N, Y, YES, NO
MESSAGE Sim A Conteúdo da mensagem a ser enviada via SMS, com tamanho máximo de 160 caracteres.

1.2. Retornos do EnviaSMS

Código de Retorno Descrição
X01 ou X02
Um ou mais parâmetros com erro
000 Mensagem enviada com sucesso
001 Credencial inválida
005 MOBILE com formato inválido
007 SEND_PROJECT com formato inválido
008 Mensagem com mais de 160 caracteres
009 Número de créditos insuficiente
010 Gateway SMS da conta bloqueado
012 MOBILE correto porém com crítica
013 Conteúdo da mensagem vazio ou inválido
015 País de destino sem cobertura no momento
016 MOBILE com código de área inválido

1.3. Chamada (HTTP ou HTTPS)

https://www.mpgateway.com/v_2_00/smspush/enviasms.aspx?Credencial=XXXX110B1B8723382XXXX793A74B5BC08D12266E&Principal_User=FF&Aux_User=F1&Mobile=552194797025&Send_Project=S&Message=teste

Testando o exemplo acima no browser será retornado o código 001, pois a CREDENCIAL não existe. Favor substituir o conteúdo dos parâmetros, incluindo a CREDENCIAL da sua conta para obter o resultado desejado.

1.4. Exemplos do EnviaSMS

  • VB.NET
  • PHP
  • JSP
  • DELPHI
Dim v_st_HTTPGET As String = "https://www.mpgateway.com/v_2_00/smspush/enviasms.aspx"
Dim v_st_Parametros As String
v_st_Parametros = "?" & _
"CREDENCIAL=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" & _
"&PRINCIPAL_USER=" & Server.UrlEncode("MP") & _
"&AUX_USER=" & Server.UrlEncode("USUÁRIOAUX") & _
"&MOBILE=" & "5521999999999" & _
"&SEND_PROJECT=" & "S" & _
"&MESSAGE=" & Server.UrlEncode("Mensagem de Teste")
' Montagem da URL de chamada
v_st_HTTPGET &= v_st_Parametros
Dim v_obj_Request As System.Net.HttpWebRequest = _
DirectCast(System.Net.WebRequest.Create(v_st_HTTPGET), _
System.Net.HttpWebRequest)
Dim v_st_Cod_Retorno As String
Dim v_obj_Response As System.Net.WebResponse = _
v_obj_Request.GetResponse()
If Not IsNothing(v_obj_Response) Then
Dim v_obj_IOStream As New _
System.IO.StreamReader(v_obj_Response.GetResponseStream())
v_st_Cod_Retorno = v_obj_IOStream.ReadToEnd()
v_obj_IOStream.Close()
' Retorna o v_st_Cod_Retorno no formato: 999
If v_st_Cod_Retorno.Equals("000") Then
' Mensagem enviada ao Mobi Pronto com sucesso
Else
' Tratar o resultado de acordo com a tabela
' de Códigos de Retorno do MobiPronto
End If
Else
' Algum erro na chamada HTTP GET
End If
<?php
        $credencial="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; //**Credencial da Conta 40 caracteres
        $principal = "aaa";  //* SEU CODIGO PARA CONTROLE, não colocar e-mail
        $auxuser = "AUX_USER"; //* SEU CODIGO PARA CONTROLE, não colocar e-mail
        $mobile="55XXNNNNNNNN"; //* Numero do telefone  FORMATO: PAÍS+DDD(DOIS DÍGITOS)+NÚMERO
        $sendproj = "N"; //* S = Envia o SenderId antes da mensagem , N = Não envia o SenderId
        $msg="Teste para PHP."; // Mensagem
        $msg=mb_convert_encoding($msg, "UTF-8"); // Converte a mensagem para não ocorrer erros com caracteres semi-gráficos
        $msg = URLEncode($msg); 
        $response =fopen("http://www.mpgateway.com/v_2_00/smspush/enviasms.aspx?CREDENCIAL=".$credencial."&PRINCIPAL_USER=".$principal."&AUX_USER=".$auxuser."&MOBILE=".$mobile."&SEND_PROJECT=".$sendproj."&MESSAGE=".$msg,"r");
        $status_code= fgets($response,4);
		echo "Codigo retornando do fopen=";
		echo $status_code;
        ?>
<%@ page import="java.net.*, java.io.*" %>
<%
String Credential = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
String MainUser = "SEUPROJETO";
String AuxUser = "AUX1";
String Mobile = "552199999999";
char SendProject = "S";
String Msg = "Seu Primeiro Envio de SMS via Java usado o Gateway Mobile Pronto.";
Msg = URLEncoder.encode(Msg, "UTF-8");
String connection =
"http://www.mpgateway.com/v_2_00/smspush/enviasms.aspx?CREDENCIAL="+
Credential +"&PRINCIPAL_USER="+ MainUser +"&AUX_USER="+ AuxUser +"&MOBILE="+ Mobile
+"&SEND_PROJECT="+ SendProject +"&MESSAGE="+ Msg;
URL url = new URL(connection);
InputStream input = url.openStream();
byte[] b = new byte[4];
input.read(b, 0, b.length);
String StatusCode = new String(b);
out.println("Status code = " + StatusCode);
%>
procedure TMain.Button1Click(Sender: TObject);
var
sret: String;
begin
IdHTTP1.Host := 'mobilepronto.com.br';
IdHTTP1.Port := 80;
Memo1.Lines.Text := IdHTTP1.Get('
http://www.mpgateway.com/v_2_00/smspush/enviasms.aspx?
CREDENCIAL=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
&PRINCIPAL_USER=SEUPROJETO
&AUX_USER=AUX1
&MOBILE=552199999999
&SEND_PROJECT=S
&MESSAGE=Teste SMS');
end;
end.