# Eventos de Signatura en el timeline de HubSpot > Conozca qué eventos registra Signatura en el timeline de HubSpot, cuándo se generan, qué muestran y qué propiedades puede usar para filtrar. Fuente: https://help.signatura.co/articulos/integraciones/eventos-de-signatura-en-hubspot Cada documento que envía desde HubSpot deja constancia de su avance en el **timeline** del contacto, la empresa, el negocio o el ticket desde el que lo creó. Así, su equipo puede ver junto al resto de la actividad del cliente cuándo se envió un documento, quién lo firmó y cómo terminó, sin abrir Signatura. Signatura registra dos tipos de evento: - **Estado del documento**: un evento cada vez que el documento cambia de estado (enviado, firmado, cancelado o vencido). - **Estado de la firma**: un evento cada vez que un firmante completa o rechaza su firma. En el encabezado de cada evento, el título del documento es un enlace a su detalle en Signatura. Para abrirlo necesita un usuario de Signatura con acceso al espacio. ### Qué documentos generan eventos Solo generan eventos los documentos creados desde la tarjeta **Signatura** de un registro de HubSpot. Los eventos se registran únicamente en ese registro: si envió el documento desde un negocio, aparecen en el timeline del negocio, no en el de sus contactos asociados. Los documentos creados desde Signatura o por API no generan eventos en HubSpot. ### Estado del documento Se registra cuando el documento cambia de estado. El encabezado describe el cambio y el detalle agrega información según el estado. | Estado | Cuándo se registra | Encabezado | Detalle | | ------------------ | ----------------------------------------- | ---------------------------- | ------------------------------------------------------------ | | Enviado para firma | Al crear el documento desde HubSpot | Se envió para firma _Título_ | Cantidad de firmantes y fecha de vencimiento, si tiene | | Firmado | Cuando se completan todas las firmas | Se firmó _Título_ | Firmas completadas sobre el total | | Cancelado | Cuando se cancela el documento | Se canceló _Título_ | Firmas completadas sobre el total y motivo de la cancelación | | Vencido | Cuando el documento vence sin completarse | Venció _Título_ | Firmas completadas sobre el total | Por ejemplo, un documento con dos firmantes que vence cuando solo firmó uno muestra **Venció** _Contrato de servicios_ y, en el detalle, **Firmas: 1 de 2**. Si nadie llegó a firmar, el detalle muestra la cantidad de firmantes, por ejemplo **Firmantes: 2**. Cada evento lleva la fecha del cambio: el envío, la última firma, la cancelación o el vencimiento. #### Propiedades | Propiedad | Nombre interno | Tipo | Contenido | | ---------------------- | ------------------------- | ----------------- | ------------------------------------------------------------------------------------------------- | | ID del documento | `documentId` | Texto | Identificador del documento en Signatura | | Título del documento | `documentTitle` | Texto | Título que se le dio al documento al crearlo | | Estado | `status` | Lista de opciones | `sent` (Enviado para firma), `completed` (Firmado), `cancelled` (Cancelado) o `expired` (Vencido) | | Descripción del estado | `statusLabel` | Texto | El texto del encabezado, por ejemplo "Se envió para firma" | | Fecha del cambio | `occurredAt` | Fecha | Momento en que ocurrió el cambio de estado | | Firmantes | `signatureCount` | Número | Cantidad de firmantes del documento | | Firmas completadas | `completedSignatureCount` | Número | Cantidad de firmantes que ya firmaron. No se informa en el envío | | Vence el | `expiresAt` | Fecha | Fecha de vencimiento. Solo en el envío, si el documento tiene vencimiento | | Motivo | `reason` | Texto | Motivo de la cancelación. Vacío en los demás estados | Los firmantes reemplazados al invalidar una firma no cuentan en **Firmantes** ni en **Firmas completadas**. ### Estado de la firma Se registra cada vez que un firmante completa su firma o la rechaza. Un documento con tres firmantes genera, si todos firman, tres eventos de este tipo, además del evento **Firmado** del documento. | Estado | Cuándo se registra | Encabezado | Detalle | | --------- | ----------------------------------------------------------------------------------------- | ------------------------- | --------------------------------------------------------- | | Firmada | Cuando el firmante completa su firma | _Nombre_ firmó _Título_ | Datos de identificación del firmante | | Rechazada | Cuando el firmante [rechaza la firma](https://help.signatura.co/articulos/equipo/como-activar-el-rechazo-de-firma) | _Nombre_ rechazó _Título_ | Datos de identificación del firmante y motivo del rechazo | Por ejemplo: **Ana Pérez firmó** _Contrato de servicios_, y en el detalle, su CUIT validado por ARCA y **Correo: ana@ejemplo.com**. #### Cómo se identifica al firmante El nombre del encabezado sale de la validación de identidad que completó el firmante: 1. Si validó su identidad por ARCA (ex-AFIP), se muestra el nombre registrado en ARCA. 2. Si no validó por ARCA pero sí por biometría, se muestra el nombre que figura en su documento de identidad. 3. Si no validó por ninguno de esos medios, se muestra su email o, si no tiene, su teléfono. 4. Si no hay ningún dato, el encabezado dice **Se firmó** o **Se rechazó**, sin nombre. El CUIT y el número de documento solo se informan cuando la validación correspondiente fue exitosa. Si un firmante no superó la validación por ARCA o por biometría, esos datos quedan vacíos aunque los haya ingresado, para que el timeline nunca muestre una identidad que no se verificó. #### Propiedades | Propiedad | Nombre interno | Tipo | Contenido | | ---------------------- | ---------------- | ----------------- | ------------------------------------------------------ | | ID del documento | `documentId` | Texto | Identificador del documento en Signatura | | Título del documento | `documentTitle` | Texto | Título que se le dio al documento al crearlo | | Estado | `status` | Lista de opciones | `signed` (Firmada) o `declined` (Rechazada) | | Descripción del estado | `statusLabel` | Texto | El texto del encabezado, por ejemplo "Ana Pérez firmó" | | Fecha del cambio | `occurredAt` | Fecha | Momento de la firma o del rechazo | | Firmante | `signerName` | Texto | Nombre del firmante, según el orden descrito arriba | | Correo del firmante | `signerEmail` | Texto | Email del firmante, si tiene | | Teléfono del firmante | `signerPhone` | Texto | Teléfono del firmante, si tiene | | CUIT / CUIL | `signerCUIT` | Texto | CUIT o CUIL validado por ARCA | | Número de documento | `signerIdNumber` | Texto | Número de documento validado por biometría | | Motivo | `reason` | Texto | Motivo del rechazo. Vacío cuando el firmante firmó | ### Qué no se registra Para no llenar el timeline de actividad menor, Signatura no registra: - Reenvíos de invitaciones ni recordatorios automáticos. - Aperturas de la invitación o del documento. - Pasos intermedios de validación, como un código de email ingresado o un intento de biometría fallido. - El avance entre pasos de una [firma secuencial](https://help.signatura.co/articulos/configuraciones-avanzadas/firmas-secuenciales). Cada firma se registra cuando ocurre, sin importar el paso. Para ver ese nivel de detalle, abra el documento en Signatura. ### Cómo filtrar los eventos Los eventos aparecen en la pestaña **Actividades** del registro. En el filtro **Actividad**, se agrupan en **Integraciones** > **Signatura**: marque o desmarque esa opción para mostrarlos u ocultarlos. Si no ve ningún evento de Signatura en un documento enviado desde ese registro, revise primero que esa opción esté marcada. La propiedad **Estado** es una lista de opciones fijas, así que puede usarla para filtrar por resultado (por ejemplo, solo los documentos **Vencido** o las firmas **Rechazada**) en las herramientas de HubSpot que permiten trabajar con eventos de aplicaciones. Si arma filtros o automatizaciones, use **Estado** y no **Descripción del estado**: el texto de la descripción puede cambiar y, en las firmas, incluye el nombre de cada firmante. ### Consideraciones - Un documento firmado puede volver a quedar pendiente si se invalida una firma. Cuando se vuelve a completar, se registra un nuevo evento **Firmado**, así que un mismo documento puede tener más de uno. - La última firma y el evento **Firmado** del documento tienen la misma fecha, por lo que HubSpot puede mostrarlos en cualquier orden. - Los eventos se envían en segundo plano y pueden tardar unos segundos en aparecer. Si HubSpot no está disponible, Signatura reintenta el envío. - Si [desconecta el portal](https://help.signatura.co/articulos/integraciones/integracion-con-hubspot), los eventos ya registrados quedan en el timeline, pero no se registran nuevos. - Durante un período de transición, los registros también pueden mostrar eventos con los nombres **Documento enviado para firma**, **Firma completada** y **Documento firmado**. Son la versión anterior de estos eventos, con la misma información, y se van a dejar de registrar. Para filtros y automatizaciones nuevas, use **Estado del documento** y **Estado de la firma**.