Événements des webhooks

Chaque message contient type, timestamp (ISO 8601) et data. data.workspace est l’identifiant court de l’espace. Les montants sont en centimes de CHF, les dates au format ISO 8601.

Événement	Quand	Champs de data
invoice.issued	Une facture est émise	invoice_id, number, total, currency, project_id, project_name
invoice.paid	Une facture est marquée payée, ou payée en ligne	invoice_id, number, total, currency, online
signature.completed	Un client signe ou refuse un document	request_id, status (signed, declined), document_title, document_sha256, qualified, project_id, project_name
request.created	Un client fait une demande	request_id, title, project_id, project_name
action.submitted	Un client rend une action	action_id, title, project_id, project_name
meeting.scheduled	Une réunion est planifiée	meeting_id, title, starts_at, duration_minutes, project_id, project_name
prospect.created	Un prospect est ajouté à la main, ou reçu d’un formulaire	à la main : prospect_id, company, contact_name, email, source ; formulaire : count, source
project.created	Un projet est créé	project_id, name, client_id, client_name

qualified vaut true pour une signature qualifiée chez Skribble.

En-têtes

En-tête	Contenu
webhook-id	msg_…, le même à chaque essai et au renvoi
webhook-timestamp	Secondes depuis 1970, renouvelé à chaque essai
webhook-signature	v1,<base64> : HMAC-SHA256 de <webhook-id>.<webhook-timestamp>.<corps>
content-type	application/json

Limites

Webhooks par espace	20
Délai de réponse	10 secondes
Essais	8, sur environ 28 heures
Journal	30 jours
Adresse	https, port 443, nom public, pas de redirection