Eventos

Entiende los eventos enviados por los webhooks

ZapSign envía diferentes tipos de eventos a través de sus webhooks, permitiéndote recibir notificaciones automáticas sobre acciones importantes relacionadas con tus documentos.

• doc_created Este evento se envía cuando se crea un documento.

• created_signer Este evento se envía cuando se adiciona un nuevo firmante a un documento en curso.

• doc_deleted Notifica cuando un documento ha sido eliminado, ya sea desde la plataforma o a través de la API.

• doc_signed Se activa cuando un firmante firma el documento. En el webhook se especifíca cuál firmante firmo el documento.

• doc_refused Indica que un documento ha sido rechazado por el firmante.

• email_bounce Notifica sobre fallos en la entrega de correos electrónicos.

• signature_notification_sent Notifica cuando se envia el documento al firmante por correo o WhatsApp (parámetro send_automatic_email o send_automatic_whatsapp)

• doc_viewed Notifica cuando el firmante visualizo el documento (abre el link de firma)

• doc_read_confirmation Notifica cuando el firmante confirma la lectura del documento (botón Continuar después de visualizar el documento).

• signer_authentication_failed Notifica cuando el firmante excedio la cantidad máxima de intentos para validar su identidad por medio de los métodos Reconocimiento facial y Validación de Identidad.

• background_check_completed Notifica cuando una consulta de antecedentes ha finalizado.

• doc_expired Este evento se envía cuando un documento con fecha límite para firma ha expirado.

• doc_expiration_alert Este evento se envía cuando un documento con fecha límite para firma está a punto de expirar. El evento se disparará 7, 3 y 1 día antes de que se haga efectiva la expiración.

¿Cómo diferenciar los eventos?

Cada webhook incluye el atributo event_type, que especifica el tipo de evento asociado. Este atributo te permitirá identificar fácilmente qué acción disparó el webhook. Por ejemplo:

"event_type": "doc_created"

En los próximos capítulos exploraremos en profundidad el contenido de cada evento, para que puedas aprovechar al máximo estas notificaciones automáticas. 🚀