Como Receber 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. Quando você usa essa API, enviará mensagens SMS fazendo 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á esse SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para sua solicitação.

Código C/C++ para receber sms de um celular

O exemplo de código C/C++ para SMS abaixo demonstra como você pode receber 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.

ReceiveSms.cpp

#include <iostream>
#include <string>
#include "Ozeki.Libs.Rest.h"

using namespace std;

int main()
{
    //Função para criar um 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";

    MessageApi api(configuration);

    auto result = api.DownloadIncoming();

    cout << result << endl;
    for (Message message : result.Messages) {
        cout << message << endl;
    }

    return 0;
}

Como usar o exemplo de SMS em C++:

Este exemplo de SMS em C++ pode ser usado em qualquer aplicação C ou C++. 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 MessageApi para receber o SMS do gateway de SMS. O gateway de SMS encaminhará a mensagem para você através de uma conexão wireless ou pela Internet.

Baixar Receive-SMS.cs

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

O que está no arquivo ReceiveSms.cpp.zip?

O arquivo ReceiveSms.cpp.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 projeto ReceiveSms 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 está dentro de ReceiveSms.cpp.zip

Como receber SMS em C/C++ (Diretrizes fáceis)

Para receber SMS em C/C++:

Configure o Visual Studio Community
Baixe o arquivo ReceiveSms.cpp.zip
Extraia o arquivo .zip da pasta Downloads
Abra o arquivo ReceiveSms.sln no Visual Studio
Inicie o Ozeki SMS Gateway
Clique em HTTP user na aba Usuários e aplicações
Execute ReceiveSms.cpp para receber SMS em C/C++
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 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 de API HTTP para SMS. Crie um usuário com o nome "http_user" e a senha "qwe123" para que o exemplo funcione sem modificações.

Após configurar o ambiente, você pode executar seu código C/C++.

URL da API HTTP para receber SMS em C/C++

Para receber SMS usando 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 receber SMS em C/C++

Para autenticar o cliente de 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 solicitação HTTP. O formato usado é: 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

Solicitação HTTP para receber SMS com C/C++

Para receber SMS, sua aplicação em C/C++ enviará uma solicitação HTTP semelhante à mostrada abaixo. Observe que esta solicitaçã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
Content-Type: application/json
Accept: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

Cabeçalho da solicitação HTTP para receber SMS em C/C++

Para enviar as mensagens SMS, você precisa incluir as seguintes linhas como cabeçalhos na solicitaçã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==

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

Assim que o gateway SMS receber esta solicitação, ele gerará uma resposta HTTP. A resposta HTTP conterá um código de status para indicar se a solicitaçã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:59:51 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": "5d78e707-13d3-49d3-9b7d-66ba0c24b21e",
	      "from_connection": "admin@localhost",
	      "from_address": "",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 3",
	      "create_date": "2021-06-29 11:07:33",
	      "valid_until": "2021-07-06 11:07:33",
	      "time_to_send": "2021-06-29 11:07:33",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": []
	    },
	    {
	      "message_id": "695acc97-43b6-4cf1-a6ae-c19e3f908c8f",
	      "from_connection": "admin@localhost",
	      "from_address": "",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 2",
	      "create_date": "2021-06-29 11:07:23",
	      "valid_until": "2021-07-06 11:07:23",
	      "time_to_send": "2021-06-29 11:07:23",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": []
	    },
	    {
	      "message_id": "333f852e-2f8f-464d-9663-831e857819ca",
	      "from_connection": "admin@localhost",
	      "from_address": "",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 1",
	      "create_date": "2021-06-29 11:07:10",
	      "valid_until": "2021-07-06 11:07:10",
	      "time_to_send": "2021-06-29 11:07:10",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": []
	    }
	  ]
	}
}

Baixando e abrindo o projeto em C/C++ (Tutorial em vídeo)

No vídeo a seguir, vamos mostrar como baixar e abrir o arquivo do projeto. O vídeo começa com a localização do link de download e termina com o projeto pronto para uso. Este vídeo de 1:32 minuto é fácil de entender e muito detalhado. Você não terá problemas para entender este tutorial. Estamos usando o ambiente de programação Visual Studio para abrir o projeto.

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

O código de exemplo abaixo faz parte da Solução do Visual Studio Receive-SMS.sln. Uma solução do Visual Studio pode conter vários projetos e vários arquivos. Nesta solução há apenas um projeto: Receive-SMS.csproj, e um arquivo: Program.cs.

Usando o projeto (tutorial em vídeo)

O vídeo a seguir explica como usar o projeto. Ele começa com a abertura do Ozeki SMS Gateway e leva você até a lista de mensagens no prompt de comando. No processo, você verá como o código move as mensagens da pasta de entrada para o projeto em C/C++. O vídeo é ótimo porque apresenta todos os passos de forma detalhada e é fácil de entender. Você precisará de apenas 34 segundos para assistir ao vídeo e usará o painel do Ozeki SMS Gateway, que é muito intuitivo. Você não terá problemas para seguir o tutorial.

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

Para resumir

Este guia mostrou como receber SMS em C/C++ com o usuário da API SMS HTTP do Ozeki SMS Gateway. Com esta solução, você pode garantir que as mensagens recebidas serão redirecionadas pela API SMS e recebidas pelo seu programa em Scala. Sua lista de contatos e dados estão em boas mãos, pois o Ozeki SMS Gateway opera em um ambiente fechado que você controla.

Continue lendo sobre tópicos como este no site da Ozeki. Confira Como Excluir um SMS em C/C++ e use os códigos fornecidos sem limitações.

Comece a trabalhar baixando o Ozeki SMS Gateway agora!