Como agendar um SMS em Java

A maneira mais simples de enviar SMS a partir de Java é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar esta API, você enviará mensagens SMS enviando uma solicitação HTTP Post para o gateway de SMS. A solicitação HTTP Post conterá uma mensagem formatada em formato json. O gateway de SMS enviará este SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para sua solicitação.

como enviar um sms agendado a partir de java
Figura 1 - Como enviar um SMS agendado a partir de Java

Código Java para enviar sms para celular

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

Main.java 
import Ozeki.Libs.Rest.*;
import java.time.LocalDateTime;

public class Main {

    public static void main(String[] args) {

        var configuration = new Configuration();
        configuration.Username = "http_user";
        configuration.Password = "qwe123";
        configuration.ApiURL = "http://127.0.0.1:9509/api";

        var msg = new Message();
        msg.ToAddress = "+36201111111";
        msg.Text = "Hello world!";
        msg.TimeToSend = LocalDateTime.parse("2021-06-11T13:52:00");

        var api = new MessageApi(configuration);
        
        var result = api.Send(msg);
        
        System.out.println(result);
    }
}

Como usar o exemplo de SMS em Java:

Você pode usar a classe Message para criar o SMS e pode usar a classe MessageApi para enviar o SMS para o gateway de SMS. O gateway de SMS encaminhará sua mensagem para a rede móvel através de uma conexão sem fio ou através da Internet.

Baixar SendScheduledSms.java

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

O que está no arquivo SendScheduledSms.java.zip?

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

Figura 2 - Diretório SendScheduledSms.java

Como enviar SMS agendado a partir de Java (Passos rápidos)

Para enviar SMS agendado a partir de Java:

  1. Instale o Ozeki SMS Gateway
  2. Conecte o Ozeki SMS Gateway à rede móvel
  3. Envie um SMS de teste a partir da interface gráfica do Ozeki
  4. Crie um usuário de API HTTP para SMS
  5. Apache NetBeans
  6. Crie um projeto chamado SendScheduledSms
  7. Coloque o código em um arquivo Main.java recém-criado ou use o arquivo Main.java no .zip
  8. Crie o SMS criando um novo objeto Message
  9. Crie uma API para enviar sua mensagem
  10. Use o método Send para enviar sua mensagem
  11. Especifique o atributo TimeToSend da mensagem recém-criada
  12. Leia a mensagem de resposta no console
  13. Verifique os logs no gateway de SMS
Instale o Ozeki SMS Gateway e crie um usuário de API HTTP

Para poder enviar SMS a partir de Java, primeiro você precisa instalar o Ozeki SMS Gateway. O gateway de SMS pode ser instalado no mesmo computador onde você desenvolve seu código Java no Apache NetBeans. 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 de usuário "http_user" e senha "qwe123" para fazer o exemplo funcionar sem modificações.

Após a configuração do ambiente, você pode executar seu código Java.

URL da API HTTP para enviar SMS a partir de Java

Para enviar SMS a partir de Java, seu aplicativo Java terá que enviar 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 o aplicativo Java de SMS está sendo executado, 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 enviar SMS a partir de Java

Para autenticar o cliente Java de SMS, 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 Java, você pode usar o seguinte código para fazer essa codificação: 

var usernamePassword = username + ":" + password;
var encodedUsernamePassword = usernamePassword.getBytes();
return "Basic " + Base64.getEncoder().encodeToString(encodedUsernamePassword);

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 agendado a partir de Java

Para enviar a mensagem SMS agendada, 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==

Requisição HTTP para enviar SMS a partir de Java

Para submeter o SMS, sua aplicação Java 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. 

POST /api?action=sendmsg HTTP/1.1
HTTP2-Settings: AAEAAEAAAAIAAAABAAMAAABkAAQBAAAAAAUAAEAA
Connection: Upgrade, HTTP2-Settings
Upgrade: h2c
Content-Length: 320
Content-Type: application/json
Accept: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Java-http-client/16.0.1

{
"messages":	[
	{
		"message_id": "5b9cea01-6bc0-42a7-9409-7b86eedf851b",
		"submit_report_requested": true,
		"view_report_requested": true,
		"valid_until": "2021-06-18 13:49:36",
		"time_to_send": "2021-06-11 13:52:00",
		"to_address": "+36201111111",
		"text": "Hello world!",
		"create_date": "2021-06-11 13:49:36",
		"delivery_report_requested": true
	}
]
}

Resposta HTTP recebida pelo exemplo de SMS em Java

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. Ela também retornará uma estrutura codificada em JSON para fornecer detalhes úteis sobre a submissão das mensagens. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 11 Jun 2021 13:37:11 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked

{
"http_code": 200,
"response_code": "SUCCESS",
"response_msg": "Messages queued for delivery.",
"data": {
  "total_count": 1,
  "success_count": 1,
  "failed_count": 0,
  "messages": [
    {
      "message_id": "5b9cea01-6bc0-42a7-9409-7b86eedf851b",
      "from_station": "%",
      "to_address": "+36201111111",
      "to_station": "%",
      "text": "Hello world!",
      "create_date": "2021-06-11 13:49:36",
      "valid_until": "2021-06-18 13:49:36",
      "time_to_send": "2021-06-11 13:52:00",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": false,
      "tags": [
        {
          "name": "Type",
          "value": "SMS:TEXT"
        }
      ],
      "status": "SUCCESS"
    }
  ]
}
}

Como enviar SMS a partir de Java usando a API de SMS em Java (Tutorial em vídeo)

Este vídeo mostra como criar um novo projeto no Apache NetBeans, como nomeá-lo para SendScheduledSms. Uma vez que a solução é criada, você pode notar que há uma pasta chamada <default package> no seu projeto dentro da pasta Source Packages. É aqui que você criará ou colará o arquivo Main.java. Em seguida, você deve colar a pasta Ozeki na pasta Source Packages e estas são todas as preparações necessárias para enviar um SMS usando Java.

Vídeo 1 - Como baixar Ozeki.Libs.Rest e configurar seu projeto (Tutorial em vídeo)

Código Java para enviar SMS para celular

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

Main.java 
import Ozeki.Libs.Rest.*;
import java.time.LocalDateTime;

public class Main {

    public static void main(String[] args) {

        var configuration = new Configuration();
        configuration.Username = "http_user";
        configuration.Password = "qwe123";
        configuration.ApiURL = "http://127.0.0.1:9509/api";

        var msg = new Message();
        msg.ToAddress = "+36201111111";
        msg.Text = "Hello world!";
        msg.TimeToSend = LocalDateTime.parse("2021-06-11T13:52:00");

        var api = new MessageApi(configuration);
        
        var result = api.Send(msg);
        
        System.out.println(result);
    }
}

Como usar o exemplo de SMS em Java:

Você pode usar a classe Message para criar o SMS e pode usar a classe MessageApi para enviar o SMS para o gateway SMS. O gateway SMS encaminhará sua mensagem para a rede móvel através de uma conexão sem fio ou através da Internet.

Exemplo de SMS em Java: Main.java

Figura 3 - Projeto SendScheduledSms

Como verificar se o SMS foi aceito pelo usuário HTTP

Após o SMS ter sido submetido, é uma boa ideia verificar seu gateway SMS, para ver o que foi recebido. Você pode verificar o log abrindo os detalhes do usuário HTTP a partir do console de gerenciamento do Ozeki SMS Gateway. O vídeo a seguir mostra o que você deve procurar.

Vídeo 2 - Como enviar um SMS agendado com o código Java acima (Tutorial em vídeo)

Conclusão

Este artigo forneceu uma visão sobre o agendamento de SMS em Java com o Ozeki SMS Gateway. Se você deseja enviar mensagens de texto em um horário específico, o agendamento de SMS pode ser muito útil. Usando este guia e o código acima, você terá todo o conhecimento e as ferramentas necessárias para tornar o agendamento de SMS possível. O Ozeki SMS Gateway permite que você registre mensagens em um banco de dados e oferece inúmeras capacidades de relatórios para fornecer todas as informações que você precisa sobre a comunicação por SMS.

Continue lendo na página de tutoriais da Ozeki, onde você pode encontrar mais informações sobre tópicos como recebimento em Java.

A única coisa a fazer agora é baixar o Ozeki SMS Gateway e começar a trabalhar!

More information