C# excluir SMS do gateway de SMS

A maneira mais simples de enviar SMS a partir do 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 excluir sms do gateway de sms usando c
Figura 1 - Como excluir SMS do gateway de SMS usando C#

Código C# para receber SMS do 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 System;
using Ozeki.Libs.Rest;

namespace DeleteSms.cs
{
    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 msg = new Message()
            {
                ID = "a85d6e16-f888-4306-bd2a-8f8a119d8abf"
            };

            var api = new MessageApi(configuration);

            var result = api.Delete(Folder.Inbox, msg);

            Console.WriteLine(result);
            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 Delete-SMS.cs

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

O que está no arquivo Delete-SMS.cs.zip?

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

diretório delete sms cs
Figura 2 - O que está dentro do Recive-SMS.cs.zip

Como excluir SMS usando C# (Passos rápidos)

Para excluir SMS usando C#:

  1. Configure o Visual Studio Community
  2. Baixe o arquivo DeleteSms.cs.zip
  3. Extraia o arquivo .zip da pasta Downloads
  4. Abra o arquivo DeleteSms.cs.sln no Visual Studio
  5. Inicie o Ozeki SMS Gateway
  6. Selecione http_user na guia Usuários e aplicativos
  7. Verifique os detalhes da mensagem na Caixa de Entrada
  8. Insira o ID da mensagem SMS no código Program.cs
  9. Execute Program.cs para excluir SMS com C#
Instale o Ozeki SMS Gateway e crie um usuário HTTP API

Para poder enviar SMS a partir do 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 da API HTTP de SMS. Crie um usuário com o nome "http_user" e senha "qwe123" para que o exemplo funcione sem modificações.

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

URL da API HTTP para enviar SMS a partir do C#

Para enviar SMS a partir do 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 a partir do 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

Solicitação HTTP para excluir SMS com C#

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

POST /api?action=deletemsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 73
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
 
{
	"folder":  "inbox",
	"message_ids":
	[
		"3a922414-458f-4866-a8ee-f053d1132a6b"
	]
}

Cabeçalho da solicitação HTTP para excluir SMS em 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#

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.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",
		"message_ids": [
			"3a922414-458f-4866-a8ee-f053d1132a6b"
		]
	}
}

Como excluir 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 DeleteSms.sln. Uma vez que a solução é criada, você pode notar que um DeleteSms.csproj é adicionado à solução e, por padrão, o arquivo Program.cs é aberto. Você pode renomear o Program.cs para Program.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#: DeleteSms.sln


Como baixar o arquivo do projeto (Tutorial em vídeo)

Neste vídeo, você aprenderá como baixar e executar o projeto de exemplo DeleteSms.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 o que fazer com o arquivo do projeto. Mostraremos qual software você precisa usar. Este vídeo tem apenas 1 minuto, mas é muito detalhado, então você não terá problemas para 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 do Visual Studio DeleteSms.sln. Uma solução do Visual Studio pode conter vários projetos e vários arquivos. Nesta solução há apenas dois projetos: DeleteSms.csproj, Ozeki.Libs.Rest.csproj e um arquivo: Program.cs.

Figura 3 - DeleteSms.sln

Como usar o projeto (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 caixa de entrada vazia após a exclusão do SMS. Você aprenderá como obter o ID da mensagem e como usar o código para excluir uma mensagem. O vídeo tem apenas 1:38 de duração e contém todas as informações necessárias para excluir uma mensagem usando este projeto.

Vídeo 2 - Como excluir 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, você deve lembrar que o C# usa 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 um pouco de caminho a percorrer nesse campo.

Resumo

O guia explicou as etapas para excluir SMS do Ozeki SMS Gateway usando C#. Se o artigo foi lido com atenção, excluir mensagens do Ozeki SMS Gateway parece muito fácil com um código em C#. Esta solução mostra perfeitamente como é simples controlar e configurar o Ozeki SMS Gateway com comandos em C#. O Ozeki SMS Gateway permite gerenciar custos de SMS e acompanhar o tráfego de mensagens. Com esta função de exclusão, você pode remover mensagens indesejadas rapidamente.

Para continuar a leitura, visite as páginas de tutorial da Ozeki, onde você pode encontrar informações sobre tópicos semelhantes, como agendamento de SMS em C#.

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

More information