Skip to content

L'API Reach Messaging - Prise en Main - Go

L'envoi de SMS avec l'API Reach Messaging de TalkyLabs est possible avec seulement quelques lignes de code Go.

Dans ce qui suit, nous fournissons un guide étape par étape pour faciliter vos débuts. Dans ce guide, vous apprendrez comment :

Information Circle

  • S'inscrire à la plateforme Reach

  • Créer une applet

  • Récupérer vos identifiants API

  • Vérifier votre numéro de téléphone

  • Envoyer un SMS

S'inscrire / S'identifier

Information Circle

Vous pouvez sauter cette section si vous avez déjà un compte sur la plateforme Reach.

Vous pouvez ouvrir un compte sur la plateforme Reach ici. Il vous sera demandé de vérifier votre adresse e-mail pour activer votre compte.

Créer une applet

Information Circle

Vous pouvez sauter cette section si vous avez déjà une applet et que vous voulez l'utiliser ici.

Une applet peut être considérée comme un sous-compte ou un environnement de développement au sein de la plateforme Reach. Il vous permet de regrouper vos opérations dans la plateforme Reach en fonction de vos segments de clientèle, par exemple par pays. Vous pouvez avoir plus d'une applet associée à votre compte.

Pour créer une applet, il suffit de cliquer sur le bouton correspondant dans la console et de spécifier le nom de l'applet ainsi que le pays d'opération, c'est-à-dire le pays où résident la plupart des clients ciblés par les opérations qui seront effectuées dans le cadre de cette applet.

Récupérer vos identifiants API

Après avoir accédé à votre applet, vous pouvez récupérer vos identifiants API en visitant Paramètres -> API dans le menu de gauche.

Comme vous le remarquerez, vous aurez accès à votre Utilisateur API ainsi qu'à vos Clés API Test et Live. Rappelez-vous que la clé API Test est pour le mode sandbox où vous pouvez émuler l'envoi des messages tandis que la clé API Live est pour envoyer des messages pour de vrai.

Enfin, notez qu'il est possible de re-générer vos clés API selon vos besoins.

Vérifier votre numéro de téléphone

Information Circle

Vous pouvez sauter cette section si vous avez déjà un numéro vérifié.

Avec une applet, vous pouvez émuler l'envoi de messages dans le mode sandbox en utilisant n'importe quel numéro de téléphone valide. Cependant, pour l'envoi de messages réels, vous ne pouvez utiliser que des numéros de téléphone qui vous appartiennent.

Pour démontrer la propriété d'un numéro de téléphone, vous devez le vérifier. Dans une applet, visitez la section Numéros de téléphone -> Numéros vérifiés dans le menu de gauche pour ajouter votre numéro et lancer une procédure de vérification.

Warning

Une fois que le numéro est vérifié, il est valable pendant un certain temps. Pour l'instant, cette période est de trois mois, mais elle peut être modifiée sans préavis. Vous devrez revérifier le numéro pour continuer à l'utiliser après cette période.

Installer la bibliothèque cliente

Information Circle

Si vous avez déjà installé la bibliothèque cliente Go, vous pouvez sauter cette étape et envoyer directement votre premier message.

Vous devez vous assurer que Go est installé sur votre ordinateur. Cela peut être vérifié en lançant la commande suivante :

go version

S'il est installé, vous verrez quelque chose comme :

go version go1.20.4 linux/amd64

Notre bibliothèque cliente Go supporte Go 1.15+. Pour l'installer, vous devez d'abord créer un nouveau projet Go. Créez un projet Go en exécutant la commande ci-dessous :

go mod init reach-talkylabs-example

Ensuite, déplacez-vous dans le dossier du projet reach-talkylabs-example et installez la bibliothèque cliente en utilisant :

go get github.com/talkylabs/reach-go

Envoyer un message

Maintenant que la bibliothèque cliente Go est installée, vous pouvez envoyer un SMS en utilisant un numéro vérifié valide enregistré dans l'applet. Créez un fichier nommé sendMessage.go et collez-y l'exemple de code ci-dessous.

package main

import (
    "fmt"
    "os"
    "github.com/talkylabs/reach-go"
    reachMessaging "github.com/talkylabs/reach-go/rest/api/messaging"
)

func main() {
    apiUser := os.Getenv("REACH_TALKYLABS_API_USER")
    apiKey := os.Getenv("REACH_TALKYLABS_API_KEY")

    client := reach.NewRestClientWithParams(reach.ClientParams{
        ApiUser: apiUser,
        ApiKey: apiKey,
    })

    params := &reachMessaging.SendMessageParams{}
    params.SetDest("+237671234567")
    params.SetSrc("+237691234567")
    params.SetBody("Hello World! This is a sms message.")

    resp, err := client.Messaging.SendMessage(params)
    if err != nil {
        fmt.Println("Error: " + err.Error())
    } else {
      fmt.Println(resp.MessageId)
    }
}

Remplacez la valeur dans params.SetSrc par votre numéro vérifié et la valeur dans params.SetDest par le numéro auquel vous voulez envoyer le message. Les numéros de téléphone doivent être au format E.164.

De même, utilisez vos identifiants API et remplacer les valeurs des variables apiUser et apiKey. Rappeler vous d'utiliser votre clé API Live.

Warning

Pour cet exercice, vous pouvez coder en dur vos informations d'identification dans le fichier. Cependant, il est fortement recommandé d'utiliser des variables d'environnement pour stocker des données sensibles.

Sauvegardez le fichier et exécutez la commande suivante dans votre terminal :

go run sendMessage.go

Et voilà ! Dans quelques instants, votre message sera envoyé au numéro de téléphone de destination.