Como enviar SMS com o Go

Nesta postagem do blog, vamos mostrar como usar o SDK do Vonage Go para enviar um SMS usando Go em menos de 20 linhas de código.

Pré-requisitos

Para acompanhar este post, você precisará ter o Golang instalado em sua máquina de desenvolvimento. As instruções de instalação podem ser encontradas no site oficial do Golang.

Como alternativa, se você é iniciante em Go ou não quer passar pelo processo de instalação, pode trabalhar diretamente no Golang Playground .

Como usar o SDK do Vonage Go

Abra seu editor e crie um novo arquivo chamado main.go. Em seguida, crie a estrutura básica de um aplicativo em Go digitando (ou copiando) o código a seguir:

package main

import (
	"fmt"
	"github.com/vonage/vonage-go-sdk"
)

func main() {

}

Observação: Se você salvar main.go e os arquivos na instrução de importação desaparecerem, não se preocupe, eles voltarão assim que você os usar dentro da main() função.

Agora é hora de dar vida a tudo isso e instanciar o SDK do Vonage Go para que você possa realmente fazer com que ele execute tarefas.

Dentro da main() função, adicione o seguinte:

auth := vonage.CreateAuthFromKeySecret(API_KEY, API_SECRET)
smsClient := vonage.NewSMSClient(auth)
response, _ := smsClient.Send("44777000000", "44777000777", "Hi from golang", vonage.SMSOpts{})

Há duas coisas acontecendo aqui.

Primeiro, você cria um auth objeto que combine sua chave e seu segredo da API usando uma função auxiliar que garantirá que tudo esteja formatado corretamente.

Observação: você pode encontrar sua chave e seu segredo da API fazendo login no seu Painel da Vonage. Se você ainda não tem um Account, pode se cadastrar aqui e ganhar um crédito inicial gratuito para executar este código!

Em segundo lugar, você instancia um novo smsClient que conterá todas as funcionalidades do SDK do Vonage Go oferece. Seu auth objeto é passado para ele.

Com isso configurado, agora você pode realizar ações na API da Vonage, como enviar um SMS.

Envie mensagens SMS com o Go

Com o cliente da API da Vonage pronto para uso, seu código ficará assim:

package main

import (
	"fmt"
	"github.com/vonage/vonage-go-sdk"
)

func main() {
    auth := vonage.CreateAuthFromKeySecret(API_KEY, API_SECRET)
    smsClient := vonage.NewSMSClient(auth)
    response, _ := smsClient.Send("44777000000", "44777000777", "Hi from golang", vonage.SMSOpts{})
}

Para enviar um SMS com o Go, é preciso passar smsClient todas as informações necessárias para que a mensagem SMS chegue ao seu destino.

No mínimo, você deve incluir o número para o qual a mensagem SMS deve ser enviada, o número de origem e o texto a ser exibido.

O To número pode ser o seu próprio número, mas o From número deve ser um número compatível com SMS adquirido por meio do seu Painel da Vonage.

Agora, a única coisa que resta fazer é instruir nosso aplicativo a enviar o SMS. Isso é feito usando o Send método fornecido pelo cliente da API.

Todo o trabalho pesado de enviar o SMS é feito em uma única linha:

response, _ := smsClient.Send("44777000000", "44777000777", "Hi from golang", vonage.SMSOpts{})

Por fim, adicione uma verificação rápida de erros e a saída da resposta:

if response.Messages[0].Status == "0" {
    fmt.Println("Message sent")
}

Seu arquivo `main.go` final deve ficar assim:

package main

import (
	"fmt"
	"github.com/vonage/vonage-go-sdk"
)

func main() {
	auth := vonage.CreateAuthFromKeySecret(API_KEY, API_SECRET)
	smsClient := vonage.NewSMSClient(auth)
	response, _ := smsClient.Send("44777000000", "44777000777", "Hi from golang", vonage.SMSOpts{})

	if response.Messages[0].Status == "0" {
		fmt.Println("Message sent")
	}
}

Agora está tudo pronto para enviar esse SMS! Vá até o seu terminal e, dentro da pasta em que você está trabalhando, execute:

Se tudo deu certo, você verá Message Sent exibido na tela, logo antes que o som familiar da notificação de SMS soe, sinalizando que tudo deu certo.

E agora, para onde vamos?

A próxima alteração que você pode fazer no código acima é torná-lo um pouco mais seguro, removendo a chave de API, o segredo de API e os números de telefone que estão codificados diretamente no código.

Uma boa maneira de fazer isso é transferi-las para variáveis de ambiente armazenadas em um .env arquivo.

Tente implementar isso usando o pacote godotenv e reforce rapidamente sua segurança.

Leitura complementar

Se enviar um SMS com o Go deixou você curioso para saber quais outros elementos de comunicação você poderia adicionar ao seu aplicativo, dê uma olhada nos exemplos no repositório do SDK do Vonage Go no GitHub.

Lá você encontrará código para utilizar diversos outros recursos das APIs da Vonage, como fazer chamadas telefônicas, receber mensagens SMS e verificar números de telefone.

Como sempre, estamos ansiosos para ouvir o que você tem a dizer. Se você tiver dúvidas sobre como usar o Go com as APIs da Vonage, considere participar da nossa Comunidade da Vonage no Slack e fazer suas perguntas por lá.

Contribuições para o SDK também são bem-vindas; portanto, se você tiver interesse em nos ajudar a ampliar ainda mais o escopo dele, fique à vontade para enviar uma solicitação de pull no GitHub.