SMPP

Versão: 3.4 Última Atualização: 6/15/2016


1. Requerimento

O tipo de conexão SMPP é fornecida pelo MobiPronto para os clientes que necessitam enviar grandes volumes de mensagens. Você deverá possuir um Client-SMPP para conectar-se ao SMPP-Server do MobiPronto.

2. Conexão

2.1. Métodos PDU suportados

bind_transmitter(_resp), bind_transceiver(_resp) e unbind(_resp)

2.1.1. Parâmetros

Parâmetro Descrição
HostName IP informado pelo MobiPronto
Port  Número fornecido pelo MobiPronto
SSL Não utilizar
system_id Número fornecido pelo MobiPronto
password "Token Gateways" (Acesse sua conta MobiPronto em Menu Principal > Configurações > Dados de Integração)
service_type "" (NULL) ou service_type : "CMT" (Cellular Messaging)
addr_ton 0 (Unknown) ou 1 (International)
addr_npi 0 (Unknown)

3. Envio

3.1. Métodos PDU suportados

submit_sm(_resp) e submit_sm_multi(_resp) . Os métodos (_resp) retornam os campos sequence_number e message_id

É suportado assíncrono submit

3.1.1. Parâmetros

Parâmetro Requerido?  Descrição
source_addr_ton Sim 0 (Unknown)
source_addr_npi Sim 0 (Unknown)
source_addr Sim Escolha do usuário
dest_addr_ton Sim 0 (Unknown) ou 1 (International)
dest_addr_npi Sim 0 (Unknown) ou 1 ( ISDN (E163/E164) )
destination_addr Sim PPPAAAANNNNNNNNN , Exemplo Brasil: 552178787676 onde 55 = país, 21 = área , 78787676 = número do mobile
service_type Sim "" (NULL) ou service_type : "CMT" (Cellular Messaging)
data_coding Sim SMSC Default Alphabet , Octet unspecified (8-bit binary) , Latin 1 (ISO-8859-1) , UCS2 (ISO/IEC-10646), IA5 (CCITT T.50)/ASCII (ANSI X3.4)
submit_mode Sim short-message ou payload
additional_status_info_text Não Representa o "Código Auxiliar" no MobiPronto. Tamanho de até 20 caracteres.
user_message_reference Não Id da mensagem definida pelo usuário para seu controle (UserMessageId). Tamanho de até 40 caracteres
sar_msg_ref_num Não Número de referência da mensagem ( Integer , 2 Octetos )
sar_total_segments Não Número total de segmentos a serem enviados ( Integer , 1 Octeto )
sar_segment_seqnum Não Número de seqüência da mensagem no total ( Integer , 1 Octeto )

Na modalidade de envio LMS (Long Message Service - Mensagens Concatenadas), a mensagem de texto deverá ter no máximo 153 caracteres em cada segmento enviado.

Outra forma de enviar mensagens longas é com a utilização do parâmetro submit_mode = payload
Neste caso os parâmetros opcionais sar_msg_ref_num, sar_total_segments e sar_segment_seqnum assim como a fragmentação da mensagem a cada 153 caracteres, serão automaticamente definidos pelo SMPP-Client.

4. Notas da Versão

São suportados os métodos PDU enquire_link e enquire_link_resp originando-se no SMPP-Client, com tempo recomendado entre 55 a 57 segundos.

Os métodos PDU query_sm e query_sm_resp não são suportados, devendo o usuário utilizar a função CallBack-SMS-MT (HTTP GET) para receber as alterações de status das mensagens.

A URL de chamada deverá ser informada a equipe de suporte do MobiPronto através da criação de um ticket na plataforma. Clique aqui para acessar a documentação da URL CallBack-SMS-MT.