Notifications Directes

Les notifications directes vous permettent d'envoyer des alertes personnelles via une simple URL webhook — sans configuration de canal, de modèle ou d'abonnés. Créez simplement une clé, appelez l'URL et recevez une notification instantanée sur votre appareil.

Qu'est-ce que Direct ?

Les canaux sont parfaits pour les notifications structurées avec modèles pouvant être partagées avec d'autres. Mais parfois, vous voulez simplement une notification personnelle rapide — un build terminé, un script achevé, un capteur déclenché. Direct est conçu exactement pour cela.

Avec Direct, vous obtenez une clé API personnelle correspondant à une URL webhook unique. Lorsque vous appelez cette URL avec un titre et un corps, la notification vous est envoyée directement sans configuration de canal.

Pour commencer

1. Créer une clé Directe

Dans l'application Echobell, appuyez sur Direct en haut de votre liste de canaux. Appuyez ensuite sur Créer pour générer une nouvelle clé Directe et donnez-lui un nom descriptif (par exemple « Serveur CI », « Labo Maison », « Bot de Trading »).

2. Copier l'URL Webhook

Chaque clé Directe possède une URL webhook unique :

https://hook.echobell.one/d/{votre-token-de-clé}

Vous pouvez trouver et copier cette URL dans la vue détaillée de la clé Directe dans l'application. Le token est masqué par défaut pour des raisons de sécurité — appuyez pour le révéler.

3. Envoyer une notification

Appelez l'URL webhook avec un corps JSON contenant title et body :

POST https://hook.echobell.one/d/VOTRE_TOKEN_DE_CLE
Content-Type: application/json

{
  "title": "Build terminé",
  "body": "Le projet X a été compilé avec succès en 3m 42s"
}

C'est tout — vous recevrez une notification immédiatement.

Effectuer des requêtes

Requête POST (Recommandée)

Envoyez un corps JSON avec le contenu de la notification :

POST https://hook.echobell.one/d/VOTRE_TOKEN_DE_CLE
Content-Type: application/json

{
  "title": "Statut du déploiement",
  "body": "v2.1.0 déployé en production",
  "externalLink": "https://dashboard.example.com/deploys/latest"
}

Requête GET

Vous pouvez aussi passer des paramètres via la chaîne de requête :

GET https://hook.echobell.one/d/VOTRE_TOKEN_DE_CLE?title=Alerte&body=CPU+à+95%25

Champs de la requête

Tous les noms de champs sont insensibles à la casse — title, Title et TITLE sont traités de la même manière, que ce soit via le corps JSON ou la chaîne de requête.

Types de notification

Vous pouvez contrôler le niveau d'urgence des notifications Directes avec le champ notificationType :

Exemple avec type de notification :

POST https://hook.echobell.one/d/VOTRE_TOKEN_DE_CLE
Content-Type: application/json

{
  "title": "Serveur en panne",
  "body": "Le serveur de production ne répond plus",
  "notificationType": "calling"
}

Cas d'utilisation courants

Scripts Shell

curl -X POST https://hook.echobell.one/d/VOTRE_TOKEN_DE_CLE \
  -H "Content-Type: application/json" \
  -d '{"title": "Migration terminée", "body": "La migration de la base de données s'\''est terminée avec succès"}'

Python

import requests

requests.post(
    "https://hook.echobell.one/d/VOTRE_TOKEN_DE_CLE",
    json={
        "title": "Entraînement terminé",
        "body": f"Précision du modèle : {accuracy:.2%}",
        "externalLink": "https://wandb.ai/runs/abc123"
    }
)

Gestion des clés Directes

• Clés multiples : Créez plusieurs clés pour différents usages (serveur CI, domotique, tâches cron, etc.). Les enregistrements de notification sont automatiquement associés à la clé qui les a déclenchés, facilitant l'identification du service émetteur de chaque notification
• Réinitialiser le token : Si l'URL webhook d'une clé est compromise, réinitialisez le token depuis la vue détaillée — l'ancienne URL sera immédiatement invalidée
• Supprimer une clé : Supprimer une clé Directe invalide définitivement son URL webhook

Meilleures pratiques

1. Sécurité : Traitez les URLs de clés Directes comme des secrets et utilisez des variables d'environnement pour stocker les tokens
2. Organisation : Nommez les clés de manière descriptive et utilisez une clé séparée par service
3. Gestion des erreurs : Vérifiez toujours le statut de réponse HTTP pour assurer une livraison réussie
4. Nettoyage : Supprimez les clés inutilisées pour réduire les risques de sécurité

Confidentialité et sécurité

• Les URLs de clés Directes doivent être traitées comme des secrets
• N'envoyez que les données nécessaires
• Le contenu des notifications est stocké localement sur votre appareil
• Nos serveurs ne font que traiter la requête et router les notifications

Dépannage

Si les notifications directes ne fonctionnent pas comme prévu :

1. Vérifiez que l'URL webhook est correcte
2. Vérifiez si la clé existe toujours (elle peut avoir été supprimée ou le token réinitialisé)
3. Assurez-vous que l'application Echobell a les permissions de notification
4. Vérifiez que le JSON est correctement formaté et que l'en-tête Content-Type: application/json est défini
5. Testez avec curl pour éliminer les problèmes liés à votre client HTTP

Besoin d'aide ? Visitez notre Centre de support ou contactez-nous à echobell@weelone.com.