Wie man SMS mit Go versendet

In diesem Blogbeitrag zeigen wir Ihnen, wie Sie das Vonage Go SDK eine SMS mit Go in weniger als 20 Zeilen Code versenden können.

Voraussetzungen

Um diesem Beitrag folgen zu können, müssen Sie Golang auf Ihrem Entwicklungsrechner installiert haben. Installationsanweisungen finden Sie auf der offiziellen Golang-Website.

Wenn Sie Go noch nicht kennen oder den Installationsprozess nicht durchlaufen wollen, können Sie alternativ direkt im Golang-Spielplatz arbeiten.

Verwendung des Vonage Go SDK

Starten Sie Ihren Editor und erstellen Sie eine neue Datei namens main.go. Erstellen Sie dann die Grundlagen einer Go-Anwendung, indem Sie den folgenden Code eintippen (oder kopieren):

package main

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

func main() {

}

Hinweis: Wenn Sie speichern main.go und die Dateien in der Importanweisung verschwinden, keine Sorge, sie kommen wieder zurück, sobald Sie sie in der main() Funktion verwenden.

Jetzt ist es an der Zeit, etwas Fleisch auf die Knochen zu legen und das Vonage Go SDK zu instanziieren, damit Sie es tatsächlich zum Laufen bringen können.

Innerhalb der main() Funktion ist Folgendes hinzuzufügen:

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

Hier sind zwei Dinge zu beobachten.

Zuerst erstellen Sie ein auth Objekt, das Ihren API-Schlüssel und Ihr Geheimnis mit Hilfe einer Hilfsfunktion kombiniert, die sicherstellt, dass alles korrekt formatiert ist.

Hinweis: Ihren API-Schlüssel und Ihr Geheimnis finden Sie, wenn Sie sich in Ihrem Vonage Dashboard. Wenn Sie noch keinen Account haben, können Sie sich hier anmelden und erhalten ein kostenloses Startguthaben, um diesen Code auszuführen!

Zweitens instanziieren Sie eine neue smsClient das die gesamte Funktionalität des Vonage Go SDK bietet. Ihr auth Objekt wird an dieses übergeben.

Damit können Sie nun Aktionen über die Vonage-API durchführen, wie z. B. das Senden einer SMS.

SMS-Nachrichten mit Go versenden

Wenn der Vonage API-Client einsatzbereit ist, sieht Ihr Code jetzt wie folgt aus:

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{})
}

Um eine SMS mit Go zu versenden, müssen Sie smsClient alle Informationen, die die SMS benötigt, um an ihr Ziel zu gelangen.

Sie sollten mindestens die Nummer, an die die SMS gesendet werden soll, die Nummer, von der sie gesendet wird, und den Text, der angezeigt werden soll, angeben.

Die To Nummer kann Ihre eigene Nummer sein, aber die From Nummer muss jedoch eine SMS-fähige Nummer sein, die Sie über Ihr Vonage Dashboard.

Jetzt müssen wir unserer Anwendung nur noch sagen, dass sie zu senden. die SMS zu senden. Dies geschieht mit der Send Methode, die vom API-Client bereitgestellt wird.

Der Versand der SMS wird in einer einzigen Zeile erledigt:

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

Zum Schluss fügen Sie eine kurze Fehlerprüfung und eine Antwortausgabe hinzu:

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

Die endgültige Datei `main.go sollte so aussehen:

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")
	}
}

Jetzt können Sie die SMS verschicken! Gehen Sie zu Ihrem Terminal und führen Sie in dem Ordner, in dem Sie gerade arbeiten, den Befehl aus:

Wenn alles funktioniert hat, sehen Sie Message Sent auf dem Bildschirm, kurz bevor der vertraute Ton Ihrer SMS-Benachrichtigung ertönt, der Ihren Erfolg signalisiert.

Wie geht es jetzt weiter?

Die nächste Änderung, die Sie am obigen Code vornehmen können, besteht darin, ihn ein wenig sicherer zu machen, indem Sie den fest kodierten API-Schlüssel, das API-Geheimnis und die Telefonnummern entfernen.

Ein guter Weg, dies zu tun, ist, sie in Umgebungsvariablen zu verschieben, die in einer .env Datei gespeichert sind.

Versuchen Sie, dies mit dem Befehl godotenv Paket zu implementieren und Ihre Sicherheit zu erhöhen.

Weitere Lektüre

Wenn das Versenden einer SMS mit Go Sie neugierig gemacht hat, welche weiteren Kommunikationselemente Sie in Ihre Anwendung einbauen können, dann werfen Sie einen Blick auf die Beispiele im Vonage Go SDK GitHub Repository.

Dort finden Sie Code für viele andere Aspekte der Vonage-APIs, z. B. zum Tätigen von Anrufen, Empfangen von SMS-Nachrichten und Verifizieren von Telefonnummern.

Wie immer sind wir sehr daran interessiert, von Ihnen zu hören. Wenn Sie Fragen zur Verwendung von Go mit den Vonage APIs haben, sollten Sie sich unserer Vonage-Gemeinschaft auf Slack und stellen Sie dort Ihre Fragen.

Beiträge zum SDK sind ebenfalls willkommen. Wenn Sie uns also dabei helfen möchten, den Umfang des SDKs zu erweitern, können Sie auf GitHub einen Pull-Request stellen.