Initiation à SMS Gateway

Suivez les étapes décrites ci-dessous pour créer et déployer un agent SMS cognitif de base sur site ou dans le cloud.

1. Sélectionnez un fournisseur SMS et créez un numéro de téléphone

Votre agent SMS nécessite un numéro de téléphone prenant en charge les fonctions SMS pour pouvoir envoyer et recevoir des messages. SMS Gateway prend en charge Telestax RestcommONE et Twilio® Programmable SMS.

Pour RestcommONE :

1. Créez un compte RestcommONE sur le site Web de Telestax.
2. Dans votre console RestcommONE, accédez à Numbers > Register Number > Provider Number.
3. Dans la zone Country, entrez United States. Sélectionnez l'état et l'indicatif régional puis cliquez sur l'icône de recherche en forme de loupe.
4. Passez en revue la liste des numéros. Acceptez un numéro de téléphone en cliquant sur Register.

Pour Twilio :

1. Créez un compte sur le site Web Twilio.
2. Depuis la console Twilio, allez dans All products and services > Phone Numbers. Sur la page Getting Started, cliquez sur Get your first Twilio phone number.
3. Passez en revue le numéro de téléphone suggéré, qui inclut les fonctions SMS. Acceptez le numéro de téléphone en cliquant sur Choose this number.

2. Créez un espace de travail Watson Assistant

SMS Gateway se connecte au service IBM Watson™ Assistant qui fournit l'intelligence derrière votre agent SMS. Watson Assistant analyse le texte du message, le mappe à des intentions ou à des capacités et fournit une réponse conformément à un dialogue que vous créez.

1. Ouvrez un compte IBM Cloud et créez le service Watson Assistant.

2. Ajoutez un espace de travail avec un dialogue.

   Pour commencer rapidement, importez l'exemple de fichier JSON de conversation depuis le dossier sms/conversation du référentiel GitHub sample.voice.gateway. Pour plus de détails sur l'importation des fichiers JSON, voir Creating workspaces dans la documentation de Watson Assistant.

   Si vous créez votre propre dialogue au lieu d'utiliser le modèle, assurez-vous que votre dialogue inclut un noeud avec la condition conversation_start et un noeud avec une réponse par défaut.

3. Déployez SMS Gateway

Déployez SMS Gateway dans l'un des environnements suivants :

• Déployez SMS Gateway sur Docker
• Déployez SMS Gateway vers Kubernetes dans IBM Cloud

4. Configurez le webhook de demande de SMS dans votre fournisseur SMS

La définition de l'URL de demande de SMS, ou webhook, indique à votre fournisseur SMS où transférer les messages SMS envoyés à SMS Gateway.

1. Dans la console de votre fournisseur SMS, recherchez la zone où vous spécifiez l'URL pour les demandes de SMS.

   Pour RestcommONE :

   1. Dans la console RestcommONE, sélectionnez Numbers puis sélectionnez votre numéro de téléphone.
   2. Dans la zone SMS Request, sélectionnez RCML URL dans le menu déroulant.

   Pour Twilio :

   1. Dans la console Twilio, accédez à Manage Numbers > Active Numbers et sélectionnez votre numéro de téléphone.
   2. Sous Messaging sur l'onglet Configure, recherchez la zone A message comes in et sélectionnez Webhook.

2. Dans la zone de texte, entrez l'une des URL suivantes, où host-address correspond au nom d'hôte ou à l'adresse IP de votre déploiement :

   • Connexion sécurisée :

     https://host-address:9443/sms.receiver/SmsRecv
     

   • Connexion non sécurisée :

     http://host-address:9080/sms.receiver/SmsRecv
     

Pour plus de sécurité, vous pouvez configurer l'authentification pour le webhook conformément à la description fournie sous Configuration de l'authentification pour le webhook du fournisseur SMS.

5. Testez votre déploiement

Pour tester votre déploiement, vous pouvez créer une session à l'aide de l'API REST de SMS Gateway ou envoyer un message SMS si vous avez activé la création de sessions SMS via message SMS. Pour en savoir plus sur l'API REST, voir Utilisation de l'API REST pour le contrôle des sessions SMS.

• Test par l'envoi d'un message SMS

  1. Vérifiez que ALLOW_SESSION_CREATE_VIA_SMS est défini sur true dans la configuration.
  2. A partir d'un périphérique, comme par exemple un téléphone portable, envoyez un message SMS au numéro de téléphone du titulaire que vous avez configuré.

  L'envoi du message SMS invite SMS Gateway à créer une session SMS. La passerelle envoie les données du message au service Watson Assistant et répond avec une réponse appropriée au dialogue de Watson Assistant.

• Test à l'aide de l'API REST

  1. Dans votre navigateur, accédez à l'une des URL suivantes, où host-address correspond au nom d'hôte ou à l'IP de votre déploiement :
     • Connexion sécurisée :

       https://host-address:9443/publicURL/apis/explorer/
       

     • Connexion non sécurisée :

       http://host-address:9080/publicURL/apis/explorer/
       

  2. Cliquez sur List operations puis sur Create a SMS session.
  3. Sous la colonne Data type, cliquez sur l'exemple pour préremplir la zone Value.
  4. Remplacez la valeur smsUserPhoneNumber par le numéro auquel vous souhaitez envoyer un message et remplacez la valeur smsTenantPhoneNumber par le numéro de téléphone du titulaire que vous avez configuré.
  5. Cliquez sur Try it out! pour créer une session.

  Lorsque vous créez la session, SMS Gateway se connecte au service Watson Assistant et envoie la réponse de bienvenue dans un message SMS au numéro de téléphone de l'utilisateur spécifié.

Astuce : Si vous rencontrez des problèmes, vous pouvez utiliser les API REST pour tester la configuration et aider à identifier et résoudre les incidents.