Como receber SMS em C#

A maneira mais simples de enviar SMS a partir de C# é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar esta API, você enviará mensagens SMS através de uma solicitação HTTP Post para o gateway de SMS. A solicitação HTTP Post irá conter uma mensagem formatada em formato 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 solicitação.

como receber sms em c usando a api rest
Figura 1 - Receber SMS em C# usando a API Rest

Código C# para receber SMS de um celular

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

Program.cs 
using Ozeki.Libs.Rest;
using System;

namespace ReceiveSms
{
    class Program
    {
        static void Main(string[] args)
        {
            var configuration = new Configuration()
            {
                Username = "http_user",
                Password = "qwe123",
                ApiUrl = "http://127.0.0.1:9509/api"
            };

            var api = new MessageApi(configuration);
            
            var messages = api.DownloadIncoming();

            Console.WriteLine(messages.Length + " mensagens baixadas da caixa de entrada.");

            foreach(Message msg in messages)
            {
                Console.WriteLine(msg);   
            };

            Console.ReadKey();
        }
    }
}

Como usar o exemplo de SMS em C#:

Este exemplo de SMS em C# pode ser usado em qualquer aplicação .NET ou .NET 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 incluir a diretiva using Ozeki.Libs.Rest; na seção de cabeçalho do seu código-fonte 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 ReceiveSms.cs

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

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

O arquivo ReceiveSms.cs.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.

diretório receive sms cs
Figura 2 - O que está dentro de ReceiveSms.cs.zip

Como receber SMS em C# (Passos rápidos)

Para receber SMS em C#:

  1. Configure o Visual Studio Community
  2. Baixe o arquivo ReceiveSms.cs.zip
  3. Extraia o arquivo .zip da pasta de Downloads
  4. Abra o arquivo ReceiveSms.sln no Visual Studio
  5. Inicie o Ozeki SMS Gateway
  6. Clique em HTTP user na aba Users and applications
  7. Execute Program.cs para receber SMS em C#
  8. 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#, 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# 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 configurar o ambiente, você pode executar seu código C#.

URL da API HTTP para receber SMS em C#

Para enviar SMS a partir de C#, seu código 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 C# 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 receber SMS em C#

Para autenticar o cliente de SMS em 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: 

var encoding = Encoding.GetEncoding("iso-8859-1");
var usernamePassword = username + ":" + password;
var usernamePasswordEncoded = Convert.ToBase64String(encoding.GetBytes(usernamePassword));

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 C#

Para receber SMS, sua aplicação em C# 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. 

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Connection: Keep-Alive
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

Cabeçalho da requisição HTTP para receber SMS com 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==

Resposta HTTP recebida pelo exemplo de SMS em 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 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.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 07 Jun 2021 14:10:25 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked
{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	"folder": "inbox",
	"limit": "1000",
		"data": [
			{
				"message_id": "b754195d-9bd8-48dc-a45f-cf688c5b32e3",
				"from_connection": "http_user@localhost",
				"from_address": "+36201111111",
				"from_station": "%",
				"to_connection": "http_user@localhost",
				"to_address": "http_user",
				"to_station": "%",
				"text": "Olá, Mundo 1",
				"create_date": "2021-06-08 09:12:24",
				"valid_until": "2021-06-15 09:12:24",
				"time_to_send": "0001-01-01 00:00:00",
				"submit_report_requested": true,
				"delivery_report_requested": true,
				"view_report_requested": true,
				"tags": [
					{
					"name": "Type",
					"value": "SMS:TEXT"
				}
			]
		},
			{
				"message_id": "a6337c23-51bc-43ee-9181-c9838abbe161",
				"from_connection": "http_user@localhost",
				"from_address": "+36202222222",
				"from_station": "%",
				"to_connection": "http_user@localhost",
				"to_address": "http_user",
				"to_station": "%",
				"text": "Olá, Mundo 2",
				"create_date": "2021-06-08 09:12:24",
				"valid_until": "2021-06-15 09:12:24",
				"time_to_send": "0001-01-01 00:00:00",
				"submit_report_requested": true,
				"delivery_report_requested": true,
				"view_report_requested": true,
				"tags": [
					{
					"name": "Type",
					"value": "SMS:TEXT"
				}
			]
		},
			{
				"message_id": "ca14710b-42b9-4abc-b04f-262cc282dd7c",
				"from_connection": "http_user@localhost",
				"from_address": "+36203333333",
				"from_station": "%",
				"to_connection": "http_user@localhost",
				"to_address": "http_user",
				"to_station": "%",
				"text": "Olá, Mundo 3",
				"create_date": "2021-06-08 09:12:24",
				"valid_until": "2021-06-15 09:12:24",
				"time_to_send": "0001-01-01 00:00:00",
				"submit_report_requested": true,
				"delivery_report_requested": true,
				"view_report_requested": true,
				"tags": [
					{
					"name": "Type",
					"value": "SMS:TEXT"
				}
			]
		}
	]
	}
}

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

Este vídeo mostra como criar um novo projeto de console .Net Core no Visual Studio, como nomeá-lo para ReceiveSms.sln. Uma vez que o solução é criada, você pode notar que um Receive-SMS.csproj é adicionado à solução, e por padrão o arquivo Program.cs é aberto. Você pode renomear o Program.cs para ReceiveSMS.cs se desejar. Você também verá no vídeo como o código de exemplo abaixo pode ser copiado para o arquivo Program.cs, e como ele pode ser compilado e executado.

Exemplo de SMS em C#: ReceiveSms.sln


Como baixar e executar o projeto de exemplo (Tutorial em vídeo)

Neste vídeo, você aprenderá como baixar e executar o projeto de exemplo ReceiveSMS.sln. O vídeo começará com a página de download e terminará com o editor de código aberto. Você aprenderá como baixar e onde encontrar seu projeto de exemplo. Além disso, mostraremos como abrir o projeto baixado. Este vídeo tem apenas 1 minuto de duração, mas é muito detalhado, então você não terá problemas em seguir os passos.

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 Visual Studio ReceiveSms.sln. Uma solução do Visual Studio pode conter vários projetos e vários arquivos. Nesta solução há apenas um projeto: ReceiveSms.csproj, e um arquivo: Program.cs.

Figura 3 - ReceiveSms.sln

Como usar o código (Tutorial em vídeo)

No próximo vídeo, você aprenderá como executar o código de exemplo e como verificar o log do processo. Ele começará com o lançamento do Ozeki SMS Gateway e o levará até a aba de eventos. Você aprenderá como verificar o log, como executar seu código e como verificar as mensagens recebidas. O vídeo tem apenas 1 minuto de duração, mas contém todas as informações necessárias para usar o projeto ReceiveSMS.sln.

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

Executando o exemplo de SMS em C# no Windows

Quando você usa o Windows para executar este exemplo de SMS escrito em C#, você notará que obtém um desempenho ligeiramente melhor do que quando o executa no Linux. Para entender por que isso acontece, é preciso lembrar que o C# utiliza o framework .NET para execução de código. Isso ocorre porque a implementação do .NET no Windows é otimizada para desempenho, enquanto o Mono, a implementação do .NET no Linux, ainda tem alguns avanços a fazer nesse campo.

Conclusão

Este artigo mostrou as etapas necessárias para receber SMS em C#. Com este guia e o Ozeki SMS Gateway, receber SMS em C# não será mais um problema. Estude o guia com atenção e você será capaz de realizar essas etapas facilmente. O Ozeki SMS Gateway é crucial neste procedimento, pois atua como um conector entre os usuários móveis e você. O fato de que o Ozeki SMS Gateway é executado em um ambiente controlado por você deve ser destacado, pois significa que sua lista de contatos e dados estão seguros.

Continue lendo na página de tutoriais da Ozeki, onde você pode encontrar mais guias sobre tópicos como agendamento em C#.

Baixe o Ozeki SMS Gateway agora e comece a trabalhar!

More information