Echobell Direct : alertes Webhook personnelles sans configuration de canal

Echobell Direct est un mode d'alerte personnel qui court-circuite entièrement la configuration des canaux. Vous créez une clé Direct, obtenez une URL Webhook, et envoyez un title + body en POST pour recevoir une notification instantanée sur votre appareil. Pas d'abonnés, pas de modèles, pas de configuration de routage.

Ce guide couvre ce qu'est Direct, comment le configurer et quand l'utiliser plutôt que les Canaux.

Qu'est-ce qu'Echobell Direct ?

Chaque clé Direct génère une URL Webhook unique (/d/{token}). Envoyez une requête à cette URL et la notification arrive immédiatement sur votre appareil.

Utilisez Direct lorsque vous avez besoin de :

Notifications personnelles depuis des scripts, des tâches cron ou des pipelines CI
Titre et corps personnalisés par requête plutôt que des modèles fixes
Configuration rapide sans configurer un canal complet

Si vous avez besoin de notifications partagées, de modèles réutilisables ou d'une livraison conditionnelle, utilisez plutôt les Canaux via Webhooks.

Configuration en 3 étapes

Étape 1 : Créer une clé Direct

Ouvrez Echobell, appuyez sur Direct dans votre liste de canaux et créez une clé. Nommez-la d'après le service auquel elle appartient (ex. CI Server, Cron, AI Tasks).

Étape 2 : Copier votre URL Webhook

Chaque clé dispose d'une URL au format :

https://hook.echobell.one/d/YOUR_KEY_TOKEN

Traitez cette URL comme un secret — toute personne la possédant peut vous envoyer des notifications.

Étape 3 : Envoyer votre première notification

curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy failed",
    "body": "api-service failed health check",
    "notificationType": "time-sensitive",
    "externalLink": "https://dashboard.example.com/deploys/123"
  }'

Référence complète des champs : API Direct

Niveaux d'urgence

Direct supporte notificationType pour adapter l'urgence à l'événement :

active — mises à jour régulières
time-sensitive — alertes importantes qui passent outre le mode Concentration
calling — incidents critiques (nécessite un abonnement premium actif ; revient à time-sensitive sinon)

Voir Types de notifications pour les détails complets.

Ajouter du contexte aux alertes

Incluez externalLink dans le corps de la requête pour joindre une URL à la notification — utile pour lier directement vers un log de déploiement, un tableau de bord ou une pull request.

Pour les agents IA et les tâches asynchrones longues, Direct est un moyen simple d'être notifié quand le job se termine plutôt que de surveiller manuellement. Voir aussi : WebhookMCP + Echobell.

Direct vs Canaux

	Direct	Canaux
Audience	Personnel uniquement	Partagé avec les coéquipiers
Modèles	Contenu par requête	Modèles réutilisables et fixes
Délai de configuration	Moins d'une minute	Nécessite la configuration du canal
Conditions	Non supportées	Supportées

Utilisez les Canaux quand les alertes doivent atteindre plusieurs personnes ou quand vous souhaitez un formatage cohérent à travers un service. Documentation Modèles · Qu'est-ce qu'Echobell

Bonnes pratiques de sécurité

Stockez les tokens Direct dans des variables d'environnement ou un gestionnaire de secrets, pas dans le code
Créez une clé par service pour pouvoir révoquer individuellement
Faites une rotation des tokens immédiatement si une URL a pu fuiter
Réservez calling aux vrais incidents — l'abus entraîne la fatigue des alertes

FAQ

Direct est-il réservé aux développeurs ? Non. Toute personne disposant d'un outil capable d'envoyer des requêtes HTTP peut l'utiliser.

Direct supporte-t-il les requêtes GET ? Oui, mais POST avec JSON est recommandé.

Que se passe-t-il si mon abonnement expire et que j'utilise calling ? Il revient automatiquement à time-sensitive.

Commencez avec le guide Direct. Quand votre workflow nécessite collaboration ou modèles, les Canaux constituent une étape suivante naturelle.