Conexão de Cliente SMPP

Este guia é sobre a configuração da conexão de cliente SMPP. Ele define o que é uma conexão de cliente SMPP, o que significa SMPP e como você pode usar uma conexão de cliente SMPP para conectar seu sistema de gateway SMS Ozeki diretamente ao Centro de Serviço de Mensagens Curtas (SMSC) de um operador de rede móvel pela Internet.

SMPP significa Short Message Peer-to-Peer Protocol. Este é um protocolo padrão da indústria projetado para entregar mensagens SMS através de conexões TCP/IP pela Internet. Este protocolo é implementado pelo Ozeki SMS Gateway.

Um cliente SMPP é um software que permite que você se conecte a um provedor de serviços SMS na Internet. Um cliente SMPP, como o Ozeki SMS Gateway, usa o protocolo SMPP para enviar e receber mensagens de texto SMS.

Para conectar um cliente SMPP a um provedor de serviços SMS para enviar e receber SMS, siga estes passos:

1. Abra https://localhost:9515 no seu navegador
2. Faça login usando seu nome de usuário e senha
3. Clique em "Adicionar nova conexão"
4. Selecione "Cliente SMPP"
5. Digite o nome do host SMPP e a porta
6. Digite o número de telefone
7. Clique em OK para conectar o cliente SMPP
8. Verifique os logs do SMPP
9. Envie um SMS de teste

O cliente SMPP fornece uma maneira padronizada para que aplicativos enviem e recebam mensagens SMS em massa programaticamente para o Servidor SMPP. O cliente SMPP inicia uma conexão TCP/IP com o servidor. Isso torna os clientes SMPP essenciais para aplicativos como plataformas de marketing, sistemas de notificação e serviços de autenticação de dois fatores.

Este sistema funciona de forma que o usuário dá instruções ao seu computador para enviar uma mensagem (Figura 1). O computador encaminha essas informações para um Centro de SMS. Isso é feito através de uma conexão de cliente SMPP (Short Message Peer-to-Peer Protocol). O SMSC então envia a mensagem de texto para os dispositivos móveis dos destinatários.

O seguinte vídeo curto mostra os passos que você precisa seguir para configurar uma conexão de cliente SMPP no Ozeki SMS Gateway, que funciona em qualquer país. O vídeo começa com o formulário de login e leva você até o envio da sua primeira mensagem de texto como teste através da nova conexão de cliente SMPP criada.

Configurar uma conexão SMS SMPP no Ozeki SMS Gateway é um procedimento relativamente simples. Você precisa fazer login no gateway SMS usando um navegador como administrador e realizar alguns passos simples. Para a configuração, recomendamos fazer login usando a conta de administrador. O nome de usuário da conta de administrador é "admin", e a senha é a que você forneceu durante a instalação. (Figura 2)

Para criar uma nova conexão de cliente SMPP após o login, você precisa clicar no link 'Adicionar nova conexão' no console de gerenciamento do aplicativo Ozeki 10 SMS Gateway. Este link está localizado no painel de Conexões abaixo do texto "Nenhuma conexão está instalada..." (Figura 3). Este link exibirá uma lista de protocolos disponíveis. Observe que o SMPP é um protocolo SMS que pode ser usado para enviar mensagens SMS.

Para instalar a conexão de cliente SMPP, você terá que selecionar Cliente SMPP na lista de conexões disponíveis. O Cliente SMPP pode ser encontrado na seção Conexões SMS IP (Figura 4). Você precisa clicar em instalar para instalar o Cliente SMPP. Você usará uma conexão de cliente porque deseja conectar o gateway SMS a um provedor de serviços SMS pela Internet. (Se você deseja fornecer um serviço SMS e quer que seus clientes se conectem ao seu gateway SMS via SMPP, você precisa configurar uma conta de usuário SMPP e precisa configurar um serviço SMPP.)

Selecione o 'Cliente SMPP' da lista e clique em instalar.

Configurar a conexão do cliente SMPP

Para configurar a conexão do cliente SMPP, você precisa fornecer o nome do host e o número da porta do serviço SMPP, suas credenciais SMPP e deve especificar o número de telefone associado a esta conexão. Pode haver mais de um número de telefone associado a esta conexão. Nesse caso, forneça o primeiro e marque a caixa de seleção "substituível". Se esta caixa estiver marcada, você poderá usar todos os números de telefone como IDs de remetente.

Para configurar um cliente SMPP (Figura 5):

1. Selecione a aba Geral
2. Role até o formulário de configuração do cliente SMPP
3. Dê um nome a esta conexão do cliente SMPP
4. Insira o nome do host SMPP
5. Defina o número da porta SMPP
6. Forneça seu nome de usuário SMPP
7. Digite sua senha
8. Atribua um ID de remetente a este cliente SMPP
9. Clique em OK

É importante mencionar que o nome do host SMPP, a porta, o nome de usuário e a senha são fornecidos pelo seu provedor de serviços de SMS. Por exemplo, se você entrar em contato com a Vodafone e solicitar um serviço de SMS via SMPP, você assinará um contrato com eles, e frequentemente um anexo deste contrato conterá as seguintes informações de conexão. Se você assinar um serviço de SMS online, provavelmente encontrará essas informações no painel de controle online do seu provedor de serviços de SMS. Claro, você sempre pode perguntar ao seu provedor de serviços de SMS por e-mail e solicitar os detalhes de conexão do servidor SMPP.

Host SMPP:

O host SMPP é o nome do host ou endereço IP que o cliente SMPP usa para se conectar ao servidor SMPP. Este é o endereço IP (ou nome do host) do servidor SMPP.

Número da porta SMPP:

O número da porta SMPP é o número da porta TCP/IP que o cliente SMPP usa para se conectar ao servidor SMPP. Este número da porta é onde o servidor está escutando por conexões SMPP entrantes.

Nome de usuário SMPP:

O nome de usuário SMPP é o ID do sistema SMPP. Este identificador é fornecido pelo operador do servidor SMPP quando você se inscreve no serviço deles.

Senha SMPP:

A senha SMPP é a senha usada para autenticar sua conta SMPP no servidor SMPP. Esta senha é fornecida a você pelo operador do servidor SMPP (ou provedor de serviços SMPP) quando você se inscreve no serviço deles.

Número de telefone SMPP:

O número de telefone SMPP é o ID de remetente SMPP. Este é o número de telefone que é exibido no celular como o endereço do remetente, quando sua mensagem SMS é recebida.

Uma vez que a conexão do cliente SMPP esteja configurada, você deve verificar o log de conexão do cliente SMPP para ver se o sistema se conectou corretamente ao seu provedor de serviços de SMS. Se o sistema se conectou corretamente, você verá a entrada de log "Conexão online". Os logs de conexão de SMS podem ser encontrados no seguinte diretório no Windows: C:\Arquivos de Programas\Ozeki\Data\Logs\Connections\. Na aba Eventos da página de detalhes da conexão do cliente SMPP, você pode ver uma prévia do log. Esta página contém as últimas 100 entradas de log. Observe que os arquivos de log SMPP são rotacionados para economizar espaço em disco.

1. Abra a página de detalhes da conexão do cliente SMPP
2. Clique na aba Eventos
3. Clique no ícone de olho ao lado do título Eventos
4. Copie o nome do arquivo ao lado do título Eventos
5. Abra o Bloco de Notas
6. Cole o nome do arquivo na caixa de diálogo Arquivo/Abrir no Bloco de Notas
7. Clique em OK para abrir o arquivo de log SMPP
8. Use F3 para encontrar a data que você está interessado
9. Pesquise por "ERRO" para encontrar erros no log

Enviar uma mensagem SMS de teste

Uma vez que sua conexão estiver conectada, você pode verificar se está pronta para entregar mensagens SMS enviando um SMS de teste. Para enviar um SMS de teste, você precisa abrir a aba Teste e inserir o número de telefone e o texto da mensagem. É recomendado fornecer o número de telefone no formato internacional. Isso significa que o número de telefone deve começar com um sinal de mais seguido pelo código do país. Se o seu número de telefone local começar com 0, é provável que você precise remover o prefixo 0. Por exemplo, se o seu número de telefone no Reino Unido for 07958663698, você enviaria o SMS de teste para +447958663698.

1. Navegue até a página de detalhes da conexão do cliente SMPP
2. Selecione a aba Teste
3. Insira o número de telefone do destinatário
4. Certifique-se de que o número de telefone está no formato internacional
5. Insira o texto da mensagem
6. Certifique-se de que o texto da mensagem tenha menos de 160 caracteres
7. Clique no botão Enviar
8. Verifique os logs SMPP

O SMS é enviado usando o PDU submit_sm do SMPP através do link SMPP estabelecido entre o cliente SMPP e o servidor SMPP. Este PDU contém o ID do remetente, o endereço do destinatário, o texto da mensagem e todas as flags e parâmetros SMPP necessários para exibir o SMS corretamente no telefone móvel do destinatário.

Você pode se perguntar por que o texto da mensagem deve ter menos de 160 caracteres. Isso é porque o sistema GSM foi projetado para enviar mensagens de texto com até 160 caracteres. Se uma mensagem for mais longa, ela será dividida em vários segmentos de mensagem e será entregue em mais de um SMS.

Após a mensagem ser enviada com sucesso, você deve verificar os logs SMPP. Os logs SMPP revelarão as mensagens SMPP de baixo nível, que são usadas para passar o conteúdo da mensagem para o provedor de serviços SMS. Essas mensagens também são chamadas de PDU SMPP (unidade de dados do protocolo SMPP). Se houver um problema com o envio da mensagem, seu provedor de serviços SMS solicitará os logs SMPP. Neste caso, você precisará enviar os PDUs SMPP para eles. Para cada envio de SMS, dois PDUs SMPP aparecerão no log. Um é o PDU SMPP SUBMIT_SM, que passa a mensagem para o provedor de serviços SMS, e o SMPP SUBMIT_SM_RESP, que retorna um ID de referência que pode ser usado para rastrear uma mensagem e encontrar os relatórios de entrega retornados para você quando a mensagem é entregue ao aparelho do destinatário. (Figura 8)

A especificação do protocolo SMPP pode ser usada para entender cada PDU SMPP que você vê nos logs. Você verá que há várias operações nesta especificação do protocolo. Por exemplo, há uma operação para manter a conexão do cliente SMPP ativa usando mensagens keep alive, e há múltiplas operações para enviar e receber mensagens SMS e relatórios de entrega de SMS.

Download: smpp-protocol-specification-v3.4.pdf

O padrão SMPP é um protocolo em evolução. A primeira versão amplamente adotada foi a v3.3. Atualmente, a versão mais comum que você encontrará é a v3.4, mas também há uma versão mais recente, a v5.0, que raramente é usada em serviços de SMS.

O SMPP 3.3, a versão mais antiga, suporta apenas mensagens SMS GSM. Ele gera uma resposta imediata para cada mensagem enviada. Na maioria dos casos, esta versão não é suportada em conexões SSL. O problema com o SMPP 3.3 é que ele requer dois links SMPP: um link transmissor SMPP e um link receptor SMPP para o provedor de serviços SMS. Quando você configura um link SMPP v3.3 no Ozeki SMS Gateway, você precisará criar duas conexões de cliente SMPP e configurar uma como transmissor SMPP e a outra como receptor SMPP.

O protocolo SMPP 3.4 é semelhante ao SMPP 3.3, mas tem uma grande vantagem: permite que você envie e receba mensagens SMS através de um único link TCP/IP. No Ozeki SMS Gateway, você só precisará configurar uma conexão de cliente SMPP se desejar usar este protocolo. O SMPP v3.4 também adiciona parâmetros opcionais Tag-Length-Value (TLV) à mensagem SMS, o que permite ao usuário trabalhar com tecnologias de SMS não-GSM, como mensagens SMS em redes CDMA.

O SMPP 5.0 é a versão mais recente do SMPP. Ele estende a v3.4 adicionando suporte para transmissão celular, controle de fluxo inteligente. Poucos provedores de serviços SMS usam este protocolo. Recomendamos que você configure conexões SMPP v3.4 no Ozeki SMS Gateway.

Para testar sua conexão de cliente SMPP, é uma boa ideia configurar outro gateway SMPP como um Simulador SMPP. Desta forma, você pode realizar testes de desempenho e testar todos os aspectos do envio de mensagens SMS. Para ver como usamos este método de simulador SMPP para testar o desempenho do nosso gateway de SMS enviando 1 000 000 SMS através dele, confira a página de teste de desempenho SMPP.

Que tipo de parâmetros preciso para me conectar a um provedor de serviço SMPP?

Estes são os detalhes essenciais necessários para configurar uma conexão SMPP para seu Ozeki SMS Gateway:

• Endereço do Servidor/Nome do Host: Especifica a localização do servidor SMSC (seja seu endereço IP ou nome do host) para o gateway se conectar.
• Número da Porta: Define a porta TCP/IP específica no servidor SMSC que o gateway deve usar para comunicação.
• Nome de Usuário (System ID): Identifica sua conta no servidor SMSC.
• Senha: A senha associada ao seu nome de usuário para autenticação segura.
• Versão SMPP: Selecione a versão compatível do protocolo SMPP suportada pelo seu servidor SMSC (Ozeki suporta v3.3 e v3.4).
• Tipo de Sistema (Opcional): Necessário apenas se o servidor SMSC exigir. Este valor, geralmente "SMPP", será fornecido pelo seu administrador do sistema SMPP.
• Endereço do Remetente: O número de telefone padrão que aparece como remetente para mensagens SMS enviadas.
• Faixa de Endereço (Opcional): Usada principalmente para receber mensagens. Esta informação, enviada ao SMSC após o login, é relevante ao gerenciar múltiplos números de telefone em um único link SMPP.

O que é uma conexão transmissora SMPP?

Uma conexão transmissora SMPP é projetada especificamente para enviar mensagens SMS. Ela age como uma via de mão única, permitindo que seu Ozeki SMS Gateway transmita mensagens para o SMSC (Short Message Service Centre). Este tipo de conexão é ideal quando você só precisa enviar mensagens SMS e não requer funcionalidade de recebimento.

O que é uma conexão receptora SMPP?

Uma conexão receptora SMPP funciona apenas para receber mensagens SMS recebidas. Ela opera como uma caixa de correio dedicada, permitindo que o SMSC (Short Message Service Centre) entregue mensagens ao seu Ozeki SMS Gateway. Este tipo de conexão é adequado quando você só precisa receber mensagens recebidas e não planeja enviar nenhuma.

O que é uma conexão transceptora SMPP?

Uma conexão transceptora SMPP oferece uma opção versátil para enviar e receber mensagens SMS. Ela funciona como uma via de mão dupla, permitindo que seu Ozeki SMS Gateway transmita mensagens e receba mensagens recebidas do SMSC (Short Message Service Centre) através de uma única conexão TCP/IP. Este tipo de conexão é ideal para a maioria dos cenários onde você requer capacidades tanto de envio quanto de recebimento de SMS.

Resumo

Este guia forneceu todas as informações necessárias sobre como configurar uma conexão cliente SMPP no Ozeki SMS Gateway. SMPP é ótimo porque permite que você envie mensagens SMS para o SMSC pela Internet e o Ozeki SMS Gateway oferece excelente velocidade de entrega. Se você deseja configurar um serviço eficiente de notificação por SMS em seu negócio, SMPP é o caminho a seguir.

As informações que você obteve são valiosas, há outros documentos úteis neste guia, então continue lendo. É uma boa ideia conferir o guia de configuração do protocolo UCP e o tutorial de conexão cliente CIMD, porque esses protocolos oferecem conectividade SMSC de alta velocidade similar.

Agora baixe o Ozeki SMS Gateway e comece o trabalho!