Como agendar um SMS em C/C++

A maneira mais simples de enviar SMS a partir de C/C++ é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar esta API, você enviará mensagens SMS realizando 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. (Figura 1)

como agendar um sms em ccpp
Figura 1 - Como agendar um SMS em C/C++

Código C/C++ para enviar sms agendado para celular

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

SendScheduledSms.cpp 
#include 
#include 
#include "Ozeki.Libs.Rest.h"

using namespace std;

int main()
{
    //Função para criar identificador único para cada mensagem
    srand((unsigned)time(0));

    Configuration configuration;
    configuration.Username = "http_user";
    configuration.Password = "qwe123";
    configuration.ApiUrl = "http://127.0.0.1:9509/api";

    Message msg;
    msg.ToAddress = "+36201111111";
    msg.Text = "Hello world!";
    msg.TimeToSend = localdatetime(2021, 6, 29, 10, 0, 0);

    MessageApi api(configuration);

    auto result = api.Send(msg);

    cout << result << endl;

    return 0;
}

Como usar o exemplo de SMS em C/C++:

Este exemplo de SMS em C/C++ pode ser usado em qualquer aplicação C ou C++ core. Para usá-lo, você deve adicionar a dll Ozeki.Libs.Rest como referência ao seu projeto. Após adicionar a referência do projeto, você deve colocar a diretiva using Ozeki.Libs.Rest; na seção de cabeçalho do seu código-fonte C/C++. 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 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 pela Internet.

Vídeo 1 - Como baixar e configurar o projeto de exemplo acima (Tutorial em vídeo)

Baixar SendScheduledSms.cpp

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

O que está no arquivo SendScheduledSms.cpp?

O arquivo SendScheduledSms.cpp 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 projeto SendScheduledSms no zip, que contém o código de exemplo para mostrar como enviar um SMS agendado. Este código de exemplo está listado abaixo. (Figura 2)

projeto de exemplo para enviar mensagens sms agendadas usando c plus plus
Figura 2 - O que está dentro de SendScheduledSms.cpp.zip

Como enviar SMS agendado a partir de C/C++ (Diretrizes simples)

Para enviar SMS agendado a partir de C/C++:

  1. Instalar usuário da API HTTP
  2. Configurar o Visual Studio
  3. Baixar o arquivo SendScheduledSms.cpp.zip
  4. Extrair o arquivo .zip da pasta Downloads
  5. Abrir o arquivo SendScheduledSms.sln no Visual Studio
  6. Adicionar a dll Ozeki.Libs.Rest como referência
  7. Editar o arquivo para agendar SMS a partir de C/C++
  8. Iniciar o Ozeki SMS Gateway
  9. Executar SendScheduledSms.cpp no Visual Studio para enviar SMS a partir de C/C++
  10. Verificar os logs
Instalar o Ozeki SMS Gateway e criar um usuário da API HTTP

Para poder enviar SMS a partir de C/C++, primeiro você precisa instalar o Ozeki SMS Gateway. O gateway de SMS pode ser instalado no mesmo computador onde você desenvolve seu código C/C++ 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 da API HTTP de 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 C/C++.

URL da API HTTP para enviar SMS a partir de C/C++

Para enviar SMS a partir de C/C++, seu código C/C++ 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 o aplicativo de SMS em C/C++ 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 C/C++

Para autenticar o cliente SMS em C/C++, 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 utilizado é: base64(nome de usuário+":"+senha). Em C++ você pode usar o seguinte código para fazer essa codificação: 

string usernamePassword = username + ":" + password;
string usernamePasswordEncoded = base64::encode(usernamePassword);
return "Basic " + usernamePasswordEncoded;

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 C/C++

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==

Requisição HTTP para enviar SMS agendado a partir de C/C++

Para submeter o SMS, sua aplicação em C/C++ enviará uma requisição HTTP similar à 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
Content-Length: 320
Content-Type: application/json
Accept: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

{
	"messages":	[
		{
			"create_date":	"2021-06-29T10:21:47",
			"message_id":	"gi0j9bk6-y7wv-35qq-tksz-nzgwbc2sxznq",
			"submit_delivery_requested":	true,
			"submit_report_requested":	true,
			"submit_view_requested":	true,
			"text":	"Olá mundo!",
			"time_to_send":	"2021-06-29T10:30:00",
			"to_address":	"+36201111111",
			"valid_until":	"2021-07-06T10:21:47"
		}
	]
}

Resposta HTTP recebida pelo exemplo de SMS em C/C++

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 requisição de envio de SMS foi bem-sucedida ou não. Ela 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: Tue, 29 Jun 2021 10:13:46 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "Mensagens enfileiradas para envio.",
	"data": {
	  "total_count": 1,
	  "success_count": 1,
	  "failed_count": 0,
	  "messages": [
	    {
	      "message_id": "gi0j9bk6-y7wv-35qq-tksz-nzgwbc2sxznq",
	      "from_station": "%",
	      "to_address": "+36201111111",
	      "to_station": "%",
	      "text": "Olá mundo!",
	      "create_date": "2021-06-29 10:21:47",
	      "valid_until": "2021-07-06 10:21:47",
	      "time_to_send": "2021-06-29 10:30:00",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ],
	      "status": "SUCCESS"
	    }
	  ]
	}
}

Exemplo de SMS em C/C++: SendScheduledSms.sln

O código de exemplo abaixo faz parte da Solução Visual Studio SendScheduledSms.sln. Uma solução do Visual Studio pode conter múltiplos projetos e múltiplos arquivos. Nesta solução há apenas um projeto: SendScheduledSms.vcxproj, e um arquivo: SendScheduledSms.cpp.

solução para enviar mensagens SMS agendadas usando c plus plus
Figura 3 - SendScheduledSms.sln

Como enviar um SMS agendado com o código em C++ (Tutorial em vídeo)

O vídeo a seguir explica como agendar um SMS com um código em C/C++. O vídeo começa com a abertura do Ozeki SMS Gateway e, ao completar todos os passos, você terá uma mensagem SMS aguardando envio na pasta de adiados. Este vídeo de 1:44 minuto é fácil de entender e mostra todos os passos claramente. Você usará o painel do Ozeki SMS Gateway que permite acessar as funções mais importantes com um único clique. Você aprenderá como iniciar o Ozeki SMS Gateway e como verificar a pasta de saída. Como executar o código e como fornecer o horário de envio do SMS.

Vídeo 2 - Enviando um SMS agendado com o código em C++ acima (Tutorial em vídeo)

Resumo

A principal função deste artigo foi explicar como agendar um SMS em C/C++ com o usuário da API HTTP SMS do Ozeki SMS Gateway. Se você leu o guia com atenção, agendar SMS com C/C++ deve ser muito fácil. Compartilhar informações no momento perfeito é essencial para o trabalho mais eficiente, pois dessa forma você pode manter o tráfego de SMS baixo e entrar em contato com seus colegas quando eles estiverem prontos para ler as mensagens.

Certifique-se de continuar lendo os guias no site da Ozeki para mais informações. Explore outros tutoriais em C/C++ como Como Receber um SMS em C/C++ e mais.

Agora baixe o Ozeki SMS Gateway e comece a trabalhar!

More information