Como receber 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. Quando você usa esta 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á este SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para sua solicitação.
O exemplo de código F# para SMS abaixo demonstra como você pode receber SMS usando a API de SMS REST HTTP 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 de seus projetos.
Program.fs
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 api = new MessageApi(configuration)
let result = api.DownloadIncoming();
printfn $"Existem {result.Length} mensagens na pasta de entrada:"
for message in result do
printfn $"De: {message.FromAddress} - Texto: {message.Text}"
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 MessageApi para receber o SMS do gateway de SMS.
Baixar ReceiveSms.fs
O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: ReceiveSms.fs.zip (51.2Kb)
O arquivo ReceiveSms.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 ReceiveSms no zip, que contém o código de exemplo para mostrar como receber SMS. Este código de exemplo está listado abaixo.
Para receber SMS de F#:
- Instale o Ozeki SMS Gateway
- Conecte o Ozeki SMS Gateway à rede móvel
- Envie um SMS de teste da GUI do Ozeki
- Crie um usuário de API HTTP para SMS
- Inicie o Visual Studio
- Crie uma solução chamada ReceiveSms.sln
- Adicione um projeto de console F#: ReceiveSms.fsproj
- Coloque o código em Program.fs ou ReceiveSms.fs
- Crie uma solicitação HTTP para receber o SMS
- Leia a resposta HTTP
- Escreva a resposta no console
- Verifique os logs no gateway de SMS
Para poder enviar SMS 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 da GUI do Ozeki para verificar se sua conexão de 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 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 F#.
URL da API HTTP para receber SMS de F#Para enviar SMS 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 de SMS em F# 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
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 receber SMS 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 receber SMS usando 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.
GET /api?action=receivemsg&folder=inbox HTTP/1.1 Connection: Keep-Alive Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw== Host: 127.0.0.1:9509
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. 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: Thu, 10 Jun 2021 11:02:26 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": "94219121-e5b5-4845-9721-074f5307c9a4",
"from_connection": "http_user@localhost",
"from_address": "+36203333333",
"from_station": "%",
"to_connection": "http_user@localhost",
"to_address": "http_user",
"to_station": "%",
"text": "Hello world 3",
"create_date": "2021-06-10 11:46:16",
"valid_until": "2021-06-17 11:46:16",
"time_to_send": "2021-06-10 11:46:16",
"submit_report_requested": true,
"delivery_report_requested": true,
"view_report_requested": true,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
]
},
{
"message_id": "d6f832b2-dbc8-4b1b-8b47-44b3bb6658bf",
"from_connection": "http_user@localhost",
"from_address": "+36202222222",
"from_station": "%",
"to_connection": "http_user@localhost",
"to_address": "http_user",
"to_station": "%",
"text": "Hello world 2",
"create_date": "2021-06-10 11:46:16",
"valid_until": "2021-06-17 11:46:16",
"time_to_send": "2021-06-10 11:46:16",
"submit_report_requested": true,
"delivery_report_requested": true,
"view_report_requested": true,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
]
},
{
"message_id": "0bf86b3a-e4a9-4d8e-970c-ed486b02db7a",
"from_connection": "http_user@localhost",
"from_address": "+362011111111",
"from_station": "%",
"to_connection": "http_user@localhost",
"to_address": "http_user",
"to_station": "%",
"text": "Hello world 1",
"create_date": "2021-06-10 11:46:16",
"valid_until": "2021-06-17 11:46:16",
"time_to_send": "2021-06-10 11:46:16",
"submit_report_requested": true,
"delivery_report_requested": true,
"view_report_requested": true,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
]
}
]
}
}
Exemplo de SMS em F#: ReceiveSms.sln
Como baixar o projeto ReceiveSms.sln (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 com ele para receber mensagens SMS. O vídeo tem apenas 58 segundos, mas é muito útil. Por ser tão detalhado, você não terá problemas para seguir os passos.
O código de exemplo abaixo faz parte da Solução do Visual Studio ReceiveSms.sln. Uma solução do Visual Studio pode conter vários projetos e vários arquivos. Nesta solução há apenas dois projetos: ReceiveSms.fsproj, Ozeki.Libs.Rest.csproj, e um arquivo: Program.fs.
Como usar o projeto ReceiveSms.sln (Tutorial em vídeo)
Neste vídeo, você aprenderá como usar o projeto para receber mensagens SMS com a ajuda de F#. O vídeo começará com a abertura do Ozeki SMS Gateway e levará você até a verificação do prompt de comando com as mensagens recebidas. O vídeo tem apenas 54 segundos e é muito detalhado. Por isso, você não terá problemas para seguir o tutorial.
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 tem um caminho a percorrer nesse aspecto.
Conclusão
O artigo acima explicou os passos para receber SMS em F# usando o Ozeki SMS Gateway. Com esta solução, você pode receber mensagens de texto dos seus clientes no seu programa em F# com a ajuda do Ozeki SMS Gateway. É importante mencionar que o Ozeki SMS Gateway funciona em qualquer país e pode enviar e receber SMS através de várias conexões móveis, então você não precisa se preocupar se a troca de informações se tornar internacional.
Para continuar sua jornada de aprendizado, visite a página de tutoriais da Ozeki, onde você pode encontrar mais informações sobre tópicos como agendamento em F#.
Agora, a única coisa que você precisa fazer é baixar o Ozeki SMS Gateway e começar a trabalhar!
More information
- Como enviar SMS do F#
- Como enviar múltiplos SMS do F#
- Agendar SMS em F# com a API REST HTTP (exemplo de código)
- Receber SMS em F# com a API REST HTTP (exemplo de código)
- Excluir SMS em F# com a API REST HTTP (exemplo de código)
- Github: API de SMS em F#
- Biblioteca NuGet de SMS para F#