Votre serveur

Clés et secrets

La clé de l’App est publique ; le secret de signature, la clé CLI et le secret d’écoute restent privés.

Mis à jour le 28 octobre 2026

Chaque App reçoit une clé publique à sa création. Le secret de signature n’existe qu’une fois le webhook créé, la clé CLI qu’une fois créée. Seule la clé de l’App peut apparaître dans le code de votre site ou de votre application.

Nom	Où il sert	Description
Clé de l’App	appKey	Publique. Elle désigne votre App dans le code d’installation et les SDK. Elle est dans Paramètres de l’App > Général et ne change pas.
Secret de signature	HMAC-SHA256	Secret. Il signe chaque appel du webhook. Créé avec la première adresse de webhook. Voir Vérifier la signature d’un webhook.
Clé CLI	--key	Privée, de la forme `zk_cli_…`. Elle laisse la CLI Zean recevoir les événements de l’App sur votre ordinateur. Ce n’est jamais la clé de l’App. Voir Recevoir les webhooks sur votre ordinateur.
Secret d’écoute	HMAC-SHA256	Secret. Il signe les appels que la CLI Zean transmet, à la place du secret de signature. La CLI Zean l’affiche au démarrage. Il change seulement avec la clé CLI.

Identifier vos Contacts ne demande aucun secret : votre app passe au chat l’ID de la personne connectée. Voir Identifier vos Contacts.

Régénérer le secret de signature

Si le secret a pu fuiter, cliquez sur « Régénérer » dans Paramètres de l’App > Développeurs > Webhook, puis mettez à jour votre serveur juste après. Les appels du webhook sont signés avec le nouveau dès la régénération, nouveaux essais compris.

Créer ou régénérer la clé CLI

Ouvrez Paramètres de l’App > Développeurs > Webhook > « Clé CLI », puis choisissez « Créer une clé CLI ».
Copiez-la et gardez-la hors de votre code, par exemple dans la variable d’environnement ZEAN_CLI_KEY de votre ordinateur.
Si elle a pu fuiter, choisissez « Régénérer » et confirmez. Chaque CLI Zean en cours s’arrête aussitôt, et le secret d’écoute change : relancez la CLI Zean avec la nouvelle clé et mettez à jour le secret d’écoute de votre serveur de développement.

La section Développeurs est réservée aux Admins et au Propriétaire.