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.
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 | 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:
- Si validó su identidad por ARCA (ex-AFIP), se muestra el nombre registrado en ARCA.
- Si no validó por ARCA pero sí por biometría, se muestra el nombre que figura en su documento de identidad.
- Si no validó por ninguno de esos medios, se muestra su email o, si no tiene, su teléfono.
- 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. 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, 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.