Acesso ao SMPP

Este documento conceitual descreve o uso do SMPP em vez do REST para acessar as APIs da Vonage. A implementação do acesso via SMPP exige um profundo conhecimento desse complexo protocolo de telecomunicações e muito trabalho de desenvolvimento de baixo nível. A maioria dos desenvolvedores pode ignorar essas informações sem problemas.

Por padrão, seu Account está configurado para usar as APIs REST da Vonage por HTTPS. A menos que sua organização seja um agregador com uma implementação SMPP já existente, as informações contidas neste guia provavelmente não serão relevantes para você.

Índice

Este documento aborda os seguintes assuntos:

O que é o SMPP?

Protocolo de Mensagens Curtas Peer-to-Peer (SMPP) é um protocolo utilizado pelo setor de telecomunicações para a troca de mensagens SMS entre Centros de Serviço de Mensagens Curtas (SMSC) e/ou Entidades Externas de Mensagens Curtas (ESME).

O SMPP é um protocolo TCP/IP de nível 7, que permite o envio rápido de mensagens SMS. É amplamente utilizado para a troca de mensagens curtas fora das redes SS7 devido ao seu suporte a protocolos SMS não GSM, tais como UMTS e CDMA.

A Vonage utiliza o SMPP para se conectar a diversas operadoras em todo o mundo. Como o SMPP é um padrão, esperamos que quaisquer novas operadoras que incorporarmos ofereçam meios padrão de conectividade. Se isso ocorrer, poderemos integrá-las com relativa facilidade.

Devo usar o SMPP para me conectar à plataforma da Vonage?

A Vonage oferece não incentivamos o acesso ao SMPP pelas seguintes razões:

  • O SMPP é um protocolo de telecomunicações muito complexo. É preciso ser um especialista na área para utilizá-lo corretamente.
  • A implementação exige muito trabalho de desenvolvimento de baixo nível, ao contrário das nossas APIs REST.
  • A Vonage oferece não oferecer alta disponibilidade global ou recuperação de desastres por meio do SMPP. Isso se deve ao design do protocolo, que exige o estabelecimento de uma ligação entre um cliente e um servidor antes que seja possível trocar mensagens. Se uma das instâncias SMPP da Vonage apresentar falha, os clientes que estiverem utilizando essa instância deverão:
    • Já estar vinculado a outra instância e redirecionar o tráfego
    • Identificar que não estão mais vinculados a uma instância e procurar se vincular a outra instância

Por que a Vonage oferece acesso SMPP?

A Vonage oferece esse serviço para integrar novas operadoras e facilitar o uso da nossa plataforma por clientes que já possuem uma implementação de SMPP.

Em vez de ter que reimplementar o sistema de mensagens por meio de nossas APIs REST, você pode modificar sua integração atual para estabelecer uma conexão com os clusters SMPP da Vonage.

Configurando o acesso SMPP

Você pode configurar o acesso SMPP à plataforma da Vonage utilizando um dos seguintes métodos:

Configuração padrão

  1. Leia o Perguntas frequentes sobre o SMPP, que contém detalhes sobre codificação de caracteres, formatos DLR, mensagens concatenadas, gerenciamento de limitação de tráfego e outras informações importantes.
  2. Envie-nos um e-mail sua previsão de volume mensal. Configuraremos nosso sistema para habilitar o acesso SMPP para você e enviaremos um e-mail de confirmação com links para recursos adicionais.

Como usar o Kannel

Você pode usar Kannel versão 1.4.3 ou superior para configurar o acesso SMPP:

  1. Preencha o configuração padrão etapas.

  2. Baixe o kannel.conf arquivo de configuração.

  3. Editar kannel.conf para substituir $nexmo_user e $nexmo_password com suas credenciais SMPP da Vonage.

  4. Por motivos de segurança kannel.conf permite acesso apenas a partir de localhost. Para permitir o acesso a partir de outro computador, edite os seguintes parâmetros em kannel.conf. Por exemplo, para os endereços IP X.X.X.X e Y.Y.Y.Y:

    admin-allow-ip = "127.0.0.1;X.X.X.X;Y.Y.Y.Y"
...
box-allow-ip = "127.0.0.1;X.X.X.X;Y.Y.Y.Y"
...
user-allow-ip = "127.0.0.1;X.X.X.X;Y.Y.Y.Y"

  5. Reinicie o Kannel.

  6. Envie uma mensagem de teste. Por exemplo:

    https://localhost:13013/cgi-bin/sendsms?username=username&password=pwd&to=%2B33XXXXXXX&text=Hello%20World&from=test&charset=ISO-8859-1&dlr-mask=17

Nossas instâncias SMPP

A Vonage hospeda cinco instâncias do SMPP:

  • SMPP1/2 - agrupado (NA)
  • SMPP3/4 - agrupado (APAC)
  • SMPP0 - não agrupados

Recomendamos que você vincule a ambos SMPP1 e SMPP2 ou ambos SMPP3 e SMPP4. Vincular apenas a SMPP0 se não for possível estabelecer conexão com uma configuração em cluster.

A instância autônoma SMPP0 destinado a agregadores que utilizam infraestrutura legada e não conseguem manter ligações simultâneas a vários endereços IP. Se você estiver fazendo a ligação a SMPP0, é necessário implementar a redundância do SMPP para evitar um risco maior de interrupções planejadas e não planejadas.

Recursos