Webhooks d'application

Ce webhook est reçu lorsqu'un événement lié à votre application est déclenché.

attention

Seuls les endpoints configurés avec l'appEnv PRODUCTION recevront ce type d'événements.

L'objet global reçu - [type : IgnisignWebhook_ActionDto]

C'est l'objet global qui est POST à votre application lorsqu'un événement webhook est déclenché.

champ	type	requis	description
topic	String	Oui	Valeur fixe : "APPLICATION"
action	IGNISIGN_WEBHOOK_ACTION_APPLICATION	Oui	L'action associée à l'événement webhook
msgNature	IGNISIGN_WEBHOOK_MESSAGE_NATURE	Oui	Le type de message
content	IgnisignWebhookDto_Application	Non	Le contenu du webhook
error	IgnisignError	Non	L'erreur éventuelle
appId	string	Oui	L'appId associé à l'événement
appEnv	IGNISIGN_APPLICATION_ENV	Oui	L'appEnv associé à l'événement
verificationToken	string	Oui	Un token qui peut être utilisé pour vérifier que le webhook provient d'ignisign

Les SDKs traitent automatiquement ces appels et vous fournissent un mécanisme d'enregistrement de callback pour les événements typés.

Lorsque vous utilisez les SDKs :

• Le verificationToken est automatiquement vérifié.
• L'appId et l'appEnv sont automatiquement vérifiés.
• Seuls topic, action, msgNature, content et error sont disponibles dans les callbacks.

L'objet Content : [type: IgnisignWebhookDto_Application ]

champ	type	requis	description
userId	string	Non	Fourni uniquement lorsque l'action est MEMBERSHIP_UPDATED.

L'objet Error : [type: IgnisignError]

champ	type	requis	description
errorCode	IGNISIGN_ERROR_CODES	oui	Le code d'erreur
message	string	non	Un message lisible décrivant l'erreur
context	object (any)	non	Une carte de paires clé-valeur fournissant un contexte supplémentaire à l'erreur

Énumérations associées :

• IGNISIGN_WEBHOOK_ACTION_APPLICATION :

  • SETTINGS_UPDATED : Un changement a été apporté aux paramètres de l'application
  • MEMBERSHIP_UPDATED : Un changement a été apporté à l'adhésion de l'application
  • ARCHIVED : L'application a été archivée

• IGNISIGN_WEBHOOK_MESSAGE_NATURE: Représente la nature ou le type d'un message associé à un événement webhook dans l'application Ignisign.

  • INFO : Le message est fourni pour donner des informations (par exemple, une mise à jour de statut)
  • SUCCESS : Le message est lié à un succès (par exemple, une session de signature est terminée)
  • WARNING : Le message est lié à un avertissement (une action est terminée mais avec quelques avertissements)
  • ERROR : Le message est lié à une erreur (une action a échoué)