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.

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

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:

Instalar um utilizador de API HTTP
Ativar "Log communication events" no separador Advanced
Configurar o Visual Studio
Descarregar e extrair o ficheiro SendMultipleSms.go.zip
Iniciar a aplicação Ozeki SMS Gateway
Executar o código Go SendMultipleSms.go utilizando o prompt de comando
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.

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:

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.

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.

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.

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.

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!

Como enviar múltiplos SMS a partir de Go

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

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

More information