Como receber SMS em Perl

A maneira mais simples de receber mensagens SMS em Perl é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar essa API, você enviará mensagens SMS através de uma solicitação HTTP Post para o gateway de SMS. A solicitação HTTP Post conterá uma mensagem formatada em JSON. O gateway de SMS enviará esse SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para sua solicitação.

como receber sms em perl
Figura 1 - Como receber SMS em Perl

Código Perl para receber SMS de um celular

O exemplo de código Perl para SMS abaixo demonstra como você pode receber SMS usando a API HTTP Rest de SMS do Ozeki SMS Gateway com a biblioteca Perl Ozeki.Libs.Rest. Esta biblioteca é fornecida gratuitamente, e você pode usá-la e modificá-la em qualquer um de seus projetos.

ReceiveSms.pl
use Ozeki::Libs::Rest::Configuration;
use Ozeki::Libs::Rest::MessageApi;

my $configuration = new Ozeki::Libs::Rest::Configuration();
$configuration->{ Username } = "http_user";
$configuration->{ Password } = "qwe123";
$configuration->{ ApiUrl } = "http://127.0.0.1:9509/api";

my $api = new Ozeki::Libs::Rest::MessageApi($configuration);

my $result = $api->DownloadIncoming();

print($result->stringify, "\n");

foreach my $message (@{ $result->{ messages } }) {
    print($message->stringify, "\n");
}

Como usar o exemplo de SMS em Perl:

Este exemplo de SMS em Perl pode ser usado em qualquer aplicação Perl. Para usá-lo, você deve adicionar a biblioteca Ozeki.Libs.Rest ao seu projeto. Após adicionar a biblioteca, você deve incluir a diretiva use Ozeki::Libs::Rest; na seção de cabeçalho do seu código-fonte Perl. Isso permitirá que você use as classes fornecidas pela biblioteca Ozeki.Libs.Rest. Você pode usar a classe Message para criar o SMS. Você pode usar a classe MessageApi para receber as mensagens SMS no gateway de SMS. O gateway de SMS encaminhará sua mensagem para a rede móvel através de uma conexão wireless ou pela Internet.

Baixar ReceiveSms.pl

O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: ReceiveSms.pl.zip (76.0Kb)

O que há no arquivo ReceiveSms.pl.zip?

O arquivo ReceiveSms.pl.zip contém a biblioteca Ozeki.Libs.Rest, que fornece todas as ferramentas necessárias para enviar e receber mensagens SMS. Você também encontrará o arquivo ReceiveSms.pl no zip, que contém o código de exemplo para mostrar como receber um SMS. Este código de exemplo está listado abaixo.

Figura 2 - O que há dentro de ReceiveSms.pl.zip

Como receber SMS em Perl (Passos simples)

Para receber SMS em Perl:

  1. Baixe o arquivo ReceiveSms.pl.zip
  2. Extraia o arquivo .zip da pasta de Downloads
  3. Abra o arquivo ReceiveSms.pl em um editor de texto
  4. Inicie o Ozeki SMS Gateway
  5. Clique em HTTP user na aba Usuários e aplicações
  6. Execute ReceiveSms.pl para receber SMS usando o prompt de comando
  7. Verifique a Caixa de Entrada no Ozeki SMS Gateway
Instale o Ozeki SMS Gateway e crie um usuário HTTP API

Para poder enviar e receber SMS em Perl, primeiro você precisa instalar o Ozeki SMS Gateway. O gateway de SMS pode ser instalado no mesmo computador onde você desenvolve seu código Perl no Visual Studio. Após a instalação, o próximo passo é conectar o Ozeki SMS Gateway à rede móvel. Você pode enviar um SMS de teste da interface gráfica do Ozeki para verificar se sua conexão com a rede móvel está funcionando. O passo final para preparar seu ambiente é criar um usuário de API HTTP para SMS. Crie um usuário com o nome "http_user" e senha "qwe123" para que o exemplo funcione sem modificações.

Após configurar o ambiente, você pode executar seu código Perl.

URL da API HTTP para receber SMS em Perl

Para enviar SMS em Perl, seu código Perl terá que fazer uma solicitação HTTP para o gateway de SMS. A URL da API é mostrada abaixo. Observe que o endereço IP (127.0.0.1) deve ser substituído pelo endereço IP do seu gateway de SMS. Se o Ozeki SMS Gateway estiver instalado no mesmo computador onde a aplicação Perl está sendo executada, pode ser 127.0.0.1. Se estiver instalado em um computador diferente, deve ser o endereço IP desse computador.

http://127.0.0.1:9509/api?action=rest
Autenticação HTTP para receber SMS em Perl

Para autenticar o cliente de SMS em Perl, você precisa enviar o nome de usuário e senha em uma string codificada em base64 para o servidor em uma solicitação HTTP. O formato usado é: base64(nome de usuário+":"+senha). Em Perl, você pode usar o seguinte código para fazer essa codificação:

my ($self, $Username, $Password) = @_;
my $Username_Password = "${Username}:${Password}";
my $Username_Password_encoded = encode_base64($Username_Password);
return "Basic ${Username_Password_encoded}";
	

Por exemplo, se você codificar o nome de usuário 'http_user' e a senha 'qwe123', você obterá a seguinte string codificada em base64: aHR0cF91c2VyOnF3ZTEyMw==. Para enviar

Requisição HTTP para receber SMS com Perl

Para receber SMS, sua aplicação Perl enviará uma requisição HTTP semelhante à mostrada abaixo. Note que esta requisição contém uma parte de cabeçalho HTTP e uma parte de corpo HTTP. O corpo HTTP é uma string de dados codificada em JSON. Ela contém o número do destinatário e o texto da mensagem.

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Connection: TE, close
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 192.168.0.14:9509
Te: deflate,gzip;q=0.3
User-Agent: libwww-perl/6.43
	

Cabeçalho de requisição HTTP para receber SMS de C#

Para enviar as mensagens SMS, você precisa incluir as seguintes linhas como cabeçalhos na requisição HTTP. Note que incluímos um tipo de conteúdo e um cabeçalho de Autorização.

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
	

Resposta HTTP recebida pelo exemplo de SMS em Perl

Assim que o gateway SMS receber esta requisição, ele gerará uma resposta HTTP. A resposta HTTP conterá um código de status, para indicar se o envio do SMS foi bem-sucedido ou não. Também retornará uma estrutura codificada em JSON para fornecer detalhes úteis sobre o envio da mensagem.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 02 Jul 2021 16:00:35 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "limit": "1000",
	  "data": [
	    {
	      "message_id": "a860555d-db45-11eb-82d5-c00c4d4e2ea7",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36201111111",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 1",
	      "create_date": "2021-07-02 14:56:18",
	      "valid_until": "2021-07-09 14:56:18",
	      "time_to_send": "2021-07-02 14:56:18",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "a8607b04-db45-11eb-818e-c00c4d4e2ea7",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36202222222",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 2",
	      "create_date": "2021-07-02 14:56:18",
	      "valid_until": "2021-07-09 14:56:18",
	      "time_to_send": "2021-07-02 14:56:18",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "a8609539-db45-11eb-80db-c00c4d4e2ea7",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36203333333",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 3",
	      "create_date": "2021-07-02 14:56:18",
	      "valid_until": "2021-07-09 14:56:18",
	      "time_to_send": "2021-07-02 14:56:18",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    }
	  ]
	}
}

Como receber SMS com Perl usando a API de SMS em Perl (Tutorial em vídeo)

Estes vídeos mostrarão como instalar o módulo Ozeki::Libs::Rest e como usar o programa de exemplo ReceiveSms.pl. O vídeo mostrará como você pode baixar a pasta do projeto ReceiveSMS.pl, como configurar um sistema que você pode começar a usar. O vídeo tem apenas 1:30 de duração, mas apresenta todos os passos que você precisa seguir. O tutorial é claro e fácil de seguir, então você não terá problemas para copiar o processo.

Vídeo 1 - Como baixar e configurar a solução de exemplo (Tutorial em vídeo)

Exemplo de SMS em Perl: ReceiveSms.pl

Na Figura 3, você pode ver o código-fonte do ReceiveSMS.pl. Este código baixará todas as mensagens recebidas de um servidor e as imprimirá na tela. Você precisa fornecer as credenciais de login do servidor nas variáveis 'Username' e 'Password'. Se você estiver familiarizado com a linguagem de programação Perl, sinta-se à vontade para modificar o código para que ele atenda perfeitamente às suas necessidades.

Figura 3 - ReceiveSms.pl

Como receber SMS com o código em Perl (Tutorial em vídeo)

Neste vídeo, você verá o código em ação. Vamos mostrar como executar o código e verificar seus resultados. Ele começará com um terminal aberto e o código aberto e o levará até a leitura das mensagens recebidas. O vídeo tem apenas 1 minuto de duração e é fácil de seguir. Você não terá problemas para seguir os passos.

Vídeo 2 - Como receber SMS com o código em Perl acima (Tutorial em vídeo)

Para resumir

Este artigo explicou como receber mensagens SMS do Perl usando a API REST SMS HTTP integrada do Ozeki SMS Gateway. Se você seguiu o tutorial com atenção, agora é capaz de criar um usuário HTTP no Ozeki SMS Gateway e usar o repositório fornecido para receber mensagens SMS com a API SMS Perl. Esta biblioteca é fornecida gratuitamente e você pode usá-la e modificá-la em qualquer um de seus projetos.

Quanto mais conhecimento você tiver, mais eficiente poderá ser, então continue lendo. Confira o artigo Como baixar a biblioteca Perl SMS mais recente do Github e aprenda a usar a API SMS Perl de forma mais ampla.

Baixe o Ozeki SMS Gateway agora e comece a trabalhar!

More information