Como enviar múltiplos SMS a partir de 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 requisição HTTP Post para o gateway de SMS. A requisição HTTP Post irá conter uma mensagem formatada em 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 requisição.
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 msg1 = new Message(
ToAddress = "+36201111111",
Text = "Olá, Mundo 1")
let msg2 = new Message(
ToAddress = "+36202222222",
Text = "Olá, Mundo 2")
let msg3 = new Message(
ToAddress = "+36203333333",
Text = "Olá, Mundo 3")
let messages = [msg1; msg2; msg3]
let api = new MessageApi(configuration)
let result = api.Send(messages)
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 usá-lo, você deve adicionar a DLL Ozeki.Libs.Rest como referência ao seu projeto. Após adicionar a referência, você deve incluir a diretiva "open Ozeki.Libs.Rest;" na seção de cabeçalho do seu código fonte em 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 SendMultipleSms.fs
O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: SendMultipleSms.fs.zip (59.6Kb)
O arquivo SendMultipleSms.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 SendMultipleSms no zip, que contém o código de exemplo para mostrar como enviar múltiplas mensagens SMS de uma vez. Este código de exemplo está listado abaixo.
Para enviar SMS a partir de F#:
- Instale o Ozeki SMS Gateway
- Conecte o Ozeki SMS Gateway à rede móvel
- Envie um SMS de teste a partir da interface gráfica do Ozeki
- Crie um usuário de API HTTP para SMS
- Inicie o Visual Studio
- Crie uma solução chamada SendMultipleSms.sln
- Adicione um projeto de console F#: SendMultipleSms.fsproj
- Insira o código em Program.cs ou SendMultipleSms.fs
- Leia a resposta HTTP
- Verifique os logs no gateway de SMS
Para escrever seu primeiro programa em F#:
- Configure o Visual Studio
- Baixe o arquivo SendMultipleSms.fs.zip
- Extraia o arquivo .zip da pasta de Downloads
- Abra o arquivo SendMultipleSms.sln no Visual Studio
- Inicie o aplicativo Ozeki SMS Gateway
- Clique em usuário HTTP na aba Usuários e aplicativos
- Execute Program.fs no Visual Studio
- Verifique a caixa Enviados no Ozeki SMS Gateway
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 em 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 que o exemplo funcione sem modificações.
Após configurar o ambiente, você pode executar seu código em 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 requisiçã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
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 requisição HTTP. O formato utilizado é: 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 F#
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 a partir de F#
Para submeter o SMS, sua aplicação em F# 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.
HTTP request received from 127.0.0.1:56003
POST /api?action=sendmsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 983
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
{
"messages": [
{
"message_id": "dcea98a0-7338-406a-96c8-86ddf9ccc1b6",
"to_address": "+36201111111",
"text": "Hello, World 1",
"create_date": "2021-06-11 14:04:52",
"valid_until": "2021-06-18 14:04:52",
"time_to_send": "2021-06-11 14:04:52",
"submit_report_requested": true,
"delivery_report_requested": true,
"view_report_requested": true,
"tags": []
},
{
"message_id": "7af033fe-fc31-464a-b59a-992ec268f156",
"to_address": "+36202222222",
"text": "Hello, World 2",
"create_date": "2021-06-11 14:04:52",
"valid_until": "2021-06-18 14:04:52",
"time_to_send": "2021-06-11 14:04:52",
"submit_report_requested": true,
"delivery_report_requested": true,
"view_report_requested": true,
"tags": []
},
{
"message_id": "29be6c7d-2474-4ab2-ad3c-d8d58e1cdd76",
"to_address": "+36203333333",
"text": "Hello, World 3",
"create_date": "2021-06-11 14:04:52",
"valid_until": "2021-06-18 14:04:52",
"time_to_send": "2021-06-11 14:04:52",
"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 de 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.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": "Messages queued for delivery.",
"data": {
"total_count": 3,
"success_count": 3,
"failed_count": 0,
"messages": [
{
"message_id": "00da7d71-93f1-44c3-9975-4f9ce2ef6b28",
"from_station": "%",
"to_address": "+36201111111",
"to_station": "%",
"text": "Hello, World 1",
"create_date": "2021-06-11 14:04:52",
"valid_until": "2021-06-18 14:04:52",
"time_to_send": "2021-06-11 14:04:52",
"submit_report_requested": true,
"delivery_report_requested": true,
"view_report_requested": false,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
],
"status": "SUCCESS"
},
{
"message_id": "dde86f6d-7db6-4f77-aea2-2bafc8d09cf8",
"from_station": "%",
"to_address": "+36202222222",
"to_station": "%",
"text": "Hello, World 2",
"create_date": "2021-06-11 14:04:52",
"valid_until": "2021-06-18 14:04:52",
"time_to_send": "2021-06-11 14:04:52",
"submit_report_requested": true,
"delivery_report_requested": true,
"view_report_requested": false,
"tags": [
{
"name": "Type",
"value": "SMS:TEXT"
}
],
"status": "SUCCESS"
},
{
"message_id": "c2a3275c-7015-4462-bde3-db0c9d45701b",
"from_station": "%",
"to_address": "+36203333333",
"to_station": "%",
"text": "Hello, World 3",
"create_date": "2021-06-11 14:04:52",
"valid_until": "2021-06-18 14:04:52",
"time_to_send": "2021-06-11 14:04:52",
"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#: SendMultipleSms.sln
Como baixar e abrir o projeto (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 e é muito detalhado. Você não terá problemas para seguir os passos. O link para download está na página do tutorial.
O código de exemplo abaixo faz parte da Solução do Visual Studio SendMultipleSms.sln. Uma solução do Visual Studio pode conter vários projetos e vários arquivos. Nesta solução, há apenas um projeto: SendMultipleSms.fsproj, e um arquivo: Program.fs.
Como usar o projeto (Tutorial em vídeo)
Neste vídeo, você aprenderá como usar o projeto para enviar vários SMS de uma vez com a ajuda do F#. O vídeo começará com a abertura do Ozeki SMS Gateway e o levará até a pasta de enviados com várias mensagens. Você aprenderá como executar o código e como verificar a pasta de enviados. Vale a pena assistir ao vídeo porque é fácil de seguir e detalhado, mas tem apenas 1 minuto de duração.
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 o desempenho é um pouco melhor do que quando executado 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.
Resumo
Como visto no artigo acima, enviar vários SMS em F# usando o Ozeki SMS Gateway é muito simples. Esta solução permite que você alcance vários clientes com um único código, economizando custos e tempo. É importante notar que o Ozeki SMS Gateway é executado em um ambiente que você controla, então seus dados e lista de contatos estão em boas mãos. Se os passos forem seguidos cuidadosamente, a comunicação com os clientes pode ser feita sem complicações.
Continue sua jornada de aprendizado na página de tutoriais da Ozeki, onde há mais sobre tópicos como agendamento de SMS e recebimento em F#.
Agora, o próximo passo é baixar o Ozeki SMS Gateway e começar a trabalhar!
More information