· 5 min · TextMeFlow Team

Alertes WhatsApp pour échecs CI/CD et monitoring d'uptime

Slack et l'e-mail conviennent pour les alertes que vous finirez par remarquer. Pour celles qui exigent une réaction dans les cinq minutes — un déploiement de production en échec, un serveur qui ne répond plus —, ils ne suffisent pas. Personne n'a ses notifications Slack à plein volume à 2 h du matin, mais presque tout le monde voit arriver un message WhatsApp. TextMeFlow n'étant qu'une API REST derrière un numéro de téléphone, la brancher sur un pipeline CI ou un moniteur d'uptime ne demande que quelques lignes, sans adopter un nouvel outil d'astreinte.

Envoyer une alerte depuis un workflow GitHub Actions

Le cas le plus simple : une étape qui ne s'exécute que si un job précédent échoue, et qui envoie un POST vers /v1/messages.

- name: Notify on failure
  if: failure()
  run: |
    curl -sS -X POST https://api.textmeflow.eu/v1/messages \
      -H "Authorization: Bearer ${{ secrets.TEXTMEFLOW_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{
        "to": "+32472932208",
        "text": "Échec du déploiement : ${{ github.repository }} @ ${{ github.sha }} (run ${{ github.run_id }})",
        "urgent": true
      }'

Stockez la clé d'API comme secret du dépôt, jamais dans le fichier de workflow lui-même. La réponse est un 202 avec un message_id que vous pouvez consigner si vous voulez confirmer la livraison plus tard via GET /v1/messages/{id}. Incluez le SHA du commit et l'identifiant du run dans le texte : un simple « build échoué » oblige de toute façon le lecteur à ouvrir GitHub, ce qui va à l'encontre de l'intérêt d'une alerte push.

Relayer les webhooks des moniteurs d'uptime

La plupart des outils d'uptime (options auto-hébergées comme Uptime Kuma, ou externes avec une intégration webhook générique) appellent déjà votre URL avec un corps JSON à chaque transition up/down — ils ne savent simplement pas parler directement à l'API de TextMeFlow. La solution est un petit point de terminaison relais dans la stack que vous exploitez déjà, qui traduit leur payload en envoi TextMeFlow :

// Relais Express : reçoit le webhook du moniteur, le republie vers TextMeFlow
app.post('/alerts/uptime', express.json(), async (req, res) => {
  const { monitor, status, msg } = req.body; // la forme dépend de votre moniteur
  if (status === 'down') {
    await fetch('https://api.textmeflow.eu/v1/messages', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.TEXTMEFLOW_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        to: process.env.ONCALL_NUMBER,
        text: `${monitor} is DOWN: ${msg}`,
        urgent: true,
      }),
    });
  }
  res.sendStatus(200);
});

Gardez ce relais volontairement simple : une seule mission (traduire la forme du payload, transmettre), sans logique de nouvelle tentative propre. Si l'appel à TextMeFlow échoue, laissez le retry/backoff de votre moniteur renvoyer le webhook plutôt que d'empiler une seconde couche de relance.

Contourner les heures calmes — mais seulement pour de vrais incidents

TextMeFlow diffère les messages non urgents envoyés entre 22 h 00 et 8 h 00, heure locale du destinataire, afin qu'un rappel ne réveille personne. Pour un incident réel, c'est exactement le contraire de ce que vous voulez, et c'est pourquoi le champ urgent: true existe : il court-circuite entièrement le lissage des heures calmes. Réservez-le aux alertes qui exigent vraiment une réponse hors des heures de bureau ; le pipeline anti-spam relève légèrement le score de risque de votre compte à chaque envoi forcé en heures calmes, ce qui convient pour une poignée de vrais incidents par mois et n'est pas conçu pour le bruit courant de la CI. Envoyez vos échecs de tests instables, relancés automatiquement, vers Slack et gardez les envois urgent pour les alertes qui justifieraient d'appeler quelqu'un.

Ne laissez pas une avalanche d'alertes atteindre votre propre limite de débit

Si dix services tombent dans la même minute, votre monitoring tentera volontiers d'envoyer dix messages WhatsApp dans cette même minute — soumis à la même limite de débit et au même quota mensuel que tout autre trafic de votre compte. Deux choses valent d'être prévues dès le départ : un debounce à la source (un message de synthèse par incident instable, pas un par vérification) et la gestion des réponses 429 de l'API comme n'importe où ailleurs — voir gérer les limites de débit et le statut des messages pour du code de retry/backoff en Node et Python. Si votre rotation d'astreinte dépasse cinq personnes et que vous êtes tenté d'envoyer le même texte à tout le monde en même temps, variez légèrement le message (nom, rôle, ou simplement le niveau d'escalade du destinataire) : envoyer exactement le même corps à plus de cinq numéros distincts en dix minutes déclenche la détection de diffusion prévue pour les envois marketing, pas pour les alertes d'astreinte. Les limites exactes par forfait figurent dans la documentation des limites de débit.

Pour commencer

Pas besoin d'un forfait payant pour mettre cela en place : les 50 messages par mois de l'offre gratuite, sans expiration, suffisent pour tester de bout en bout une étape GitHub Actions ou un relais de moniteur d'uptime avant qu'ils ne transportent de vraies alertes. Consultez la forme complète des requêtes et réponses dans la référence de l'API, puis commencez gratuitement et recevez dès aujourd'hui sur votre téléphone votre première alerte de déploiement échoué.

Envie d'envoyer des messages WhatsApp via API ?

Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.

Gratuit pour toujours