Como enviar múltiplos SMS a partir de Perl
A maneira mais simples de enviar múltiplos SMS a partir de Perl é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar esta API, você enviará mensagens SMS através de uma requisição HTTP Post para o gateway de SMS. A requisição HTTP Post irá conter uma mensagem formatada em JSON. O gateway de SMS irá enviar este SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para a sua requisição.
O exemplo de código Perl para SMS abaixo demonstra como você pode enviar 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 dos seus projetos.
SendMultipleSms.pluse Ozeki::Libs::Rest::Configuration; use Ozeki::Libs::Rest::MessageApi; use Ozeki::Libs::Rest::Message; my $configuration = new Ozeki::Libs::Rest::Configuration(); $configuration->{ Username } = "http_user"; $configuration->{ Password } = "qwe123"; $configuration->{ ApiUrl } = "http://127.0.0.1:9509/api"; my $msg1 = new Ozeki::Libs::Rest::Message(); $msg1->{ ToAddress } = "+36201111111"; $msg1->{ Text } = "Hello world 1"; my $msg2 = new Ozeki::Libs::Rest::Message(); $msg2->{ ToAddress } = "+36202222222"; $msg2->{ Text } = "Hello world 2"; my $msg3 = new Ozeki::Libs::Rest::Message(); $msg3->{ ToAddress } = "+36203333333"; $msg3->{ Text } = "Hello world 3"; my $api = new Ozeki::Libs::Rest::MessageApi($configuration); my $result = $api->Send(( $msg1, $msg2, $msg3 )); print($result->stringify);
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 a biblioteca ser adicionada, 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 enviar as mensagens SMS para o 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 SendMultipleSms.pl
O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: SendMultipleSms.pl.zip (76.1Kb)
O arquivo SendMultipleSms.pl 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 SendMultipleSms no zip, que contém o código de exemplo para mostrar como enviar um SMS. Este código de exemplo está listado abaixo.
Para enviar múltiplos SMS a partir de Perl:
- Configure o Strawberry Perl
- Baixe o arquivo SendMultipleSms.pl.zip
- Extraia o arquivo .zip da pasta de Downloads
- Abra o arquivo SendSms.pl no Notepad ou Visual Studio Code
- Inicie o Ozeki SMS Gateway
- Crie um usuário de API HTTP no Ozeki
- Execute o código Perl SendMultipleSms.pl no prompt de comando
- Verifique a caixa Enviados no Ozeki SMS Gateway
Para poder enviar SMS a partir de 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 a partir 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 fazer o exemplo funcionar sem modificações.
Após o ambiente estar configurado, você pode executar seu código Perl.
URL da API HTTP para enviar SMS a partir de PerlPara enviar SMS a partir de Perl, seu Perl terá que fazer uma requisiçã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á rodando, 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
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 requisição HTTP. O formato usado é: base64(nome_de_usuário+":"+senha). Em Perl, você pode usar o seguinte código para fazer esta 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
Cabeçalho da requisição HTTP para enviar SMS a partir de Perl
Para enviar as mensagens SMS, você precisa incluir as seguintes linhas como cabeçalhos na requisição HTTP. Observe que incluímos um tipo de conteúdo e um cabeçalho de Autorização.
Content-Type: application/json Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Para submeter o SMS, sua aplicação Perl enviará uma requisição HTTP semelhante à mostrada abaixo. Observe 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.
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 a submissão do SMS foi bem-sucedida ou não. Também retornará uma estrutura codificada em JSON para fornecer detalhes úteis sobre a submissão 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": "Messages queued for delivery.", "data": { "total_count": 3, "success_count": 3, "failed_count": 0, "messages": [ { "message_id": "ab4c1e78-db41-11eb-8298-c00c4d4e2ea7", "from_station": "%", "to_address": "+36201111111", "to_station": "%", "text": "Hello world 1", "create_date": "2021-07-02 14:27:45", "valid_until": "2021-07-09 14:27:45", "time_to_send": "2021-07-02 14:27:45", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": false, "tags": [ { "name": "Type", "value": "SMS:TEXT" } ], "status": "SUCCESS" }, { "message_id": "ab4c4523-db41-11eb-838d-c00c4d4e2ea7", "from_station": "%", "to_address": "+36202222222", "to_station": "%", "text": "Hello world 2", "create_date": "2021-07-02 14:27:45", "valid_until": "2021-07-09 14:27:45", "time_to_send": "2021-07-02 14:27:45", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": false, "tags": [ { "name": "Type", "value": "SMS:TEXT" } ], "status": "SUCCESS" }, { "message_id": "ab4c59cd-db41-11eb-82c0-c00c4d4e2ea7", "from_station": "%", "to_address": "+36203333333", "to_station": "%", "text": "Hello world 3", "create_date": "2021-07-02 14:27:45", "valid_until": "2021-07-09 14:27:45", "time_to_send": "2021-07-02 14:27:45", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": false, "tags": [ { "name": "Type", "value": "SMS:TEXT" } ], "status": "SUCCESS" } ] }
Neste vídeo, você verá o processo de download e configuração do projeto SendMultipleSMS.pl. Começará com o download do projeto e terminará com a configuração concluída. Você aprenderá todos os passos do processo de configuração necessários para ter uma solução funcional. O vídeo tem 1:44 de duração, mas mostra todos os passos de forma muito detalhada. Após assisti-lo, você poderá baixar e configurar a solução por conta própria.
O código de exemplo
Na Figura 3, você pode ver o código de exemplo. Este código de exemplo enviará múltiplas mensagens SMS para múltiplos destinatários. Se você estiver familiarizado com a linguagem de programação Perl, sinta-se à vontade para modificar o código conforme desejar. Ele enviará SMS para todos os números de telefone armazenados como variável 'ToAddress', com o texto armazenado nas variáveis Text.
Neste vídeo, você verá o projeto de exemplo em ação. Mostraremos o que você precisa fazer para que o projeto envie múltiplas mensagens SMS com apenas uma execução. O vídeo tem apenas 1:12 de duração e contém todas as informações necessárias para iniciar o programa. Começará com o projeto aberto e terminará com todas as mensagens enviadas.
Resumo
O guia acima explicou os passos para enviar múltiplos SMS em Perl com o Ozeki SMS Gateway. Se todos os passos foram seguidos cuidadosamente, você deverá ser capaz de alcançar múltiplos clientes com um código Perl e o Ozeki SMS Gateway. Com esta solução, um grande número de clientes pode receber seus SMS ao mesmo tempo. É importante notar que o Ozeki SMS Gateway oferece alto desempenho, podendo enviar até 1000 SMS por segundo.
Certifique-se de não terminar a leitura aqui, visite a página de tutoriais do Ozeki, onde mais informações podem ser encontradas sobre tópicos similares, como agendamento de SMS em Perl.
A única coisa a fazer agora é baixar o Ozeki SMS Gateway e começar a trabalhar!
More information
- Enviar SMS em Perl com a API REST HTTP (exemplo de código)
- Enviar múltiplos SMS em Perl com a API REST HTTP (exemplo de código)
- Agendar SMS em Perl com a API REST HTTP (exemplo de código)
- Receber SMS em Perl com a API REST HTTP (exemplo de código)
- Excluir SMS em Perl com a API REST HTTP (exemplo de código)
- Como baixar a última biblioteca de SMS em Perl do Github