Como enviar múltiplos SMS a partir de Go

A maneira mais simples de enviar múltiplos SMS a partir de Go é utilizar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Quando você utiliza esta API, irá enviar mensagens SMS através de um pedido HTTP Post para o gateway de SMS. O pedido 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 irá retornar uma resposta HTTP 200 OK ao seu pedido.

como enviar múltiplos sms a partir de go
Figura 1 - Como enviar múltiplos SMS a partir de Go

Código Go para enviar múltiplas mensagens SMS para telemóvel

O exemplo de código Go para SMS abaixo demonstra como pode enviar múltiplos SMS utilizando a API HTTP Rest de SMS do Ozeki SMS Gateway através do pacote Go github.com/ozekisms/go_send_sms_http_rest_ozeki. Este pacote é fornecido gratuitamente, e pode utilizá-lo e modificá-lo em qualquer um dos seus projetos.

SendMultipleSms.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
package main
 
import (
    "fmt"
 
    ozeki "github.com/ozekisms/go_send_sms_http_rest_ozeki"
)
 
func main() {
    configuration := ozeki.NewConfiguration(
        "http_user",
        "qwe123",
        "http://127.0.0.1:9509/api",
    )
 
    msg1 := ozeki.NewMessage()
    msg1.ToAddress = "+36201111111"
    msg1.Text = "Olá mundo 1"
 
    msg2 := ozeki.NewMessage()
    msg2.ToAddress = "+36202222222"
    msg2.Text = "Olá mundo 2"
 
    msg3 := ozeki.NewMessage()
    msg3.ToAddress = "+36203333333"
    msg3.Text = "Olá mundo 3"
 
    api := ozeki.NewMessageApi(configuration)
 
    result := api.Send([]ozeki.Message{msg1, msg2, msg3})
 
    fmt.Println(result)
}
     

Código 1 - SendMultipleSms.go

Como utilizar o exemplo de SMS em Go:

Este exemplo de SMS em Go pode ser utilizado em qualquer aplicação Go. Para utilizá-lo, deve descarregar o pacote github.com/ozekisms/go_send_sms_http_rest_ozeki. Após o pacote ser descarregado, precisa de adicionar uma referência ao mesmo no seu código fonte Go. Isto irá permitir-lhe utilizar as classes fornecidas pelo pacote github.com/ozekisms/go_send_sms_http_rest_ozeki. Pode utilizar a classe Message para criar o SMS. Pode utilizar a classe MessageApi para enviar o SMS para o gateway de SMS. O gateway de SMS irá encaminhar a sua mensagem para a rede móvel através de uma ligação sem fios ou através da Internet.

Descarregar SendMultipleSms.go

O código fonte explicado neste artigo pode ser descarregado, utilizado e modificado gratuitamente.
Descarregar: SendMultipleSms.go.zip (1.08Kb)

O que está no ficheiro SendMultipleSms.go.zip?

No SendMultipleSms.go.zip irá encontrar o ficheiro SendSms.go, 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 SendMultipleSms.go.zip

Como enviar SMS a partir de Go (Passos simples)

Para enviar SMS a partir de Go:

  1. Instalar um utilizador de API HTTP
  2. Ativar "Log communication events" no separador Advanced
  3. Configurar o Visual Studio
  4. Descarregar e extrair o ficheiro SendMultipleSms.go.zip
  5. Iniciar a aplicação Ozeki SMS Gateway
  6. Executar o código Go SendMultipleSms.go utilizando o prompt de comando
  7. Verificar os logs para confirmar se o SMS foi enviado
Instalar Ozeki SMS Gateway e criar um utilizador de API HTTP

Para poder enviar múltiplas mensagens SMS a partir de Go, primeiro precisa de instalar o Ozeki SMS Gateway. O gateway de SMS pode ser instalado no mesmo computador onde desenvolve o seu código Go em qualquer editor de texto, como o bloco de notas do Windows. Após a instalação, o próximo passo é ligar o Ozeki SMS Gateway à rede móvel. Pode enviar um SMS de teste a partir da interface gráfica do Ozeki para verificar se a sua ligação à rede móvel está a funcionar. O passo final para preparar o seu ambiente é criar um utilizador de API HTTP para SMS. Crie um utilizador com o nome de utilizador "http_user" e com a palavra-passe "qwe123" para fazer o exemplo funcionar sem modificações.

Após o ambiente estar configurado, pode executar o seu código Go.

URL da API HTTP para enviar múltiplos SMS a partir de Go

Para enviar SMS a partir de Go, o seu Go terá de fazer um pedido HTTP para o gateway de SMS. O URL da API é mostrado abaixo. Note 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 a aplicação Go de SMS está a ser executada, pode ser 127.0.0.1. Se estiver instalado num computador diferente, deve ser o endereço IP desse computador.

1
2
http://127.0.0.1:9509/api?action=rest
     
Autenticação HTTP para enviar SMS a partir de Go

Para autenticar o cliente de SMS em Go, precisa de enviar o nome de utilizador e palavra-passe numa string codificada em base64 para o servidor num pedido HTTP. O formato utilizado é: base64(nome de utilizador+":"+palavra-passe). Em Go pode utilizar o seguinte código para fazer esta codificação:

1
2
3
4
5
6
7
8
import b64 "encoding/base64"
 
func (api *MessageApi) createAuthorizationHeader(username string, password string) string {
    var usernamePassword string = username + ":" + password
    var usernamePasswordEncoded string = b64.StdEncoding.EncodeToString([]byte(usernamePassword))
    return "Basic " + usernamePasswordEncoded
}
     

Por exemplo, se codificar o nome de utilizador 'http_user' e a palavra-passe 'qwe123', irá obter a seguinte string codificada em base64: aHR0cF91c2VyOnF3ZTEyMw==. Para enviar

Cabeçalho da requisição HTTP para enviar SMS a partir de Go

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.

1
2
3
Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
     
Requisição HTTP para enviar SMS a partir de Go

Para submeter o SMS, sua aplicação em Go 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 os números dos destinatários e os textos das mensagens.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
POST /api?action=sendmsg HTTP/1.1
Content-Length: 1277
Content-Type: application/json
Accept-Encoding: gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Go-http-client/1.1
 
{
    "messages": [
        {
            "message_id": "6e5384bb-e07b-11eb-a3b4-74d4355e997d",
            "from_connection": "",
            "from_address": "",
            "from_station": "",
            "to_connection": "",
            "to_address": "+36201111111",
            "to_station": "",
            "text": "Hello world 1",
            "create_date": "2021-07-09T08:03:50",
            "valid_until": "2021-07-16T08:03:50",
            "time_to_send": "2021-07-09T08:03:50",
            "submit_report_requested": true,
            "view_report_requested": true,
            "delivery_report_requested": true,
            "tags": [],
            "status": ""
        },
        {
            "message_id": "6e622a28-e07b-11eb-a3b4-74d4355e997d",
            "from_connection": "",
            "from_address": "",
            "from_station": "",
            "to_connection": "",
            "to_address": "+36202222222",
            "to_station": "",
            "text": "Hello world 2",
            "create_date": "2021-07-09T08:03:50",
            "valid_until": "2021-07-16T08:03:50",
            "time_to_send": "2021-07-09T08:03:50",
            "submit_report_requested": true,
            "view_report_requested": true,
            "delivery_report_requested": true,
            "tags": [],
            "status": ""
        },
        {
            "message_id": "6e622a28-e07b-11eb-a3b5-74d4355e997d",
            "from_connection": "",
            "from_address": "",
            "from_station": "",
            "to_connection": "",
            "to_address": "+36203333333",
            "to_station": "",
            "text": "Hello world 3",
            "create_date": "2021-07-09T08:03:50",
            "valid_until": "2021-07-16T08:03:50",
            "time_to_send": "2021-07-09T08:03:50",
            "submit_report_requested": true,
            "view_report_requested": true,
            "delivery_report_requested": true,
            "tags": [],
            "status": ""
        }
    ]
}
     
Resposta HTTP recebida pelo exemplo de SMS em Go

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 submissão do SMS foi bem-sucedida ou não. Ela também retornará uma estrutura codificada em JSON para fornecer detalhes úteis sobre a submissão da mensagem.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 09 Jul 2021 07:59:56 GMT
Server: 10/10.3.123
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": "6e5384bb-e07b-11eb-a3b4-74d4355e997d",
          "from_station": "%",
          "to_address": "+36201111111",
          "to_station": "%",
          "text": "Hello world 1",
          "create_date": "2021-07-09 08:03:50",
          "valid_until": "2021-07-16 08:03:50",
          "time_to_send": "2021-07-09 08:03:50",
          "submit_report_requested": true,
          "delivery_report_requested": true,
          "view_report_requested": false,
          "tags": [
            {
              "name": "Type",
              "value": "SMS:TEXT"
            }
          ],
          "status": "SUCCESS"
        },
        {
          "message_id": "6e622a28-e07b-11eb-a3b4-74d4355e997d",
          "from_station": "%",
          "to_address": "+36202222222",
          "to_station": "%",
          "text": "Hello world 2",
          "create_date": "2021-07-09 08:03:50",
          "valid_until": "2021-07-16 08:03:50",
          "time_to_send": "2021-07-09 08:03:50",
          "submit_report_requested": true,
          "delivery_report_requested": true,
          "view_report_requested": false,
          "tags": [
            {
              "name": "Type",
              "value": "SMS:TEXT"
            }
          ],
          "status": "SUCCESS"
        },
        {
          "message_id": "6e622a28-e07b-11eb-a3b5-74d4355e997d",
          "from_station": "%",
          "to_address": "+36203333333",
          "to_station": "%",
          "text": "Hello world 3",
          "create_date": "2021-07-09 08:03:50",
          "valid_until": "2021-07-16 08:03:50",
          "time_to_send": "2021-07-09 08:03:50",
          "submit_report_requested": true,
          "delivery_report_requested": true,
          "view_report_requested": false,
          "tags": [
            {
              "name": "Type",
              "value": "SMS:TEXT"
            }
          ],
          "status": "SUCCESS"
        }
      ]
    }
}
     
Como enviar múltiplas mensagens SMS a partir de Go usando a API de SMS em Go (Tutorial em vídeo)

Este vídeo mostra como baixar o arquivo SendMultipleSms.go.zip desta página. Se assistir ao vídeo, você notará que o conteúdo do SendMultipleSms.go.zip é colocado na área de trabalho do Windows. Você também verá que executamos o prompt de comando para enviar o SMS.

Exemplo de SMS em Go: SendMultipleSms.go

O código de exemplo abaixo faz parte do SendMultipleSms.go.

Figura 3 - Arquivo SendMultipleSms.go

Como verificar se o SMS foi aceito pelo usuário HTTP

Depois de enviar o SMS, é uma boa ideia verificar o seu gateway de SMS, para ver o que foi recebido. Você pode verificar o log abrindo os detalhes do usuário HTTP no console de gerenciamento do Ozeki SMS Gateway. O vídeo a seguir mostra o que você deve procurar.

Vídeo 2 - Como verificar se o SMS foi aceito pelo usuário HTTP (Tutorial em vídeo)

Resumo

Este guia teve como objetivo explicar o envio de múltiplos SMS em Go com a ajuda do Ozeki SMS Gateway. Com esta solução, alcançar vários clientes de uma vez é rápido e simples. Ao usar esta tecnologia, muito tempo e energia podem ser economizados, pois o envio de múltiplos SMS facilita muito o trabalho. O Ozeki SMS Gateway funciona com alto desempenho, significando que pode enviar até 1000 SMS por segundo.

Certifique-se de continuar lendo na página de tutoriais da Ozeki, onde mais informações podem ser encontradas sobre tópicos como exclusão de SMS em Go.

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

More information