Neuf canaux, et une grille.

Deux systèmes différents partagent le mot « notification », et les confondre coûte un après-midi. Les canaux sont ce qu’un moniteur ou une automatisation déclenche. Les préférences sont ce que la plateforme vous dit. Cette page les sépare.

partage ▸ deux systèmes

Duquel parlez-vous ?

Les deux vivent dans les réglages, les deux disent « notifications », et ils ne partagent pas la même liste de canaux. Commencez ici :

canaux ▸ neuf

Configurer un canal.

Configurez chacun une fois pour l’organisation, puis ajoutez-y des destinataires. Chaque canal a un envoi de test.

destinataires ▸ channel:id

Désigner qui joindre.

Une fois qu’un canal a des destinataires, une automatisation y fait référence par des chaînes "channel:id" — par exemple ["pushover:1","email:3"]. Un seul appel liste tous les destinataires de tous les canaux, chacun avec son identifiant masqué, et c’est ce qu’affiche un sélecteur.

{
  "channels": ["pushover", "email"],
  "recipients": ["pushover:1", "email:3"]
}

curl https://api.usewrit.app/api/notifications/recipients/all \
  -H "Authorization: Bearer $WRIT_API_KEY"

contrôles ▸ toute l’organisation

Contrôles de livraison.

Ils s’appliquent à toute l’organisation, pas par canal — pour qu’une nuit agitée ne devienne pas cent messages :

placeholders ▸ alertes de changement

Ce que vous pouvez mettre dans le message.

Les notifications de changement injectent ces placeholders dans votre modèle de message. Regroupés par la question à laquelle ils répondent :

relais ▸ depuis un appareil

Un appareil relié qui passe la main au cloud.

Un appareil exécute les automatisations en local, mais certains canaux ont besoin du cloud pour livrer. Seuls e-mail, pushover, SMS, WhatsApp et Signal passent par le relais ; webhook, Slack, Discord et Telegram sont livrés par l’appareil lui-même, puisqu’il peut les joindre directement.

curl -X POST https://api.usewrit.app/api/notifications/relay \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channels": ["email", "pushover"],
    "recipients": ["email:3", "pushover:1"],
    "title": "Price dropped",
    "message": "Now $41.00, was $49.00.",
    "url": "https://example.com/product/42"
  }'

préférences ▸ l’autre grille

Préférences de notification de la plateforme.

Voici le second système : ce que Writ vous dit, par utilisateur, sur GET et PUT /api/notifications/preferences. Autre jeu de canaux, autre finalité.

Six canaux

Pas les mêmes neuf que plus haut :

Sept catégories

Les événements sont regroupés pour raisonner sans lire chaque ligne :

Quatre règles qui surprennent

1. La grille est creuse. Seuls les canaux qu’un événement propose vraiment sont affichés — une case vide n’est pas un réglage qui vous manque.
2. Certaines cases sont verrouillées et toujours actives : alertes de sécurité, problèmes de paiement et invitations d’équipe. L’API n’enregistre aucune dérogation pour celles-là.
3. Certains événements sont volontairement en e-mail uniquement.
4. Les alertes de changement par moniteur vivent délibérément hors de cette grille, avec leurs propres réglages par cible.

référence ▸ suite

Continuer

faq

Questions notifications, répondues.

fin ▸ câbler

Envoyez-vous un test.

Configurez un canal, ajoutez un destinataire, et déclenchez l’envoi de test avant d’en avoir besoin.