L'API Reach Messaging - Prise en Main - PHP

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

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

S'inscrire / S'identifier

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

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

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.

Installer la bibliothèque cliente

Vous devez vous assurer que PHP est installé sur votre ordinateur. Ceci peut être vérifié en exécutant la commande suivante:

php --version

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

PHP 8.2.10 (cli) (built: Sep  2 2023 06:58:59) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.10, Copyright (c) Zend Technologies
    with Zend OPcache v8.2.10, Copyright (c), by Zend Technologies
    with Xdebug v3.2.1, Copyright (c) 2002-2023, by Derick Rethans

Pour installer notre bibliothèque client PHP, il est fortement recommandé d'utiliser composer en particulier pour le développement web. Cela se fait en exécutant la commande suivante dans le terminal :

composer require talkylabs/reach-sdk

Si vous préférez une installation manuelle, téléchargez simplement le code source, et décompressez-le dans le même répertoire que votre code PHP. Ensuite, dans votre code, vous pouvez reférencer le fichier autoload fourni avec le SDK PHP.

Envoyer un message

Maintenant que la bibliothèque cliente Python 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é send_message.php et collez-y l'exemple de code ci-dessous.

<?php

require __DIR__ . '/vendor/autoload.php';
use Reach\Rest\Client;


$apiUser = getenv('REACH_TALKYLABS_API_USER');
$apiKey = getenv('REACH_TALKYLABS_API_KEY');
$client = new Client($apiUser, $apiKey);

$message = $client->messaging->messagingItems->send(
    "+237671234567", // dest
    "+237691234567", // src
    "Hello World! This is a sms message."
);

print($message->messageId);

Remplacez le numéro de téléphone src par votre numéro vérifié et le numéro de téléphone dest 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.

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

php send_message.php

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