SMS bidirectionnels pour l'engagement des clients

Les SMS programmables ne sont pas seulement utiles pour les notifications à sens unique. Lorsque vous combinez des notifications sortantes avec des messages entrants, vous créez des interactions de type "chat" entre votre entreprise et vos clients.

Dans ce tutoriel

Vous voyez à quel point il est rapide d'intégrer une communication bidirectionnelle à votre appli ; vous envoyez une notification de livraison au numéro de téléphone de votre client et gérez sa réponse lorsqu'il souhaite modifier un créneau de livraison.

Le flux de travail pour votre application est le suivant :

Phone numberVonageAppPhone numberVonageAppRequest acceptedRequest acceptedRequest to SMS APIResponse from SMS APISend delivery notification SMSReply to delivery notificationSend reply to webhook endpointRequest to SMS APIResponse from SMS APISend acknowledgement in SMS

Pour ce faire :

  1. Configurer un numéro virtuel Vonage - louer un numéro virtuel et définir les points de terminaison webhook pour les messages entrants
  2. Créer une application Web de base - créer une application Web pour collecter le numéro de téléphone de vos clients.
  3. Envoyer une notification par SMS - envoyer à votre client un avis de livraison par SMS et demander une réponse.
  4. Traitement du SMS de réponse - traiter et accuser réception de la réponse du SMS.

Conditions préalables

Pour suivre ce tutoriel, vous avez besoin des éléments suivants

  • A Account Vonage
  • Un serveur Web accessible au public pour que Vonage puisse faire des demandes de crochets Web à votre application. Si vous développez localement, vous devez devez utiliser un outil tel que ngrok
  • Le code source de ce tutoriel provient de https://github.com/Nexmo/ruby-customer-engagement/.
  • Tous les clients basés aux États-Unis doivent enregistrer une marque et une campagne afin de se conformer à la législation européenne. 10 lignes directrices DLC.

Configurer un numéro virtuel Vonage

Vonage transmet les messages entrants au point de terminaison webhook associé à votre numéro virtuel Vonage.

Vous gérez les numéros virtuels à l'aide de la fonction API pour les développeurs ou le CLI Vonage. Les exemples suivants utilisent la CLI de Vonage pour louer un numéro Vonage :

Associez ensuite le numéro virtuel à votre point de terminaison webhook qui traite les SMS entrants:

Note: assurez-vous que votre serveur fonctionne et qu'il est accessible au public avant d'associer le point de terminaison du webhook à votre numéro virtuel. numéro virtuel. Vonage doit recevoir une réponse 200 OK de votre point de terminaison webhook pour que la configuration soit réussie. Si vous développez localement, utilisez un outil tel que ngrok pour exposer votre serveur web local à l'Internet.

Maintenant que vous avez configuré votre numéro virtuel, vous pouvez envoyer des notifications de livraison par SMS.

Créer une application Web de base

Utilisation Sinatra pour créer une application Web à page unique :

Fichier de gemmes

app.rb

Ajoutez un formulaire HTML pour recueillir le numéro de téléphone auquel vous enverrez un SMS de notification :

views/index.erb

<form action="/notify" method="post">
  <div class="field">
    <label for="number">
      Phone number
    </label>
    <input type="text" name="number">
  </div>

  <div class="actions">
    <input type="submit" value="Notify">
  </div>
</form>

Le formulaire saisit le numéro de téléphone dans le champ E.164 attendu par l'API SMS :

Envoyer une notification par SMS

Dans ce tutoriel, pour envoyer un SMS, vous ajoutez l'élément SDK du serveur Vonage pour Ruby à votre l'application :

Fichier de gemmes

Utilisez votre API Vonage clé et secret pour initialiser le client :

app.rb

Note: ne stockez pas vos identifiants d'API dans votre code, utilisez des variables d'environnement.

Pour recevoir des réponses à vos SMS de notification, vous définissez votre numéro virtuel comme SenderID pour les messages sortants lorsque vous faites une demande à SMS API:

app.rb

Pour vérifier que ce SMS a bien été reçu par le client, vérifiez l'icône récépissé de livraison. Ce tutoriel ne vérifie pas les récépissés de livraison.

Traitement du SMS de réponse

Lorsque votre client répond à votre SMS de notification, Vonage transmet le SMS de notification à votre client. message entrant vers le point de terminaison webhook associé au numéro virtuel.

Dans cette application tutorielle, vous traitez le webhook entrant, vous extrayez le texte et le numéro, et vous envoyez un message de confirmation au client.

app.rb

Le stockage et la validation des données des clients dépassent le cadre de ce tutoriel.

Répondez maintenant au SMS que vous avez reçu précédemment. Vous devriez le voir traité par votre application et recevoir une confirmation de votre choix en quelques secondes. de votre choix dans les secondes qui suivent.

Conclusion

C'est la rapidité avec laquelle il est possible d'envoyer et de recevoir des SMS dans votre application. En quelques lignes de code, vous avez envoyé un SMS au téléphone d'un client avec l'API SMS. avec l'API SMS, géré une réponse et répondu avec une confirmation.

Obtenir le code

Tout le code de ce tutoriel est disponible dans le fichier SMS bidirectionnels pour l'engagement des clients GitHub repo.

Ressources