IBM Cloud Docs
Intégration à SMS

Intégration à SMS

IBM Cloud

IntelePeer service de numéros de téléphone gratuits pour watsonx Assistant
À compter du 31 juillet 2025, le service de numéro de téléphone gratuit IntelePeer est supprimé pour watsonx Assistant. Après cette date, les numéros de téléphone qui utilisent ce service ne se connectent plus et les utilisateurs ne peuvent ni passer ni recevoir d'appels. Pour assurer la continuité du service, migrez vos numéros de téléphone vers Twilio ou un autre fournisseur de téléphonie. Mettez à jour vos numéros de téléphone et ajustez vos paramètres d'intégration sur watsonx Assistant. Pour obtenir de l'aide lors de la transition, contactez le service d'assistance à l'adresse suivante : https://www.ibm.com/mysupport/.

Ajoutez une intégration de messages texte afin que votre assistant puisse échanger des messages avec vos clients.

Le service SMS (Short Messaging Service) prend en charge les messages texte uniquement. Généralement, SMS limite la longueur des messages texte à 160 caractères. Le service de messagerie multimédia MMS (Multimedia Messaging Service) prend en charge l'envoi d'images et de messages texte de plus de 160 caractères. Lorsque vous créez un numéro de téléphone avec Twilio, la prise en charge des messages MMS est automatiquement incluse. La prise en charge des messages MMS IntelePeer n'est pas encore disponible.

Les clients envoient des messages textuels à votre numéro de téléphone hébergé. Twilio et IntelePeer utilisent un crochet web de messagerie que vous configurez pour envoyer une requête POST avec le corps du message texte à votre assistant. Chaque réponse de l'assistant est renvoyée à Twilio ou à IntelePeer pour être convertie en un message SMS sortant qui est envoyé au client. Les réponses sont envoyées à l'API du fournisseur de SMS pour traitement. Vous fournissez les informations de jeton d'authentification de votre fournisseur SMS, qui servent de données d'identification d'accès à l'API.

Reportez-vous aux sections suivantes pour configurer l'intégration de votre fournisseur SMS:

Avant de commencer

Pour intégrer Twilio à votre assistant, vous devez disposer au moins du rôle Développeur. Pour plus d'informations, voir la différence de rôles pour Twilio.

Si vous ne disposez pas d'un numéro de téléphone de messagerie textuelle, configurez un SMS avec Twilio et obtenez un numéro de téléphone.

Intégrer les SMS avec Twilio

  1. Accédez au site Web Twilio.

  2. Création d'un compte. Les comptes d'essai gratuits ne peuvent pas être utilisés pour cette intégration.

  3. Dans l'onglet Développement de la barre latérale, cliquez sur Numéros de téléphone. Si Numéros de téléphone n'est pas présent, accédez à la barre de recherche en haut et recherchez'Numéros de téléphone', puis sélectionnez Acheter un numéro.

  4. Suivez les instructions pour acheter un numéro. Comment rechercher et acheter un numéro de téléphone Twilio à partir de la console.

    Lorsque vous obtenez un numéro de téléphone Twilio, il prend automatiquement en charge les services vocaux, SMS et MMS. Votre nouveau numéro de téléphone est répertorié en tant que numéro actif.

Gardez la page Web Twilio ouverte dans un onglet de navigateur Web afin de pouvoir vous y référer ultérieurement. Vous pouvez également épingler des numéros de téléphone dans la barre latérale.

Configuration de l'intégration

Pour configurer l'intégration, procédez comme suit :

  1. Accédez à la page Intégrations en cliquant sur l'icône des intégrations (Icône Intégrations) dans le menu de gauche.

  2. Cliquez sur Ajouter dans la tuile SMS.

  3. Cliquez sur SMS avec la tuile Twilio.

  4. Cliquez sur Confirm.

  5. Sur le site Twilio, cliquez sur le nom de votre compte dans le menu supérieur gauche pour accéder au tableau de bord de votre compte.

    Copiez les valeurs suivantes et conservez-les temporairement, afin que vous puissiez les coller dans la page de configuration de l'intégration SMS avec Twilio dans les étapes à venir.

    • ID source du compte
    • Jeton d'authentification

  6. Revenez à la page de configuration de l'intégration SMS avec Twilio. Cliquez sur Suivant pour accéder à l'étape 1 de votre configuration d'intégration SMS avec Twilio.

  7. Entrez les informations relatives à votre SID de compte. Cliquez sur Suivant pour accéder à l'étape 2 de votre configuration d'intégration SMS avec Twilio.

  8. Entrez les informations relatives à votre Jeton d'authentification. Cliquez sur Suivant pour accéder à l'étape 3 de votre configuration d'intégration SMS avec Twilio.

  9. Facultatif : Entrez le numéro de téléphone que votre compte Twilio utilise pour l'intégration SMS. L'URI du webhook est utilisé pour transférer des messages, mais si vous ajoutez votre numéro de téléphone dans ce champ facultatif, vous pouvez facilement vous y référer plus tard. Cliquez sur Suivant pour accéder à l'étape 4 de votre configuration d'intégration SMS avec Twilio.

  10. Copiez la valeur dans la zone URI du webhook.

    Vous ajoutez cet URI à la configuration du webhook dans Twilio. Si vous souhaitez prendre en charge plusieurs numéros de téléphone, vous devez ajouter l'URI au webhook pour chaque numéro de téléphone séparément.

  11. Accédez à la page Web de votre compte Twilio. Dans l'onglet Développer de la barre latérale, cliquez sur Numéros de téléphone > Gérer > Numéros actifs.

  12. Dans la page Numéros actifs, cliquez sur l'un de vos numéros de téléphone.

  13. Accédez à la section Messagerie, puis recherchez la zone Webhook qui définit ce qu'il faut faire lorsqu'un message arrive.

    Collez la valeur que vous avez copiée dans la zone URI du webhook.

  14. Si vous souhaitez prendre en charge plusieurs numéros de téléphone, répétez l'étape précédente pour chaque numéro de téléphone que vous souhaitez utiliser.

  15. Cliquez sur Sauvegarder.

  16. Dans l'onglet Développer de la barre latérale, cliquez sur Messagerie > Paramètres > Autorisations géographiques. Si Messaging n'est pas présent, accédez à la barre de recherche dans la partie supérieure et recherchez'Messaging', puis sélectionnez SMS Geographic Permissions.

  17. Sur la page Autorisations géographiques de messagerie, sélectionnez les codes pays des numéros de téléphone qui peuvent envoyer des SMS à votre numéro Twilio. Par défaut, aucun code pays n'est autorisé à envoyer des SMS à votre numéro Twilio.

  18. Revenez à la page de configuration de l'intégration SMS avec Twilio. Cliquez surTerminer.

Intégration SMS avec IntelePeer

Si vous n'avez pas de numéro de téléphone pour la messagerie texte, créez un compte SMS sur IntelePeer et obtenez un numéro de téléphone.

  1. Accédez au site WebIntelePeer.

  2. Créez un compte ou démarrez un essai gratuit.

    Lorsque vous obtenez un numéro de téléphone IntelePeer, il prend en charge la voix et les SMS. Si le numéro n'est pas activé automatiquement pour les SMS, vous devrez l'activer manuellement. Votre nouveau numéro de téléphone est répertorié en tant que numéro actif. Voir Atmosphere Messaging-Guide de démarrage rapide

Avant de commencer

Pour intégrer IntelePeer à votre assistant, vous avez besoin du service "SMS" avec le type d'accès pour create, read, update, et delete. Pour plus d'informations, voir Gestion des utilisateurs dans le portail client.

Configuration de l'intégration

Pour configurer l'intégration, procédez comme suit :

  1. Accédez à la page Intégrations en cliquant sur l'icône des intégrations (Icône Intégrations) dans le menu de gauche.

  2. Cliquez sur Ajouter dans la tuile SMS.

  3. Sélectionnez la vignette SMS with IntelePeer.

  4. Cliquez sur Confirm.

  5. Sur le site IntelePeer Atmosphere, copiez la valeur du jeton d'authentification d'API et stockez-la temporairement afin de pouvoir la coller dans la page de configuration de l'intégration SMS with IntelePeer dans les étapes à venir.

  6. Depuis le site IntelePeer Customer Portal, sous la section Mes applications, sélectionnez SMS API Management. Dans la barre de titre Gestion SMS, cliquez sur l'icône représentant un engrenage. Ici, vous allez définir l'entrée de secret SMS. L'entrée de secret est utilisée pour empêcher le webhook de votre serveur Web de traiter les demandes POST SMS entrantes qui ne proviennent pas de IntelePeer. Définissez la valeur Secret Input ici et mémorisez-la car vous devrez l'utiliser dans la page de configuration de l'intégration de SMS avec IntelePeer dans les étapes à venir.

  7. Retournez à la page de configuration de l'intégration SMS avec IntelePeer. Cliquez sur Suivant pour passer à l'étape 1 de la configuration de l'intégration de SMS avec IntelePeer.

  8. Saisissez les informations relatives au secret de votre compte. Cliquez sur Suivant pour passer à l'étape 2 de la configuration de l'intégration de SMS avec IntelePeer.

  9. Entrez les informations relatives à votre Jeton d'authentification. Cliquez sur Suivant pour passer à l'étape 3 de la configuration de l'intégration de SMS avec IntelePeer.

  10. Facultatif: Saisissez le numéro de téléphone que votre compte IntelePeer utilise pour l'intégration des SMS. L'URI du webhook est utilisé pour transférer des messages, mais si vous ajoutez votre numéro de téléphone dans ce champ facultatif, vous pouvez facilement vous y référer plus tard. Cliquez sur Suivant pour passer à l'étape 4 de la configuration de l'intégration de SMS avec IntelePeer.

  11. Copiez la valeur dans la zone URI du webhook.

    Vous ajouterez cet URI à la configuration du webhook à l'adresse IntelePeer. Si vous souhaitez prendre en charge plusieurs numéros de téléphone, vous devez ajouter l'URI au webhook pour chaque numéro de téléphone séparément.

  12. Accédez à votre site IntelePeer Customer Portal, sous la section Mes applications, sélectionnez SMS API Management.

  13. Accédez au (x) numéro (s) de téléphone que vous souhaitez activer pour les SMS. Activez ou désactivez le bouton radial Activé / Désactivé en regard du nombre et définissez-le sur Activé. L'activation du numéro de téléphone pour les SMS peut prendre quelques minutes.

  14. Une fois que le numéro de téléphone a été activé pour les SMS, vous verrez une icône de webhook à côté du numéro.

    Collez la valeur que vous avez copiée dans la zone URI du webhook.

  15. Cliquez sur Sauvegarder.

  16. Si vous souhaitez prendre en charge plusieurs numéros de téléphone, répétez l'étape précédente pour chaque numéro de téléphone que vous souhaitez utiliser.

Pour des raisons de sécurité, les zones d'authentification sont supprimées de la vue après la configuration initiale. Si une zone requise pour l'authentification est modifiée, toutes les entrées des zones associées doivent être renseignées et validées à nouveau.

Options de configuration avancées SMS

L'onglet Options avancées est disponible après avoir configuré l'intégration SMS. Cliquez sur l'onglet Options avancées pour apporter l'une des personnalisations suivantes au comportement de la messagerie :

  • Initiate conversation from inbound messages : désactivez cette option si vous souhaitez limiter la prise en charge de la messagerie pour autoriser uniquement les messages envoyés dans le contexte d'une conversation d'intégration téléphonique en cours et ne pas autoriser les clients à démarrer un échange de messages avec l'assistant en dehors d'un appel téléphonique.
  • Default failure message : ajoutez un message à envoyer au client si la connexion SMS échoue.
  • Base URL : cette URL est le noeud final de l'API REST pour le service SMS que vous utilisez.

Optimiser vos actions pour la messagerie

Pour une expérience client optimale, concevez vos actions en gardant à l'esprit les possibilités d'intégration du SMS :

  • N'incluez pas d'éléments HTML dans vos réponses textuelles.

  • L'intégration SMS ne prend pas en charge les transferts de discussion lancés avec le type de réponse connect_to_agent.

  • Image, Audio, les types de réponse Vidéo permettent d'envoyer un message contenant des supports. Un titre et une description sont envoyés avec la pièce jointe. Notez que, selon le transporteur et l'unité de l'utilisateur final, ces messages peuvent ne pas être reçus avec succès. Pour obtenir la liste des types de contenu pris en charge pour Twilio, voir Twilio: Accepted Content Types for Media.

    Pour plus d'informations sur ces types de réponse, voir Référence des types de réponse.

Si vous souhaitez utiliser la même action pour un assistant que vous déployez sur plusieurs plateformes, ajoutez des réponses personnalisées par type d'intégration. Vous pouvez ajouter une réponse conditionnée qui indique à l'assistant de n'afficher la réponse que lorsque l'intégration SMS est utilisée.

Pour la documentation de référence, voir SMS integration reference.

Traitement des incidents

Trouvez des solutions aux problèmes que vous pourriez rencontrer lors de l'utilisation de l'intégration.

  • Si vous obtenez un message Interdit, cela signifie que le numéro de téléphone que vous avez spécifié lors de la configuration de l'intégration ne peut pas être vérifié. Assurez-vous que le numéro correspond parfaitement au numéro de téléphone de service SMS.

Migration à partir de l'agent vocal avec Watson

Si vous avez créé une instance de service IBM® Voice Agent with Watson dans IBM Cloud pour permettre aux clients d'échanger des messages texte avec un assistant, utilisez plutôt l'intégration SMS.

L'intégration des SMS permet une intégration plus transparente avec votre assistant et prend en charge autant de numéros de téléphone que nécessaire. Toutefois, l'intégration ne prend pas en charge les fonctions suivantes :

  • Démarrage d'une interaction SMS uniquement avec un texte sortant
  • Configuration des emplacements de sauvegarde
  • Révision de la page de récapitulatif de l'utilisation. Utilisez IBM Log Analysis à la place.

Pour migrer de Voice Agent with Watson vers l'intégration SMS de watsonx Assistant, suivez les étapes suivantes :

  1. Effectuez l'une des tâches suivantes :