En HubSpot el documento firmable aparece casi siempre en el mismo punto: una cotización aceptada que se convierte en contrato, o un negocio que llega a la etapa de cierre y necesita respaldo formal. Hasta ahí todo ocurre dentro del CRM. El problema empieza después, cuando el contrato sale por correo, vuelve escaneado, alguien lo guarda en una carpeta compartida y el negocio queda marcado como ganado sin que el documento firmado esté en ningún lugar consultable.
Conectar la firma electrónica a HubSpot resuelve ese hueco, pero exige aceptar algo primero: HubSpot es excelente para gestionar la relación comercial y no está pensado para custodiar documentos con valor probatorio a diez años.
Qué guarda HubSpot y qué conviene guardar afuera
La plataforma permite adjuntar archivos a negocios y contactos, y para consulta cotidiana eso alcanza. Lo que no ofrece es lo que un área legal pide cuando hay un reclamo: retención definida, control de quién descargó qué y garantía de que el archivo no fue reemplazado.
El reparto sensato queda así:
- En HubSpot: el estado del proceso de firma, las fechas, el responsable, el enlace al documento y su hash. Es lo que el equipo comercial necesita ver sin salir de la ficha del negocio.
- En el repositorio documental: el binario firmado, con su política de retención y su control de acceso. La discusión sobre bibliotecas y versionado está en firma electrónica con SharePoint y OneDrive.
Guardar el hash en una propiedad del negocio parece un detalle menor y no lo es: es lo que permite demostrar, meses después, que el archivo que está en la carpeta es exactamente el que se firmó.
Aplicaciones privadas, permisos y límites de tasa
La integración se construye sobre una aplicación privada de la cuenta, con permisos acotados a lo que realmente necesita: leer negocios, escribir propiedades, adjuntar archivos. No hace falta acceso a marketing, ni a la bandeja de correo, ni a los informes. Cada permiso de más es superficie de riesgo sin beneficio.
Dos consideraciones operativas que suelen pasarse por alto:
- Límites de tasa: una carga inicial que recorre miles de negocios para calcular estados agota el cupo de peticiones y deja al resto de integraciones sin servicio. Ese tipo de procesos se ejecuta por lotes y en horario de baja actividad.
- Rotación del token: hay que tener previsto cómo se rota sin apagar la integración, y una alerta que avise cuando las llamadas empiezan a fallar por autenticación.
Modelar el estado con propiedades, no con notas
La forma más rápida de perder trazabilidad es dejar el estado de la firma en notas de texto libre. Con propiedades personalizadas, en cambio, se pueden armar vistas, informes y automatizaciones. Un conjunto mínimo que funciona:
| Propiedad | Tipo | Para qué sirve |
|---|---|---|
| Estado de firma | Lista de opciones | Filtrar negocios detenidos y medir el ciclo |
| Fecha de envío a firma | Fecha | Calcular días de espera y disparar recordatorios |
| Firmante previsto | Texto o referencia a contacto | Saber a quién reclamar sin abrir el documento |
| Identificador de la solicitud | Texto | Conciliar con el servicio de firma ante cualquier duda |
| Hash del documento firmado | Texto | Verificar después que el archivo no fue alterado |
| Motivo del último error | Texto | Diagnosticar sin revisar registros técnicos |
Con esas propiedades, la pregunta "¿cuántas propuestas llevan más de cinco días esperando firma?" se responde con una vista guardada, y el recordatorio automático deja de depender de que alguien se acuerde.
Workflows con código o middleware: dónde poner la lógica
HubSpot permite ejecutar acciones de código dentro de un workflow, y para tareas cortas es cómodo. La pregunta es cuánta lógica conviene alojar ahí. Un criterio simple:
- Dentro del workflow: disparar la solicitud, actualizar propiedades, enviar la notificación interna. Operaciones breves y sin manejo de binarios pesados.
- Fuera, en un servicio propio: la generación del documento definitivo, la operación de firma, los reintentos, la verificación posterior y el archivado. Todo lo que necesita estado y política de error.
El motivo no es técnico solamente: la lógica dentro de un workflow es difícil de versionar y cualquier persona con permisos de administración puede modificarla sin dejar rastro claro. Para procesos que producen documentos con efectos legales, esa falta de control termina siendo un problema de auditoría. La arquitectura de referencia está en cómo integrar una API de firma electrónica.
Dos direcciones de notificación
En este tipo de integración hay eventos que viajan en los dos sentidos y conviene no mezclarlos:
- De HubSpot hacia afuera: el negocio cambió de etapa, la cotización fue aceptada, se actualizó una propiedad. Son el disparador del proceso de firma.
- Hacia HubSpot: el documento fue firmado, rechazado o expiró. Actualizan el estado y adjuntan el resultado.
El segundo grupo debe llegar a un punto de entrada propio, con verificación de origen y tratamiento idempotente: recibir dos veces el mismo aviso no puede generar dos adjuntos ni dos correos al cliente. Los detalles están en webhooks de firma electrónica.
Un cuidado adicional: los eventos de cambio de propiedad se disparan también cuando la propia integración escribe. Sin un filtro, se arma un bucle en el que cada actualización genera un nuevo evento que genera otra actualización.
De la cotización firmada a la facturación
El contrato firmado suele ser el paso previo a emitir el comprobante. Vale aclarar la diferencia, porque en Ecuador se confunden: la firma del contrato es un acto entre las partes, mientras que el comprobante electrónico se firma sobre un XML con formato definido por la administración tributaria y necesita autorización del organismo. Son procesos distintos, con formatos distintos y momentos distintos.
Para la parte tributaria, el grupo ofrece Azur, facturación electrónica autorizada por el SRI, que resuelve el ciclo del comprobante desde la emisión hasta la entrega: azur.com.ec. El panorama general de ambos procesos está en firma electrónica y factura electrónica para empresas.
Qué no conviene automatizar
La automatización total es tentadora y no siempre es buena idea. Tres casos donde conviene dejar un paso humano:
- Contratos con clausulado negociado. Si el texto cambió respecto de la plantilla, alguien tiene que confirmar que la versión enviada a firma es la acordada.
- Montos por encima de un umbral. El circuito de aprobación previo importa más que la velocidad; el criterio está en firma electrónica en flujos de documentos.
- Clientes nuevos sin verificación de identidad. Firmar rápido un contrato con una contraparte no verificada no acelera nada: crea un problema para cobranzas.
Certificados para el equipo comercial
Una duda recurrente: si todo el equipo comercial necesita certificado. Casi nunca. Quien firma el contrato es la persona con facultad para obligar a la compañía, no quien lo gestiona. El resto interviene dentro del CRM sin certificado propio. El criterio de asignación está desarrollado en cuántas firmas electrónicas necesita tu empresa.
Firmas.com.ec emite certificados con trámite 100% en línea y entrega en aproximadamente 30 minutos, en archivo .p12, token USB o firma en la nube, con validez legal y ante el SRI. Consulta el precio actualizado en la página de precios. Si el proceso incluye firma desatendida desde el CRM, la modalidad en la nube es la que corresponde evaluar, comparada en nube, .p12 o token.
La conversación que acompaña al contrato
El grupo también desarrolla Omnifox, una plataforma omnicanal que reúne WhatsApp, correo, redes sociales y llamadas en una sola bandeja compartida. Mientras el documento espera firma, el seguimiento real ocurre por WhatsApp y suele quedar en el celular de un vendedor. Con historial por contacto, asignación por responsable y métricas de respuesta, ese tramo del proceso queda registrado y no se pierde cuando alguien cambia de rol. Más información en omnifox.io.
Preguntas frecuentes
¿Puedo disparar la firma desde un workflow sin escribir código?
Sí, mediante un orquestador que reciba el evento y hable con el servicio de firma; el enfoque está descrito en firma electrónica con Make. Para volumen alto o trazabilidad detallada, un servicio propio da más control.
¿Dónde queda el documento firmado si el negocio se elimina?
Por eso el binario no debe vivir solo en el CRM. Si el archivo está en el repositorio documental con su política de retención, borrar el negocio no borra la evidencia.
¿La firma electrónica ecuatoriana funciona con contrapartes en el exterior?
El certificado identifica al titular y el documento firmado se puede verificar desde cualquier lugar. El reconocimiento legal en el país de la contraparte depende de su propia normativa, y eso conviene revisarlo con asesoría legal antes de estandarizar el proceso.
¿Cómo evito que la integración dispare eventos en bucle?
Filtrando los cambios generados por la propia cuenta de la integración y usando una propiedad de control que indique qué actualización proviene del proceso automático.
¿Sirve para contratos con dos firmantes?
Sí, siempre que el modelo de datos contemple un registro por firmante y no una sola propiedad de estado. Con una sola propiedad no se puede saber quién falta.
Si tu operación comercial vive en HubSpot y quieres cerrar el ciclo con firma electrónica válida en Ecuador, conversa con un asesor corporativo de Firmas.com.ec. Solicita tu cotización corporativa.