Echobell

Intégration Upptime - Notifications de Surveillance Uptime avec GitHub

Guide complet pour intégrer Upptime avec Echobell pour des alertes de panne instantanées. Recevez des notifications push mobiles ou des appels pour les interruptions web avec surveillance d'uptime GitHub Actions, webhooks personnalisés et notifications de page d'état.

Intégration Upptime

Redirigez les événements de panne et de rétablissement d'Upptime vers Echobell afin que l'équipe reçoive des alertes sensibles au temps ou des appels, sans ajouter d'infrastructure. Ce guide traite la partie Echobell ; pour le reste, consultez la documentation officielle des notifications.

Pourquoi combiner Echobell et Upptime

  • Escalader les incidents critiques en appels tout en gardant les contrôles routiniers en push standard ou sensible au temps
  • Gabarits et variables pour afficher site impacté, statut, code de réponse et lien vers l'issue GitHub
  • Aucun service supplémentaire : un simple webhook sécurisé par canal Echobell

Prérequis

  • Un dépôt Upptime avec GitHub Actions activé
  • Le droit d'ajouter des secrets au dépôt
  • Un canal Echobell avec URL de webhook (dans l'app, ouvrez le canal et copiez le webhook)

Préparer le canal Echobell

  1. Créez ou ouvrez un canal dans Echobell et choisissez le style de notification (standard, sensible au temps ou appel).
  2. Copiez le webhook du canal : https://hook.echobell.one/t/<channel-token>.
  3. (Optionnel) Ajoutez un gabarit utilisant {{site}}, {{status}}, {{code}}, {{url}}, {{issue}} pour garder des alertes structurées.

Ajouter les secrets Upptime pour Echobell

Dans votre dépôt Upptime, allez sur Settings → Secrets and variables → Actions et ajoutez :

  • NOTIFICATION_CUSTOM_WEBHOOK=true
  • NOTIFICATION_CUSTOM_WEBHOOK_URL=https://hook.echobell.one/t/<channel-token>?site=$SITE_NAME&status=$STATUS&url=$SITE_URL&issue=$ISSUE_URL&code=$RESPONSE_CODE&emoji=$EMOJI
  • (Optionnel) NOTIFICATIONS_DOWN_MESSAGE=$EMOJI $SITE_NAME is $STATUS ($RESPONSE_CODE) – $ISSUE_URL
  • (Optionnel) NOTIFICATIONS_UP_MESSAGE=$EMOJI $SITE_NAME is back up – $SITE_URL

Remarques :

  • Les paramètres de requête transportent les données structurées vers Echobell ; Upptime insère les variables et Echobell les expose comme variables de gabarit (site, status, url, issue, code, emoji).
  • Si vous personnalisez le texte, gardez l'URL encodée (espaces en %20) pour éviter toute erreur de requête.
  • Les autres fournisseurs ou stratégies restent gérés dans Upptime ; ajoutez seulement ce qui est nécessaire pour Echobell.

Mapper les variables dans Echobell

Employez un gabarit concis pour des alertes lisibles :

Title: {{emoji}} Upptime: {{site}} is {{status}}
Body: Response {{code}} · {{url}}
External link: {{issue}}

Pour les sites critiques, basculez le canal en "sensible au temps" ou "appel" ; pour les autres, conservez le push standard.

Tester l'intégration

  • Pointez temporairement une URL surveillée vers un endpoint inexistant ou arrêtez le service pour générer une panne.
  • Vérifiez que l'alerte arrive dans Echobell avec les champs du gabarit remplis.
  • Restaurez le service et confirmez le message de rétablissement.

Dépannage

  • Vérifiez l'orthographe de NOTIFICATION_CUSTOM_WEBHOOK et NOTIFICATION_CUSTOM_WEBHOOK_URL.
  • Si vous changez le token du canal Echobell, mettez le secret à jour.
  • Pour les erreurs côté Upptime ou d'autres fournisseurs, consultez la documentation officielle et les logs GitHub Actions.

Table des matières