Transférer les SMS entrants vers Slack

​

Créer l’application CloudTalk dans Slack

1. Depuis la page Slack API apps, sélectionnez Create an App.
   
2. Sélectionnez From scratch.
3. Saisissez CloudTalk comme App Name et sélectionnez l’espace de travail Slack de votre entreprise.
4. Create App.
5. Accédez à Features > Incoming Webhooks dans les pages de l’application.
   1. Activez Activate Incoming Webhooks.
      
6. Accédez à Features > OAuth & Permissions.
   1. Sous Scopes > Bot Token Scopes, sélectionnez Add an OAuth Scope.
      1. Sélectionnez le scope chat:write.customize.
      2. Sélectionnez Add scopes lorsqu’il vous est demandé d’ajouter chat:write.
      3. Sélectionnez chat:write.public comme dernier scope de cette section.
         
   2. Sous Scopes > User Token Scopes, sélectionnez Add an OAuth Scope.
      1. Sélectionnez chat:write.
7. Accédez à Settings > Install App et sélectionnez Install to Workspace.
8. Choisissez le canal dans lequel vous souhaitez que votre application CloudTalk publie. Allow.
   
9. Lorsque vous êtes redirigé vers Settings > Install App, vous pourrez voir le User OAuth Token et le Bot User OAuth Token. Vous devrez copier l’une de ces valeurs lors de la configuration de votre workflow.
   

​

Workflow SMS Slack

• Transférer un message texte d’un client important vers le canal Slack de l’équipe.

​

Prérequis

• Vous avez souscrit un plan Essential, Expert ou Custom chez CloudTalk
• Vous avez créé une application CloudTalk dans Slack et l’avez connectée au canal Slack souhaité (voir Créer l’application CloudTalk dans Slack).
• Les autorisations du token pour le canal Slack de votre équipe incluent les autorisations chat:write, ce qui signifie que votre espace de travail autorise les données provenant d’une autre application à publier sur les canaux Slack à la place d’un utilisateur individuel. Vous pouvez consulter le guide d’aide de l’API Slack pour en savoir plus sur le fonctionnement des tokens Slack.

​

Envoyer une notification SMS vers un canal

1. Sélectionnez + Ajouter un workflow et nommez votre workflow.
2. Commencez par définir un déclencheur. Dans cet exemple, notre déclencheur sera la réception d’un SMS. Sous Objet, nous sélectionnerons Message. Pour Action, nous sélectionnons reçu. Adaptez vos propres paramètres si nécessaire.
   
3. Nous pouvons maintenant choisir de définir une condition facultative. La condition définira une situation ou une catégorie supplémentaire qui doit être remplie pour que notre notification Slack automatisée soit envoyée.
4. Dans notre exemple, seuls nous intéressent les SMS reçus (notre déclencheur) provenant d’un client important précis. Nous voulons donc définir une condition selon laquelle le système vérifiera si l’expéditeur du SMS a le même numéro que ce client important. Pour renseigner correctement le champ, cliquez dans le premier champ intitulé Propriété, puis consultez la liste des expressions disponibles à droite, sous Données utiles pour votre Workflow. Nous choisirons l’expression intitulée sender.
   
   Important: You must choose from this list of tag words in order for your condition to work correctly. You should see the Property input populate with a value that looks like the structure of the one in the picture (event.properties.tags) 
   
5. Dans le menu déroulant intitulé Opérande, nous choisirons est égal à dans la liste. Lorsque vous sélectionnez votre propre opérande, assurez-vous qu’il s’intègre logiquement dans votre énoncé final (par exemple, « est supérieur ou égal à » s’associe mieux à une valeur numérique).
6. Dans le champ Valeur, nous renseignons la valeur à laquelle le sender doit être égal pour que notre action se déclenche. Reportez-vous aux Exemples de valeurs associés dans la barre latérale Données utiles pour votre Workflow. Dans notre exemple, la valeur suggérée sera le numéro de téléphone du client important, saisi dans le format indiqué.
   
   Cliquez sur Confirmer et continuer. Nous venons de créer une condition qui analysera les numéros CloudTalk de tous les SMS reçus, en vérifiant si le numéro de l’expéditeur correspond à celui du client important.
7. L’étape suivante consiste à choisir une action qui se produira lorsque nos conditions seront remplies. Nous sélectionnons le type d’action Envoyer une notification à Slack.
8. Sous Valeurs, différentes clés de chaque ensemble clé-format-valeur sont pré-remplies et ne peuvent pas être modifiées. Vous utiliserez la partie valeur de ces ensembles pour configurer vos notifications Slack. Dans l’ensemble de configuration où la Clé correspond au token, remplacez les x par la valeur réelle du token afin d’autoriser la communication entre CloudTalk et votre espace de travail Slack. Pour vous connecter à Slack, vous devez utiliser soit le User OAuth Token, soit le Bot User OAuth Token, que vous trouverez dans les paramètres de votre application Slack (voir Créer l’application CloudTalk dans Slack).
   
   1. Le Bot User OAuth permet de publier dans n’importe quel canal Slack public, tandis que le User OAuth exige que vous soyez ajouté au canal.
   2. Consultez le centre d’aide Slack pour en savoir plus sur les tokens Slack.
9. Saisissez le nom de votre canal Slack dans le champ Valeur de l’ensemble de configuration où la Clé correspond au channel.
10. Dans l’ensemble de configuration où la Clé correspond au text, vous pouvez choisir de saisir une valeur dynamique, c’est-à-dire une valeur renseignée à partir des informations du système. Pour cela, cliquez dans le champ, puis sélectionnez un mot-clé dans la section Données utiles pour votre Workflow, comme décrit à l’étape 4 de ce guide..
11. Nous avons choisi trois valeurs dynamiques pour le text, c’est-à-dire le contenu de notre message envoyé vers Slack. Nous savons que la notification Slack contiendra le numéro de téléphone, le numéro de téléphone du destinataire et le contenu du SMS reçu.
    
12. Cliquez sur Confirmer et continuer pour terminer la configuration de l’étape d’action.
13. Cliquez sur Enregistrer pour terminer la configuration du workflow.
14. Pour activer vos notifications Slack, activez votre workflow en basculant l’interrupteur situé à côté du nom du workflow sur la position On.
    

​

Conseils de dépannage

• Concernant Slack :
  • Vérifiez que l’application Slack de votre équipe fonctionne correctement et que vous êtes connecté
  • Vérifiez que vous avez bien autorisé Slack à accéder à CloudTalk
  • Assurez-vous que les scopes de votre token incluent les autorisations chat:write. Consultez les guides de l’API Slack ou le centre d’aide Slack pour obtenir de l’aide.

• Les conditions défectueuses résultent souvent de valeurs non reconnues dans le champ Propriété, ou d’une valeur saisie dans le champ Valeur qui ne donnera jamais de correspondance.
• Après avoir cliqué dans le champ Propriété, vous devez cliquer sur l’un des mots-clés prédéfinis de la section Données utiles pour votre Workflow située à droite.
• Vous pouvez également vous reporter à la section Données utiles pour votre Workflow pour vérifier si la Valeur que vous avez saisie correspond bien à la propriété que vous avez choisie.
• Lorsque vous définissez une valeur pour une condition qui recherche des numéros de téléphone saisis, assurez-vous d’utiliser le numéro reconnu par CloudTalk. Le format a son importance. Si l’exemple de valeur suggéré dans la section Données utiles pour votre Workflow affiche un numéro au format « +55 55 5555 5555 » (sans tirets) mais que la valeur saisie ressemble à « +55 55 5555 5555 » (avec tirets), votre condition ne trouvera jamais de correspondance.