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.
Pour quelles notes
Section titled “Pour quelles notes”- 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), ouespace(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.
Les événements
Section titled “Les événements”| É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.
Le délai de cinq minutes
Section titled “Le délai de cinq minutes”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.
Le format d’un appel
Section titled “Le format d’un appel”POST <votre adresse>content-type: application/jsonuser-agent: Kalepin-Webhooks/1webhook-id: 6f3c… (l'identifiant de l'envoi, stable entre les relances)webhook-timestamp: 1795300000webhook-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).