Types de notifications

Zenhook dessine chaque type d’événement en widget, à partir de son propre historique. Rien à configurer : le payload que vous envoyez déjà décide du widget.

Un type d’événement est un flux : même canal et même titre, chiffres ignorés. « Commande 1284 payée » et « Commande 1285 payée » forment un seul flux. Gardez le titre stable et mettez ce qui change dans message, fields ou actor.

Quand un flux correspond à plusieurs types, le premier de cette liste l’emporte.

Pipeline

Quand: Le titre contient deploy, build, release, pipeline ou CI, ou l’événement porte un bloc workflow.
Affiche: Le dernier passage réussi ou échoué, les derniers passages en bande, et combien ont réussi.

Envoyer

json

{
  "title": "api deploy",
  "level": "success",
  "message": "v2.4.0"
}

Erreur

Quand: level vaut error et c’est arrivé au moins deux fois aujourd’hui ou cette semaine. Une erreur isolée reste une carte ouverte.
Affiche: Quelle occurrence du jour, depuis quand, les heures touchées, le message et votre lien.

Envoyer

json

{
  "title": "Échec du webhook de paiement",
  "level": "error",
  "message": "Signature Stripe invalide",
  "linkUrl": "https://…"
}

Argent

Quand: Un champ nommé Montant, Prix, Total, Amount, Price, Revenue, Paid, Payment ou MRR contient un montant.
Affiche: Le total du jour au format monétaire du lecteur, le nombre de paiements, et la semaine.

Envoyer

json

{
  "title": "Paiement reçu",
  "level": "success",
  "fields": [
    {
      "label": "Montant",
      "value": "49,00 €"
    }
  ]
}

Personne

Quand: L’événement a un actor (ou user).
Affiche: Qui, avec sa photo ou ses initiales, sa société et son offre, et combien aujourd’hui et cette semaine.

Envoyer

json

{
  "title": "Nouvelle inscription",
  "actor": {
    "name": "Jane Cooper",
    "email": "[email protected]"
  }
}

Série

Quand: Il arrive environ une fois par jour, trois fois au plus, trois jours d’affilée ou plus.
Affiche: Le nombre de jours d’affilée, et la semaine en coches.

Envoyer

json

{
  "title": "Sauvegarde nocturne",
  "level": "success"
}

Compteur

Quand: Le type par défaut de tout ce qui se répète : deux fois aujourd’hui ou trois fois cette semaine.
Affiche: Le nombre du jour, l’écart avec la veille à la même heure, des barres par heure et le pic.

Envoyer

json

{
  "title": "Rapport exporté",
  "message": "Chiffre d’affaires T3, CSV"
}

Carte ouverte

Quand: Un événement isolé, ou le premier de son type.
Affiche: Tout, sans clic : message, champs et lien.

Envoyer

json

{
  "title": "Domaine renouvelé",
  "message": "Renouvelé automatiquement pour un an.",
  "fields": [
    {
      "label": "Domaine",
      "value": "acme.com"
    }
  ]
}

Chaque champ est décrit dans la référence de l’API Webhook.