Destinataires et routage

Vous gérez vos destinataires dans Wallet Center → Watchdog → Canaux de notification. Chaque destinataire a un nom, un canal et un statut : Actif, Non testé, Vérification en attente, Injoignable ou Désactivé. Vous pouvez avoir jusqu’à 20 destinataires. Ajouter un destinataire ouvre une boîte de dialogue avec tous les canaux ; Discord a son propre bouton Connecter Discord.

La cloche de notifications sur ftso.app est toujours présente. L’interrupteur Alertes dans la cloche détermine si les alertes de signal y apparaissent aussi ; les messages de compte et système y apparaissent toujours.

Telegram (chat privé)

1. Choisissez Ajouter un destinataire, puis Telegram, et saisissez un nom.
2. Appuyez sur Créer le lien. Le lien est valable 10 minutes et ne fonctionne qu’une fois.
3. Ouvrez le lien vous-même, ou envoyez-le à la personne qui doit recevoir les alertes.
4. Telegram ouvre le bot FTSOBest Watchdog. Appuyez sur Démarrer.
5. De retour dans le Watchdog, le destinataire s’affiche comme Connecté. Envoyez un test.

Si le lien a expiré, créez-en simplement un nouveau. Si vous bloquez le bot plus tard, le destinataire devient Injoignable.

Groupe Telegram

1. Choisissez Ajouter un destinataire, puis Groupe Telegram, et appuyez sur Créer le lien.
2. Ouvrez le lien dans Telegram et choisissez le groupe.
3. Ajoutez le bot comme membre. Il n’a pas besoin de droits d’administrateur, mais la personne qui le connecte doit être administrateur du groupe.
4. Le groupe apparaît comme destinataire. Envoyez un test ; tous les membres du groupe le voient.

Les alertes de groupe ne sont pas retenues pendant les heures calmes. Un groupe est donc un bon endroit pour les alertes que toute votre équipe doit voir.

Discord (message direct)

1. Appuyez sur Connecter Discord. Discord s’ouvre et vous demande d’autoriser l’application FTSOBest Watchdog.
2. Vous êtes ajouté au serveur Discord FTSOBest et renvoyé vers le Watchdog.
3. Terminez la vérification sur le serveur. D’ici là, le destinataire affiche Vérification en attente.
4. Appuyez sur Revérifier. Dès que la vérification est trouvée, les alertes sont actives.

Il y a un destinataire Discord par wallet. Si nous n’avons pas pu vous ajouter au serveur, rejoignez-le manuellement et connectez-vous de nouveau.

E-mail

1. Choisissez Ajouter un destinataire, puis E-mail, et saisissez l’adresse.
2. Nous envoyons un e-mail de confirmation. Ouvrez-le et appuyez sur Confirm address. Le lien est valable 48 heures.
3. Le destinataire affiche « E-mail confirmé — les alertes sont actives. »

Si l’e-mail n’arrive pas, vérifiez votre dossier de spam et utilisez Renvoyer l’e-mail. Pour protéger les adresses contre les abus, un wallet peut déclencher au maximum 10 e-mails de confirmation par jour, et chaque adresse en reçoit au maximum 3 par jour. Si un lien a expiré, enregistrez de nouveau l’adresse pour en obtenir un nouveau.

Webhook

Pour votre propre système, bot ou intégration. Le Watchdog envoie chaque alerte sous forme de POST JSON signé.

1. Choisissez Ajouter un destinataire, puis Webhook, et saisissez l’URL de votre point de terminaison.
2. Enregistrez. Le secret de signature ne s’affiche qu’une fois, juste après l’enregistrement. Conservez-le en lieu sûr ; il ne peut pas être affiché de nouveau.
3. Appuyez sur Envoyer un test. Le destinataire devient actif après un test réussi.

L’URL doit utiliser HTTPS public sur le port 443 ou sur un port à partir de 1024. Les adresses privées et internes sont refusées.

Chaque requête contient les en-têtes X-Watchdog-Signature, X-Watchdog-Timestamp et X-Watchdog-Payload-Version. La signature est sha256= suivi du HMAC-SHA256 de l’horodatage, d’un point et du corps brut, avec votre secret comme clé. Comparez-la en temps constant et refusez les horodatages trop anciens pour bloquer les rejeux. La liste des champs se trouve dans le schéma du webhook, et des exemples de code dans la documentation API.

Webhook Discord

Publie les alertes dans un salon de votre propre serveur Discord. Vous avez besoin de l’autorisation de gérer les webhooks sur ce serveur.

1. Dans Discord, ouvrez Paramètres du serveur → Intégrations → Webhooks et choisissez Nouveau webhook.
2. Choisissez le salon et appuyez sur Copier l’URL du webhook.
3. Dans le Watchdog, choisissez Ajouter un destinataire, puis Webhook Discord, et collez l’URL.
4. Enregistrez et appuyez sur Envoyer un test.

Si quelqu’un supprime le webhook dans Discord, le destinataire devient Injoignable. Créez un nouveau webhook et collez la nouvelle URL.

Webhook Slack

1. Ouvrez api.slack.com/apps et choisissez Create New App, puis From scratch. Saisissez un nom et choisissez votre espace de travail.
2. Ouvrez Incoming Webhooks et activez-le.
3. Choisissez Add New Webhook to Workspace, choisissez le canal et autorisez l’accès.
4. Copiez l’URL. Elle commence par https://hooks.slack.com/services/.
5. Dans le Watchdog, choisissez Ajouter un destinataire, puis Webhook Slack, collez l’URL, enregistrez et appuyez sur Envoyer un test.

Les webhooks de workflow, dont l’URL contient /triggers/, ne sont pas pris en charge. Utilisez un Incoming Webhook.

Un destinataire marqué Destinataire par défaut reçoit les alertes de toutes les watches qui utilisent les destinataires par défaut. Votre premier destinataire Telegram, Discord ou e-mail devient automatiquement destinataire par défaut ; ce n’est pas le cas des webhooks et des groupes.

Dans la section 4. Destinataires de l’éditeur de watch, vous choisissez :

• Utiliser les destinataires par défaut : la watch atteint la cloche et tous les destinataires par défaut.
• Votre propre sélection : décochez Utiliser les destinataires par défaut et cochez les destinataires de cette watch. Seuls les destinataires actifs peuvent être cochés.
• Destinataires différents selon le groupe de signaux : envoyez certains groupes ailleurs, par exemple les alertes FDC uniquement au groupe Telegram de votre équipe. Cette option apparaît pour les types de watch comportant plusieurs groupes de signaux, comme la Provider Watch.

Exemple : vous avez un destinataire e-mail par défaut et un groupe Telegram pour votre équipe. Pour votre Provider Watch, vous gardez les destinataires par défaut et vous attribuez les groupes FDC et Infractions au groupe Telegram. Les alertes FDC et Infractions parviennent désormais à l’équipe, et tout le reste continue d’arriver sur votre e-mail.

Si une watch n’atteint personne, l’éditeur affiche « Cette surveillance ne joint actuellement personne. »

Un destinataire devient Injoignable lorsque la cible refuse durablement la livraison. C’est le cas par exemple d’un bot bloqué, d’un groupe supprimé ou d’un webhook Discord ou Slack supprimé. Les alertes vers ce destinataire échouent alors, et l’Historique des alertes affiche l’erreur.

1. Ouvrez l’Historique des alertes, filtrez sur Échecs uniquement et ouvrez l’alerte la plus récente. La ligne de livraison de ce destinataire affiche l’erreur.
2. Corrigez la cause : débloquez le bot, ajoutez-le de nouveau au groupe ou créez une nouvelle URL de webhook.
3. Appuyez sur Envoyer un test. Un test réussi efface le statut.
4. Si la cible a définitivement disparu, supprimez le destinataire. La boîte de dialogue indique combien de watches sont concernées.

• Notifications dans l’application: Chaque alerte apparaît dans votre cloche de notifications sur ftso.app. Les alertes continuent d’arriver pendant les heures calmes.
• Webhook: POST JSON signé HMAC vers votre propre point de terminaison https — pour bots et intégrations. Les alertes continuent d’arriver pendant les heures calmes.
• Telegram: Alertes en message direct du bot FTSOBest Watchdog. Les alertes sont retenues pendant les heures calmes.
• Groupe Telegram: Alertes visibles par tous les membres d'un groupe Telegram. Les alertes continuent d’arriver pendant les heures calmes.
• Discord: Alertes en message direct du bot FTSOBest Watchdog sur notre Discord. Les alertes sont retenues pendant les heures calmes.
• E-mail: Alertes par e-mail à une adresse que vous confirmez une fois. Les alertes sont retenues pendant les heures calmes.
• Webhook Discord: Publie les alertes dans un salon de votre propre serveur Discord via son URL de webhook. Les alertes continuent d’arriver pendant les heures calmes.
• Webhook Slack: Publie les alertes dans un canal de votre espace de travail Slack via une URL de webhook entrant. Les alertes continuent d’arriver pendant les heures calmes.