Comment connecter les notifications WhatsApp aux chaînes Slack sans services tiers

L'intégration des notifications WhatsApp aux canaux Slack peut améliorer considérablement la communication au sein de votre équipe en permettant de recevoir des mises à jour WhatsApp en temps réel directement dans votre espace de travail Slack. Si des services tiers comme Zapier, Onlizer ou ChatArchitect offrent des intégrations fluides, certaines entreprises préfèrent éviter les dépendances externes pour des raisons telles que la confidentialité des données, le coût ou les besoins de personnalisation. Ce guide propose une approche détaillée et experte pour configurer les notifications d'événements WhatsApp dans les canaux Slack sans services tiers, en exploitant l' API WhatsApp Business et l'API Slack. L'objectif est de parvenir à une intégration sécurisée, évolutive et personnalisable, adaptée aux besoins de votre entreprise.

‍

Pourquoi intégrer WhatsApp à Slack ?

Avant de plonger dans la configuration technique, explorons pourquoi cette intégration est précieuse :

• Communication centralisée : consolidez les demandes des clients, les mises à jour de l'équipe ou les alertes critiques de WhatsApp dans un seul canal Slack pour une meilleure collaboration.
• Notifications en temps réel : recevez instantanément des messages WhatsApp ou des déclencheurs d'événements (par exemple, de nouveaux messages, des mises à jour de statut) dans Slack, réduisant ainsi les temps de réponse.
• Aucune dépendance envers des tiers : évitez les coûts récurrents, les problèmes de confidentialité des données ou les limitations imposées par des plateformes externes.
• Personnalisation : créez une solution adaptée à vos flux de travail spécifiques, tels que le filtrage des messages hautement prioritaires ou le routage vers des canaux spécifiques.

Ce guide suppose que vous disposez d'un accès administrateur à un compte API WhatsApp Business, d'un espace de travail Slack et de connaissances de base en programmation (par exemple, Node.js ou Python). La solution utilise des webhooks, des API et un serveur léger pour gérer l'intégration.

Condition préalable

Pour configurer les notifications WhatsApp dans Slack sans services tiers, vous aurez besoin de :

1. Compte API WhatsApp Business:
   
   • Un compte WhatsApp Business enregistré avec accès API.
   • Un numéro de téléphone professionnel vérifié.
   • Informations d'identification API (clé API, ID de numéro de téléphone et jeton d'accès).
2. Espace de travail Slack:
   
   • Autorisations administratives ou propriétaires pour créer et gérer des applications Slack.
   • Un canal Slack dédié aux notifications.
3. Environnement de développement:
   
   • Un serveur ou une plateforme cloud (par exemple, AWS, Heroku ou un serveur Node.js/Python local) pour héberger la logique d'intégration.
   • Familiarité avec les API REST, les webhooks et les scripts de base côté serveur.
4. Outils:
   
   • Node.js ou Python pour les scripts.
   • Ngrok (pour les tests locaux des webhooks).
   • cURL ou Postman pour les tests d'API.

‍

Guide d'intégration étape par étape

Étape 1 : Configurer le webhook de l'API WhatsApp Business

L'API WhatsApp Business utilise des webhooks pour notifier votre serveur des messages ou événements entrants. Vous devrez configurer un point de terminaison webhook pour recevoir ces événements.

1. Créer un point de terminaison Webhook:
   
   

Configurez un serveur simple avec Node.js ou Python. Par exemple, utilisez Express.js (Node.js) pour créer un point de terminaison :

‍

const express = require ( 'express' ); const app = express(); app.use(express.json());
 app.post( '/webhook' , ( req, res ) => {   console .log( 'Webhook WhatsApp reçu :' , req.body); res.status( 200 ).send( 'Webhook reçu' ); });
 app.listen( 3000 , () =>  console .log( 'Serveur exécuté sur le port 3000' ));

‍

• Déployez ce serveur sur une URL publique (par exemple, en utilisant Heroku) ou utilisez Ngrok pour les tests locaux afin d'exposer votre hôte local à Internet.
  
  

2. Configurer WhatsApp Webhook:
   
   
   
   • Connectez-vous au portail Meta pour les développeurs (ou au tableau de bord de votre fournisseur d'API WhatsApp Business).
   • Accédez aux paramètres de l’API WhatsApp Business.
   • Ajoutez l'URL de votre webhook (par exemple, https://your-server.com/webhook).
   • Configurez le webhook pour écouter les événements tels que les messages (pour les messages entrants) ou les statuts (pour les mises à jour de livraison des messages).
     
     

Vérifiez le webhook en implémentant le point de terminaison de vérification (Meta nécessite un point de terminaison GET pour confirmer l'URL du webhook).

app.get( '/webhook' , ( req, res ) => {   const verifyToken = 'VOTRE_JETON_DE_VÉRIFICATION' ;   if (req.query[ 'hub.mode' ] === 'subscribe' && req.query[ 'hub.verify_token' ] === verifyToken) { res.status( 200 ).send(req.query[ 'hub.challenge' ]); } else { res.status( 403 ).send( 'Échec de la vérification' ); } });

‍

3. Tester le Webhook:
   
   

Envoyez un message de test à votre numéro WhatsApp Business et vérifiez que votre serveur reçoit la charge utile. Celle-ci ressemblera à ceci :

{   "object" : "whatsapp_business_account" ,   "entry" : [{     "changes  : [{       "value" : {         "messages" : [{           "from" : "1234567890" ,           "text" : { "body" : "Bonjour, ceci est un test !" } }] } }] }] }

‍

Étape 2 : créer une application Slack pour publier des notifications

Pour envoyer des événements WhatsApp à un canal Slack, vous aurez besoin d'une application Slack avec des autorisations pour publier des messages.

1. Créer une application Slack:
   
   
   
   • Accédez à api.slack.com/apps et cliquez sur « Créer une nouvelle application ».
   • Nommez votre application (par exemple, « WhatsAppNotifier ») et sélectionnez votre espace de travail Slack.
   • Sous « Autorisations », ajoutez la portée chat:write pour permettre à l’application de publier des messages.
2. Obtenir un jeton de bot:
   
   
   
   • Dans les paramètres de l’application Slack, accédez à « OAuth et autorisations ».
   • Installez l'application sur votre espace de travail et copiez le « Bot User OAuth Token » (commence par xoxb-).
3. Publication de test sur Slack:
   
   

Utilisez le point de terminaison chat.postMessage de l'API Slack pour tester la publication d'un message. Par exemple, en Node.js avec le package @slack/web-api :

const { WebClient } = require ( '@slack/web-api' ); const slack = new WebClient( 'YOUR_SLACK_BOT_TOKEN' );
 async  function  postToSlack ( channel, message ) {   await slack.chat.postMessage({     channel : channel,     text : message }); }
 postToSlack( '#whatsapp-notifications' , 'Message de test de WhatsApp !' );

‍

• Assurez-vous que le bot est invité sur le canal Slack cible (par exemple, /invite @WhatsAppNotifier).
  
  

Étape 3 : Relier les webhooks WhatsApp à Slack

Combinez maintenant le webhook WhatsApp avec l’API Slack pour transférer les notifications.

1. Analyser la charge utile du webhook WhatsApp:
   
   

Modifiez votre point de terminaison webhook pour extraire les informations pertinentes (par exemple, le numéro de téléphone de l'expéditeur, le texte du message) :

 

app.post( '/webhook' , async (req, res) => {   const payload = req.body;   if (payload.object === 'whatsapp_business_account' ) {     const messages = payload.entry[ 0 ].changes[ 0 ].value.messages;     if (messages && messages.length > 0 ) {       const message = messages[ 0 ];       const sender = message.from;       const text = message.text?.body || 'Message non textuel reçu' ;       const slackMessage = `Nouveau message WhatsApp de ${sender} : ${text} ` ;       await postToSlack( '#whatsapp-notifications' , slackMessage); } } res.status( 200 ).send( 'Webhook reçu' ); });

‍

2. Gérer les messages médiatiques:
   
   

Si le message WhatsApp contient des médias (par exemple, des images, des vidéos), récupérez l'URL du média à l'aide de l'API WhatsApp et téléchargez-le sur Slack :

const axios = require ( 'axios' );
 async  function  handleMediaMessage ( message, slackChannel ) {   const mediaId = message.image?.id || message.video?.id;   if (mediaId) {     const mediaUrl = await getMediaUrl(mediaId);     const mediaResponse = await axios.get(mediaUrl, {       headers : { Authorization : `Bearer YOUR_WHATSAPP_ACCESS_TOKEN` },       responseType : 'stream'
 });     await slack.files.upload({       channels : slackChannel,       file : mediaResponse.data,       filename : `whatsapp_media_ ${mediaId} `
 }); } }
 async  function  getMediaUrl ( mediaId ) {   const response = await axios.get( `https://graph.facebook.com/v17.0/ ${mediaId} ` , {     headers : { Authorization : `Bearer YOUR_WHATSAPP_ACCESS_TOKEN` } });   return response.data.url; }

‍

3. Déployer et tester:
   
   
   
   • Déployez votre serveur sur une plateforme cloud (par exemple, AWS EC2, Heroku).
   • Envoyez des messages de test à votre numéro WhatsApp Business et vérifiez qu'ils apparaissent dans le canal Slack désigné.

Étape 4 : Améliorer l’intégration

Pour rendre l’intégration plus robuste, tenez compte de ces fonctionnalités avancées :

• Filtrage des messages : Ajoutez une logique pour filtrer les messages en fonction de mots-clés, de l'expéditeur ou de la priorité. Par exemple, transférez uniquement les messages contenant « urgent » vers un canal Slack spécifique.
• Communication bidirectionnelle : permet aux utilisateurs de Slack de répondre aux messages WhatsApp en envoyant des messages au bot Slack, qui les transmet via l'API WhatsApp.
• Gestion des erreurs : implémentez des mécanismes de nouvelle tentative pour les appels d’API ayant échoué et enregistrez les erreurs dans un canal Slack dédié.
• Sécurité : sécurisez votre point de terminaison webhook avec l'authentification (par exemple, vérifiez la signature webhook de WhatsApp) et utilisez des variables d'environnement pour les données sensibles comme les jetons API.

Étape 5 : Surveiller et entretenir

• Surveillez l'état de votre webhook : vérifiez régulièrement que votre point de terminaison webhook reçoit des événements. Utilisez des outils comme AWS CloudWatch ou un mécanisme de journalisation simple.
• Mise à jour des versions d'API : les API WhatsApp et Slack peuvent être mises à jour. Consultez la documentation Meta for Developers et Slack pour connaître les modifications importantes.
• Évolutivité selon les besoins : si le volume des messages augmente, envisagez d’équilibrer la charge ou d’optimiser les performances de votre serveur.

‍

Défis et considérations

• Restrictions de l'API WhatsApp : L'API WhatsApp Business est soumise à des règles strictes, notamment en matière d'approbation des modèles de messages et de limites de débit. Assurez-vous de respecter ces règles pour éviter la suspension de votre compte.
• Limites de débit Slack : l'API Slack impose des limites de débit (par exemple, 1 message par seconde et par canal). Implémentez la mise en file d'attente pour les notifications à volume élevé.
• Confidentialité des données : puisque vous traitez des données clients, assurez-vous de la conformité au RGPD ou au CCPA en sécurisant les données en transit et au repos.
• Frais généraux de maintenance : sans services tiers, vous êtes responsable de la disponibilité du serveur, des mises à jour et du débogage.

‍

Conclusion

L'intégration des notifications WhatsApp aux canaux Slack sans services tiers est un moyen efficace de rationaliser la communication tout en gardant un contrôle total sur vos données et vos flux de travail. En exploitant l'API WhatsApp Business et l'API Slack, vous pouvez créer une solution sur mesure adaptée aux besoins de votre équipe. Bien que cette approche nécessite une expertise technique et une maintenance continue, elle offre une flexibilité et des économies inégalées par rapport aux plateformes tierces.

‍