# Eventos

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. 🚀


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zapsign.com.br/espanol/webhooks/eventos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.