Como enviar SMS agendado a partir de C#

A maneira mais simples de enviar SMS a partir de C# é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Quando você usa essa API, enviará mensagens SMS emitindo 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.

agendar sms para entrega futura em c
Figura 1 - Agendar SMS para entrega futura em C#

Código C# para enviar SMS agendado para celular

O exemplo de código C# para SMS abaixo demonstra como você pode enviar 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 de seus projetos.

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

namespace SendScheduledSms
{
    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()
            {
                ToAddress = "+36201111111",
                Text = "Olá, Mundo!",
                TimeToSend = DateTime.Parse("2021-06-11 13:25:00")
            };


            var api = new MessageApi(configuration);

            var result = api.Send(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 colocar 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 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.

Baixar SendScheduledSms.cs

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

O que está no arquivo SendScheduledSms.cs?

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

diretório de envio de sms agendado em cs
Figura 2 - O que está dentro de SendScheduledSms.cs.zip

Como enviar SMS agendado a partir de C# (Passos simples)

Para enviar SMS agendado a partir de C#:

  1. Instalar usuário da API HTTP
  2. Configurar o Visual Studio
  3. Baixar o arquivo SendScheduledSms.cs.zip
  4. Extrair o arquivo .zip da pasta de 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#
  8. Iniciar o Ozeki SMS Gateway
  9. Executar Program.cs no Visual Studio para enviar SMS a partir de 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#, 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 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#.

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

Para enviar SMS a partir de C#, seu código C# terá que emitir 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# 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#

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

Cabeçalho da requisição HTTP para enviar SMS a partir de 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#

Para submeter o SMS, sua aplicação em C# enviará uma requisição HTTP semelhante à 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
Connection: Keep-Alive
Content-Length: 336
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9511

{
  "messages": [
    {
      "message_id": "212a019e-a6f5-46f8-80e5-abddb273451b",
      "to_address": "+36201111111",
      "text": "Olá, Mundo!",
      "create_date": "2021-06-11 13:20:09",
      "valid_until": "2021-06-18 13:20:09",
      "time_to_send": "2021-06-11 13:25:00",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

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 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.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 11 Jun 2021 13:06:37 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Mensagens enfileiradas para entrega.",
  "data": {
    "total_count": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "212a019e-a6f5-46f8-80e5-abddb273451b",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Olá, Mundo!",
        "create_date": "2021-06-11 13:20:09",
        "valid_until": "2021-06-18 13:20:09",
        "time_to_send": "2021-06-11 13:25:00",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

Exemplo de SMS em C#: SendSMS.sln

Como baixar o projeto (Tutorial em vídeo)

Neste vídeo, vamos mostrar como abrir o projeto SendSMS.sln e começar a trabalhar com ele. O vídeo começará com a página do tutorial e o link de download e o levará até o código aberto. Você aprenderá como baixar o projeto e como abri-lo. O vídeo leva apenas 1 minuto para assistir, mas contém todas as informações necessárias para que você possa abrir o projeto SendSMS.sln para envio de SMS agendado.

Vídeo 1 - Como baixar e abrir a solução acima (Tutorial em vídeo)

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

Como usar o projeto (Tutorial em vídeo)

Este vídeo apresenta como usar o projeto SendSMS.sln para envio de SMS agendado. Ele começará com o projeto aberto e terminará com o registro das mensagens enviadas. Você aprenderá como adicionar o horário em que deseja enviar a mensagem e como executar o código. Depois, você poderá verificar a aba de Eventos com o registro do envio do SMS. O vídeo leva apenas 80 segundos para assistir e contém todos os passos importantes. Você não terá problemas para seguir o tutorial.

Vídeo 2 - Como enviar um SMS agendado usando a solução acima (Tutorial em vídeo)

Figura 3 - SendScheduledSms.sln

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 artigo acima explicou os passos para agendamento de SMS a partir de C#. Ozeki fornece todas as ferramentas e instruções, portanto, concluir este guia significa que você deve ser capaz de agendar suas mensagens usando C# e o Ozeki SMS Gateway.

O agendamento de SMS é muito útil se você deseja enviar informações aos clientes e também garantir que eles tenham tempo para prestar atenção à mensagem. Dessa forma, você pode garantir que a mensagem não será ignorada ou esquecida, pois os horários mais ocupados serão evitados. É importante destacar que o Ozeki SMS Gateway oferece excelentes recursos de registro, permitindo que erros ocorridos sejam rastreados de forma fácil e rápida.

Continue seus estudos nas páginas de tutoriais da Ozeki, onde você pode obter mais informações sobre tópicos semelhantes, como exclusão em C#.

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

More information