Como agendar um SMS em F#

A maneira mais simples de enviar SMS a partir de F# é 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 enviar sms no futuro f sharp
Figura 1 - Agendar SMS para envio futuro em F#

Código F# para enviar SMS agendado para celular

O exemplo de código F# 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 F#. Esta biblioteca é fornecida gratuitamente e você pode usá-la e modificá-la em qualquer um dos seus projetos.

Program.fs 
open System
open Ozeki.Libs.Rest

[<EntryPoint>]
let main argv =
    let configuration = new Configuration (
        Username = "http_user",
        Password = "qwe123",
        ApiUrl = "http://127.0.0.1:9509/api")

    let msg = new Message(
        ToAddress = "+36201111111", 
        Text = "Olá, Mundo!",
        TimeToSend = DateTime.Parse("2021-06-07 11:44:00"))

    let api = new MessageApi(configuration)

    let result = api.Send(msg)

    printfn $"{result.ToString()}"
    0

Como usar o exemplo de SMS em F#:

Este exemplo de SMS em F# pode ser usado em qualquer aplicação .NET ou .NET core. Para usar 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 F#. 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.fs

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

O que está no arquivo SendScheduledSms.fs?

O arquivo SendScheduledSms.fs 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. Este código de exemplo está listado abaixo.

Figura 2 - O que está dentro de SendScheduledSms.fs.zip

Como enviar SMS a partir de F# (Passos rápidos)

Para enviar SMS a partir de F#:

  1. Instale o Ozeki SMS Gateway
  2. Conecte o Ozeki SMS Gateway à rede móvel
  3. Envie um SMS de teste a partir da interface gráfica do Ozeki
  4. Crie um usuário de API HTTP para SMS
  5. Inicie o Visual Studio
  6. Crie uma solução chamada SendScheduledSms.sln
  7. Adicione um projeto de console F#: SendScheduledSms.fsproj
  8. Coloque o código em Program.fs ou SendScheduledSms.fs
  9. Leia a resposta HTTP
  10. Verifique os logs no gateway de SMS
Instale o Ozeki SMS Gateway e crie um usuário de API HTTP

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

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

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

Para autenticar o cliente de SMS em F#, 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 solicitação HTTP para enviar SMS a partir de F#

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

Solicitação HTTP para enviar SMS agendado a partir de F#

Para enviar o SMS, sua aplicação em F# 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=sendmsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 336
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

{
  "messages": [
    {
      "message_id": "d51ca3ba-4159-4dee-8541-106f8df76f91",
      "to_address": "+36201111111",
      "text": "Olá, Mundo!",
      "create_date": "2021-06-11 14:09:22",
      "valid_until": "2021-06-18 14:09:22",
      "time_to_send": "2021-06-11 14:44:00",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

Resposta HTTP recebida pelo exemplo de SMS em F#

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 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.118 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 11 Jun 2021 08:44:45 GMT
Server: 10/10.3.118
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": "04682902-5360-4189-8082-ab455433d141",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Olá, Mundo!",
        "create_date": "2021-06-11 14:09:22",
        "valid_until": "2021-06-18 14:09:22",
        "time_to_send": "2021-06-11 14:44: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 F#: SendScheduledSms.sln



Como baixar o arquivo do projeto da página de download (Tutorial em vídeo)

Neste vídeo, você aprenderá como baixar o projeto de exemplo em F#. O vídeo começa na página de download e termina com o projeto aberto. Você aprenderá como baixar o projeto e o que fazer depois. O vídeo tem apenas 1 minuto de duração, mas é muito útil. Graças ao nível de detalhe, você não terá problemas para seguir os passos.

Vídeo 1 - Como baixar e executar o projeto de exemplo 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.fsproj, e um arquivo: Program.fs.

Figura 3 - SendScheduledSms.sln

Como usar o projeto de SMS agendado (Tutorial em vídeo)

Neste vídeo, você aprenderá como usar o projeto para enviar mensagens SMS agendadas. O vídeo começará com a abertura do Ozeki SMS Gateway e o levará até a verificação da pasta de mensagens adiadas. O vídeo tem apenas 1:26 de duração e é muito detalhado. Por isso, você não terá problemas para seguir o tutorial.

Vídeo 2 - Como usar a solução Send-scheduled-SMS.fs (Tutorial em vídeo)

Executando o exemplo de SMS em F# no Windows

Quando você usa o Windows para executar este exemplo de SMS escrito em F#, 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 F# 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 precisa avançar nesse aspecto.

Conclusão

O artigo explicou as etapas do agendamento de SMS em F# com a ajuda do Ozeki SMS Gateway. O agendamento de SMS é uma ferramenta muito útil se você quiser garantir que suas mensagens evitem os horários de pico dos destinatários, para que as mensagens não sejam ignoradas ou esquecidas. O Ozeki SMS Gateway permite registrar mensagens SMS em um banco de dados e oferece vários recursos de relatório para fornecer informações sobre a conexão SMS.

Não pare seus estudos aqui, visite a página de tutoriais da Ozeki, onde você pode ler mais sobre tópicos como exclusão em F#.

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

More information