Skip to content

Les 14 événements

Un webhook se règle dans Paramètres > Connecteurs > Webhooks (bureau) : une adresse https, un périmètre, des événements, et un jeton si votre récepteur en veut un. Kalepin y envoie un POST JSON signé à chaque événement.

  • Seulement les vôtres. Un webhook appartient à une personne, qui ne reçoit que les notes dont elle est l’auteur, y compris dans un espace partagé.
  • Périmètre : tout (toutes vos notes), prive (« Mes notes » seulement), ou espace (un espace dont vous êtes membre). Une note d’espace ne part que si vous en êtes encore membre au moment de l’envoi.
  • Au plus 10 webhooks par personne.
Événement Quand data
enregistrement.termine La première fois qu’un enregistrement est marqué terminé, avant la transcription recording, note (ou null)
transcription.prete Quand chaque enregistrement envoyé a sa transcription finale (ou l’a ratée, remplacée par celle du direct) note, recordings[], text
compte_rendu.redige Quand Kalepin écrit le compte rendu, sa réécriture avec la transcription finale, ou les noms des voix note avec content, version, minutes, trame, steps[]
note.creee À la première sauvegarde d’une note, une fois par note note avec content, steps[]
note.modifiee Le texte ou le titre a changé — une seule fois, 5 minutes après la dernière modification note avec content à jour, steps[]
note.archivee, note.desarchivee Au changement d’archivage note
note.supprimee À la suppression par une personne (pas par la conservation) note sans contenu
note.deplacee Quand l’espace ou le kalepin change note, from
kalepin.cree Création d’un kalepin, y compris par Kalepin ou le MCP folder, spaceName
kalepin.modifie Renommage ou description changée folder, previous
kalepin.archive, kalepin.desarchive Au changement d’archivage folder
kalepin.supprime À la suppression : ses notes restent dans leur espace et ne donnent aucun événement folder

Le bouton « Envoyer un test » envoie un webhook.test avec data: {} : c’est le moyen le plus rapide de vérifier une adresse, une signature et un jeton.

L’application enregistre à chaque frappe : un envoi par sauvegarde noierait votre récepteur. note.modifiee part donc une seule fois, cinq minutes après la dernière modification. Chaque nouvelle frappe repousse l’envoi, qui garde le même webhook-id jusqu’au départ.

Ce que Kalepin écrit lui-même — le compte rendu, les noms des voix — n’est pas une modification de note : c’est compte_rendu.redige.

POST <votre adresse>
content-type: application/json
user-agent: Kalepin-Webhooks/1
webhook-id: 6f3c… (l'identifiant de l'envoi, stable entre les relances)
webhook-timestamp: 1795300000
webhook-signature: v1,<base64>
authorization: Bearer <votre jeton> (seulement si vous en avez donné un)
{
"id": "6f3c…",
"type": "note.creee",
"createdAt": "2026-11-21T10:12:00.000Z",
"data": {
"note": { "id": "…", "title": "…", "folderId": "…", "spaceId": null },
"steps": []
}
}

Les formes sont les mêmes que celles de l’API publique et des outils MCP : une note, un kalepin, un compte rendu ont la même allure partout. Les corps des événements kalepin.* portent en plus le nom de l’espace (spaceName).