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

L'intégration des notifications WhatsApp aux canaux Slack peut considérablement améliorer la communication d'équipe en permettant de recevoir des mises à jour en temps réel de WhatsApp directement dans votre espace de travail Slack. Bien que 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 de confidentialité des données, de coût ou de 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 recourir à des services tiers, en utilisant les API de WhatsApp Business et de Slack. L'objectif est de parvenir à une intégration sécurisée, évolutive et personnalisable, adaptée aux besoins spécifiques de votre entreprise.

‍

Pourquoi intégrer WhatsApp à Slack ?

Avant d'aborder la configuration technique, explorons pourquoi cette intégration est précieuse :

• Communication centralisée : Regroupez 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 les messages WhatsApp ou les déclencheurs d’événements (par exemple, les nouveaux messages, les 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 les plateformes externes.
• Personnalisation : Créez une solution adaptée à vos flux de travail spécifiques, comme le filtrage des messages 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, à 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é.
   • Identifiants API (clé API, numéro de téléphone et jeton d'accès).
2. Espace de travail Slack:
   
   • Autorisations d'administrateur ou de propriétaire 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.
   • Connaissance des API REST, des webhooks et des concepts de base de la programmation côté serveur.
4. Outils:
   
   • Node.js ou Python pour le scripting.
   • 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 en cours d'exécution 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 sur Internet.
  
  

2. Configurer le webhook WhatsApp:
   
   
   
   • Connectez-vous au portail Meta for Developers (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://votre-serveur.com/webhook).
   • Configurez le webhook pour qu'il écoute les événements tels que les messages (pour les messages entrants) ou les statuts (pour les mises à jour de la distribution 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 bien le contenu. Ce contenu 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 la publication des notifications

Pour envoyer des événements WhatsApp vers un canal Slack, vous aurez besoin d'une application Slack disposant des autorisations nécessaires pour publier des messages.

1. Créer une application Slack:
   
   
   
   • Rendez-vous sur 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.
   • Dans la section « Autorisations », ajoutez l’autorisation chat:write pour permettre à l’application de publier des messages.
2. Obtenez 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 « jeton OAuth de l'utilisateur du bot » (commence par xoxb-).
3. Test de publication sur Slack:
   
   

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

const { WebClient } = require ( '@slack/web-api' ); const slack = new WebClient( 'VOTRE_JETON_SLACK_BOT' );
 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 : Connecter 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-la 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} `
 }); } }
  fonction  asynchrone 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éploiement et test:
   
   
   
   • 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 bien dans le canal Slack désigné.

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

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

• Filtrage des messages : ajoutez une logique de filtrage des messages en fonction de mots-clés, de l’expéditeur ou de la priorité. Par exemple, transférez uniquement les messages contenant le mot « urgent » vers un canal Slack spécifique.
• Communication bidirectionnelle : Permettez 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 : Mettre en œuvre des mécanismes de nouvelle tentative pour les appels API ayant échoué et consigner les erreurs dans un canal Slack dédié.
• Sécurité : Sécurisez votre point de terminaison webhook avec une authentification (par exemple, vérifiez la signature webhook de WhatsApp) et utilisez des variables d'environnement pour les données sensibles telles que les jetons d'API.

Étape 5 : Surveiller et entretenir

• Surveillez l'état de vos webhooks : vérifiez régulièrement que votre point de terminaison webhook reçoit bien les é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 régulièrement Meta for Developers et la documentation de l'API Slack pour prendre connaissance des changements importants.
• Adaptez la charge à vos besoins : si le volume de messages augmente, envisagez l'équilibrage de charge ou l'optimisation des 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 l'approbation des modèles de messages et des limites de débit. Veillez à les respecter afin d'éviter la suspension de votre compte.
• Limites de débit de Slack : L’API de Slack impose des limites de débit (par exemple, 1 message par seconde et par canal). Mettez en place un système de file d’attente pour les notifications à volume élevé.
• Protection 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 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 recourir à des services tiers, est un moyen efficace de fluidifier la communication tout en conservant la maîtrise totale de vos données et de vos flux de travail. Grâce aux API de WhatsApp Business et de Slack, vous pouvez créer une solution personnalisée répondant aux besoins de votre équipe. Bien que cette approche exige une expertise technique et une maintenance régulière, elle offre une flexibilité et des économies inégalées par rapport aux plateformes tierces.

‍