Dans cet article, vous apprendrez à créer le compte Twilio nécessaire, à configurer et à connecter la fonctionnalité SMS par Twilio à RemOnline.
Qu'est-ce que Twilio ?
Twilio est une plateforme d'API de communication qui permet aux développeurs et aux entreprises d'intégrer facilement des outils de communication tels que la téléphonie, les SMS, les chats et la vidéo dans leurs applications et sites web. Avec Twilio, vous pouvez envoyer des messages texte, passer des appels téléphoniques, configurer des réponses automatisées, etc. Twilio nous aidera à intégrer les SMS dans RemOnline.
Créer un compte Twilio
Avant de commencer à utiliser ce guide, vous aurez besoin de :
Un compte Twilio mis à niveau. Si vous êtes nouveau sur Twilio, créez un compte gratuit et mettez-le à niveau en associant un mode de paiement. Pour plus d'informations sur la mise à niveau vers un plan payant, consultez la section Mise à niveau vers un compte Twilio payant dans l'article Comment mettre à niveau votre compte et acheter des numéros dans Twilio ?
Numéro de téléphone Twilio. Vous pouvez apprendre comment acheter un numéro de téléphone Twilio dans l'article Comment mettre à niveau votre compte et acheter des numéros dans Twilio dans la section Comment acheter un numéro Twilio ?
L'étape suivante consiste à créer un service de messagerie.
Créer un service de messagerie
Pour créer un service de messagerie, allez dans Messaging > Services et cliquez sur Create Messaging Service.
Étape 1. Spécifiez le nom et l'objectif du service
Messaging Service friendly name - donnez un nom à votre Messaging Service (par exemple, Chats de commande)
Veuillez noter que ce nom ne sera affiché que dans Twilio. Lorsque vos clients recevront un message, ils ne verront que le numéro de téléphone de l'expéditeur.
Select what you want to use Messaging for - choisissez l'objectif qui convient le mieux à vos chats.
Cliquez sur Create Messaging Service.
Étape 2. Ajouter le numéro
Cliquez sur Add senders, sélectionnez Phone number et choisissez le numéro pour lequel vous souhaitez activer le service de messagerie. Vous pouvez personnaliser davantage le numéro sélectionné.
Sticky Sender (Expéditeur fixe) : assure la cohérence pour les destinataires des messages en sélectionnant le même numéro de téléphone d'expéditeur que celui que vous avez précédemment utilisé lors d'une conversation avec un client donné.
Area Code Geomatch (Correspondance de l'indicatif régional) : utilisez des numéros de téléphone locaux avec des indicatifs régionaux qui correspondent ou se superposent au numéro de téléphone de votre destinataire lorsque vous envoyez des messages aux États-Unis et au Canada.
Ces fonctionnalités sont activées par défaut. Pour les désactiver, cliquez sur le bouton à bascule.
Vous pouvez également ajouter d'autres numéros si vous n'en avez pas sélectionné plusieurs à l'étape précédente en cliquant sur le bouton Add Senders, ou supprimer un numéro déjà ajouté en cliquant sur Remove à côté de celui-ci.
Sélectionnez les numéros que vous souhaitez configurer et cliquez sur Étape 3. Configurer l'intégration.
Étape 3. Configurer les webhooks
Au cours de cette étape, vous devez configurer des webhooks pour automatiser les processus et synchroniser les données entre vos comptes Twilio et RemOnline.
Sélectionnez l'option Send a webhook et collez les liens nécessaires dans les champs suivants :
Dans les champs Request URL et Fallback URL – même lien :
https://web.remonline.app/chat-service/v1/webhook/twilio/sms
Dans le champ Callback URL :
https://web.remonline.app/chat-service/v1/webhook/twilio/sms/status
L'option HTTP Post doit être activée à côté des champs Request URL et Fallback URL.
Nous vous recommandons de laisser la valeur par défaut de 14400 dans le champ Validity period. La période de validité correspond au nombre de secondes pendant lesquelles les messages envoyés depuis votre service de messagerie resteront sur la plateforme Twilio. Si le temps nécessaire à l'envoi du message dépasse la période de validité, Twilio rejette le message et envoie une demande à votre URL de rappel d'état pour notifier votre application de l'échec.
Pour continuer, cliquez sur Étape 4 : Add compliance info.
Étape 4. Ajouter les informations de conformité
Important : cette étape n'est nécessaire que si vous utilisez un numéro américain.
Pour ce faire, vous devez vous inscrire au programme A2P 10DLC (code à 10 chiffres) aux États-Unis.
Il s'agit d'un système américain qui permet aux entreprises d'envoyer des messages de type « application à personne » (A2P) à l'aide de numéros de téléphone à 10 chiffres (10DLC). L'inscription à A2P 10DLC via Twilio implique plusieurs étapes :
configurer votre compte ;
enregistrer votre marque ;
enregistrer vos cas d'utilisation ;
enregistrer vos numéros de téléphone.
Remplir le formulaire prend quelques minutes si vous avez préparé toutes les informations nécessaires.
L'approbation finale de votre inscription prend 1 à 2 semaines. Vous pouvez utiliser la console Twilio pour vérifier le statut de votre inscription US A2P 10DLC.
Vous pouvez finaliser la création et la configuration du service de messagerie avant que votre inscription A2P 10DLC ne soit approuvée. Cela vous permettra d'avoir votre système prêt à fonctionner dès que votre inscription sera terminée. Profitez de ce temps pour tester et configurer tous les composants nécessaires afin de vous assurer que votre service est opérationnel et fonctionne correctement.
Veuillez noter que tant que votre inscription n'est pas terminée, il peut y avoir des restrictions sur le nombre et la fréquence des messages que vous pouvez envoyer, et l'envoi de gros volumes de messages avant la fin de votre inscription peut entraîner le blocage ou la baisse de la priorité de vos messages.
Vous pouvez en savoir plus sur le processus d'inscription A2P 10DLC ici.
Donc, pour terminer la création du service de messagerie, cliquez sur Complete Messaging Service Setup.
Fermé ! La dernière étape consiste à vous connecter à RemOnline, après quoi vous pourrez utiliser les SMS pour communiquer avec vos clients.
Se connecter à RemOnline
Pour connecter un numéro SMS par Twilio à RemOnline :
1. Sur le Tableau de bord Twilio, allez dans la section Account Info. Vous y trouverez le Account SID et l'Auth Token dont vous avez besoin pour vous connecter aux chats RemOnline. Copiez ces informations.
2. Allez ensuite dans Messaging > Services et trouvez le Service de messagerie que vous avez créé. Copiez son Sid.
3. Dans RemOnline, allez dans Paramètres > Chats et cliquez sur + Canal. Sélectionnez la ressource SMS by Twilio.
4. Remplissez tous les champs :
Nom du canal - trouvez un nom pour votre canal SMS que vous utiliserez pour communiquer avec les clients.
SID du compte - collez le code SID du compte copié depuis votre compte Twilio.
Important : si un canal avec un SID de compte identique est déjà connecté par une autre entreprise, le système ne vous permet pas de connecter un nouveau canal avec le SID de compte dans RemOnline. Pour y remédier, vous devez supprimer l'intégration existante dans une autre entreprise, puis ajouter un canal avec ce SID de compte à RemOnline.
Auth Token : collez ici le code Auth Token copié depuis votre compte Twilio.
Numéro de téléphone - entrez le numéro de téléphone que vous avez enregistré auprès de Twilio et que vous utiliserez pour communiquer avec les clients.
Remarque : vous ne pouvez connecter qu'un seul canal par numéro. Autrement dit, si vous avez déjà connecté un canal WhatsApp au même numéro, vous ne pourrez pas créer de canal SMS.
SID du service de messagerie - vous devez coller ici le code SID du service de messagerie copié depuis la page du service de messagerie.
5. Configurez l'accès au canal :
Tous les employés de l'entreprise auront accès aux paramètres de Chat, à condition que cet accès soit autorisé par le système ;
Sélectionnés : seuls les employés sélectionnés auront accès aux paramètres de Chat, à condition qu'ils soient autorisés par le système ;
Propriétaire : seul le propriétaire de l'entreprise aura accès aux paramètres.
Pour modifier les paramètres d'accès des employés à Chat et aux paramètres de Chat, allez dans Paramètres > Employés > Rôles et modifiez les paramètres nécessaires.
6. Cliquez sur Créer.
Fermé ! Vous pouvez désormais discuter avec les clients par SMS directement dans RemOnline. Pour en savoir plus sur le fonctionnement des chats, cliquez ici.