Artículos sobre: Manejador de Conversaciones

Nodo de documentos - Conversation Manager

El Nodo De Documentos es un paso dentro de los flujos de trabajo (workflows) del Conversation Manager que permite ejecutar operaciones documentales directamente en un flujo, sin necesidad de escribir código.


Estas mismas capacidades también pueden consumirse vía API, o integrarse en portales web y experiencias de chat, pero el nodo permite orquestarlas desde la interfaz visual del flujo.


Explicación rápida

El Nodo de Documentos permite ejecutar operaciones documentales directamente dentro de un flujo de Conversation Manager, sin necesidad de escribir código.


Desde este nodo se pueden realizar acciones como generar PDFs, indexar documentos, buscar documentos ya indexados, ejecutar OCR para extraer texto y firmar PDFs.


Los tipos de documento y sus etiquetas se configuran previamente en Document Manager. Luego, desde el nodo, esas configuraciones pueden usarse para guardar, consultar, procesar o firmar documentos como parte de una automatización.


Esta funcionalidad es útil cuando se necesita incorporar gestión documental dentro del recorrido del cliente, por ejemplo después de recibir un archivo, generar un comprobante, validar información, recuperar un documento existente o dejar evidencia firmada dentro del flujo.


Nodo de Documentos del Conversation Manager

El Nodo de Documentos es un paso dentro de los flujos de trabajo (workflows) del Conversation Manager que permite ejecutar operaciones documentales directamente en un flujo, sin necesidad de escribir código.



Estas mismas capacidades también pueden consumirse vía API, o integrarse en portales web y experiencias de chat, pero el nodo permite orquestarlas desde la interfaz visual del flujo.


Qué habilita

Con el Nodo de Documentos puedes:


El objetivo es reducir fricción para:

  • Usuarios de negocio, que pueden operar con configuración visual.
  • Usuarios técnicos, que mantienen gobernanza mediante configuración del Document Manager y APIs.


Operaciones disponibles

El nodo incluye cuatro operaciones (según el selector de operación):

  1. Indexing (Indexación)
  2. Searching / Búsqueda (Búsqueda)
  3. Sign PDF (Firmar PDF)
  4. OCR (Extracción de texto OCR-AI)
  5. Generar PDF



Conceptos clave: Document Manager, Tipos de Documento y Etiquetas

Los Tipos de Documento que aparecen en el nodo (para indexación y búsqueda) se configuran en el módulo Document Manager, donde se definen:

  • Los Tipos de Documento (por ejemplo: Billing, Carta Buró, Cuenta Ahorro, etc.).
  • Sus Campos de filtro (Etiquetas).



Al seleccionar un Tipo de Documento en el nodo, se habilita la lista de Etiquetas disponibles para realizar la Indexación o la Búsqueda.


Regla operativa: para poder ejecutar una Búsqueda, el documento debe haber sido Indexado previamente usando ese tipo de documento y sus etiquetas.


Cómo configurar un paso del nodo (Estructura general)

En el editor del nodo verás:

  • Nombre del paso: nombre descriptivo dentro del flujo.
  • Tipo de Operación: Indexing / Búsqueda / Sign PDF / OCR.
  • Tipo de Documento: aplica a operaciones que dependen de tipos configurados en Document Manager (principalmente Indexing y Búsqueda).
  • Tipo de Servicio: puede aparecer según configuración del Document Manager.
  • Pestañas internas por operación (por ejemplo: “Búsqueda” y “Configuración”).


Operación: Indexación (Indexing)

Para qué sirve

Permite cargar e indexar documentos asociándolos a un Tipo de Documento y a Etiquetas (campos de filtro).
Esto habilita que el documento pueda recuperarse después desde interfaz, API, portales web o chat, sin depender de desarrollos a medida en cada caso.


Qué se configura

La pantalla de Indexación permite:

  • Seleccionar Tipo de Documento y, cuando aplique, Tipo de Servicio.
  • Completar los Filtros / Etiquetas disponibles (por ejemplo DNI, ID, caseId, etc.).
  • Adjuntar uno o varios archivos, según el límite configurado.
  • Definir opciones como Modo estricto y ZIP (cuando estén disponibles).


Modo estricto y ZIP

  • Modo estricto: si alguno de los documentos falla, no se indexa ninguno.
  • ZIP: permite empaquetar múltiples documentos como salida (cuando aplica al flujo/caso).



Recomendaciones

  • Indexa siempre con una etiqueta “ancla” (por ejemplo DNI o caseId) para facilitar búsquedas posteriores.
  • Usa valores dinámicos con variables en formato DANAconnect: $s{variableName}.


Operación: Búsqueda (Searching)

Para qué sirve

Permite buscar documentos ya indexados dentro del flujo usando:

  • Tipo de Documento, y
  • Etiquetas (pares clave/valor) definidas para ese tipo de documento.


Configuración (Paso a paso)

  1. En Tipo de Operación, selecciona Búsqueda.
  2. En Tipo de Documento, selecciona el tipo donde esperas encontrar el documento (o TODOS si necesitas una búsqueda más amplia).
  3. Haz clic en Agregar Etiqueta.
  4. Completa cada fila:
    • Clave: etiqueta disponible para ese tipo de documento.
    • Valor: valor a buscar (puede ser fijo o una variable $s{...}).
  6. Selecciona el Operador:
    • Y (AND): deben coincidir todas las etiquetas (recomendado para precisión).
    • O (OR): coincide cualquiera de las etiquetas (útil para alternativas).




Recomendaciones

  • Selecciona primero Tipo de Documento para ver etiquetas disponibles.
  • Usa Y como estándar para evitar resultados inesperados.
  • Usa TODOS solo en búsquedas exploratorias o cuando no conoces el tipo.


Operación: Firmar PDF (Sign PDF)

Para qué sirve

Permite firmar un PDF dentro del flujo, agregando una marca/huella (hash) visible y opcionalmente un Código QR, con control de ubicación y página.

Configuración (Campos)

  • Etiqueta de Archivo (FileLabel): identifica el PDF a firmar.

Recomendación: usar una variable, por ejemplo $s{pdfToSign}.

  • Alineación del hash:
    • Horizontal: Izquierda / Centro / Derecha
    • Vertical: Arriba / Centro / Abajo
  • Incluir Código QR: activa o desactiva el QR.
  • Página: define dónde se coloca la firma (ej. “Primera”).
  • Información (3–255 caracteres): texto asociado a la firma.


Ejemplos de “Información” (Con variables)

  • Firmado en $s{dateTime} por $s{fullname}. Proceso: $s{processName}.
  • Solicitud $s{requestId} – Cliente $s{customerId}. Caso: $s{caseId}.


Operación: OCR (Extracción de texto)

Para qué sirve

Extrae texto de un archivo (PDF/imagen) dentro del flujo usando OCR-AI (por ejemplo Textract) para validar, automatizar decisiones, o alimentar otros pasos.

Configuración (Campos)

  • File Tag (FileLabel): archivo a procesar por OCR (idealmente variable, ej. $s{fileToRead}).
  • Engine Type: motor OCR (en la interfaz se muestra Textract).
  • Output Format:
    • Texto simple: texto corrido.
    • Bloques: texto segmentado por bloques.
    • Bloques con confianza: bloques + confianza por bloque.
    • Bloques con confianza global: bloques + métricas de confianza global.

Recomendaciones

  • Si necesitas solo el texto para validar o guardar, usa Texto simple.
  • Si necesitas trazabilidad por calidad, usa Bloques con confianza.


Operación: Generar PDF (Generate PDF)

Para Qué Sirve

Permite crear un documento PDF directamente dentro del flujo a partir de:

  • Contenido HTML (modo código o editor visual),
  • Una Plantilla (Template),
  • Variables del flujo mediante Insert Label (por ejemplo: $s{nombre_cliente}, $s{caseId}, etc.).


Esto es útil para generar comprobantes, constancias, formularios o resúmenes, sin depender de un servicio externo.


Configuración Básica

  1. En Tipo De Operación, selecciona Generate PDF.
  2. Define el contenido del documento:
  3. HTML: edita el HTML directamente.
  4. Editor visual: redacta y da formato con la barra de herramientas.
  5. Template: selecciona una plantilla existente (si aplica).nserta datos dinámicos con Insert Label (variables $s{...}).
  6. Selecciona el PDF Engine: Playwright, OpenHTMLtoPDF, Flying Saucer, iText pdfHTML.


Manejo de errores del Nodo (Filtros en el paso siguiente)

Después de ejecutar el Nodo de Documentos, el siguiente paso del flujo puede configurarse con un Filtro basado en:

  • El Evento en Paso Anterior (qué operación falló o si no hubo evento).
  • Una Recurrencia / Código de error (detalle del motivo).


Evento en Paso Anterior

Opciones típicas:

  • Sin Evento
  • Error al indexar documento
  • Error al buscar documento
  • Error al procesar OCR en documento
  • Error al firmar documento
  • Error al procesar PDF en documento


Recurrencia (Códigos)

Ejemplos de códigos disponibles:

  • (3) Maximum document limit exceeded
  • (31) No filters configured for this document type
  • (32) Each filter must contain a valid key
  • (33) Filter key is not allowed
  • (34) Document list cannot be empty
  • (35) The isZip field is required
  • (37) Invalid document type configuration
  • (38) Document type is not assigned
  • (39) Document type is not enabled
  • (40) Client configuration not found
  • (57) Invalid client configuration version
  • (500) Unable to establish connection


Patrón recomendado (Éxito vs Error)

  • Ruta de Éxito: configurar el siguiente paso con filtro Sin Evento.
  • Ruta de Error: configurar pasos alternos con filtro Error… y, si aplica, un código específico (recurrencia) para decidir la acción.


Patrón End-to-End Recomendado (Ejemplo)

  1. Recibir el documento (portal web / chat / canal).
  2. Ejecutar OCR para extraer texto y validar.
  3. Ejecutar Indexación para guardar el documento con etiquetas (DNI, caseId, etc.).
  4. Ejecutar Búsqueda cuando se necesite recuperar el documento.
  5. Ejecutar Firmar PDF si se requiere generar evidencia o versión firmada.


Actualizado el: 07/07/2026

¿Este artículo te resultó útil?

Comparte tu opinión

Cancelar

¡Gracias!