Saltar al contenido principal
Genere u obtenga automáticamente un PDF y adjúntelo a un registro en Twenty. Esto se usa comúnmente para crear cotizaciones, facturas o informes vinculados a Empresas, Oportunidades u otros objetos.

Resumen

Este flujo de trabajo utiliza un Activador manual para que los usuarios puedan generar un PDF bajo demanda para cualquier registro seleccionado. Una Función de lógica se encarga de:
  1. Descargar el PDF desde una URL (de un servicio de generación de PDF)
  2. Subir el archivo a Twenty
  3. Crear un archivo adjunto vinculado al registro

Prerrequisitos

Antes de configurar el flujo de trabajo:
  1. Cree una clave de API: Vaya a Settings → APIs y cree una nueva clave de API. Necesitará este token para la función de lógica.
  2. Configure un servicio de generación de PDF (opcional): Si desea generar PDFs dinámicamente (p. ej., cotizaciones), use un servicio como Carbone, PDFMonkey o DocuSeal para crear el PDF y obtener una URL de descarga.

Configuración paso a paso

Paso 1: Configurar el disparador

  1. Vaya a Flujos de trabajo y cree un nuevo flujo de trabajo
  2. Seleccione Activador manual
  3. Elija el objeto al que desea adjuntar archivos PDF (p. ej., Empresa u Oportunidad)
Con un Activador manual, los usuarios pueden ejecutar este flujo de trabajo usando un botón que aparece en la parte superior derecha una vez que se selecciona un registro, para generar y adjuntar un PDF.

Paso 2: Añadir una Función de lógica

  1. Añada una acción Code (función de lógica)
  2. Cree una nueva función con el siguiente código
  3. Configure los parámetros de entrada

Parámetros de entrada

Si va a adjuntar a un objeto diferente (Persona, Oportunidad, etc.), cambie el nombre del parámetro en consecuencia (p. ej., personId, opportunityId) y actualice la función de lógica.

Código de la Función de lógica

Paso 3: Personalice para su caso de uso

Para adjuntar a un objeto diferente

Reemplace targetCompanyId por el campo correspondiente: Actualice tanto el parámetro de la función como el objeto variables.data en la mutación de adjunto.

Para usar una URL de PDF dinámica

Si usa un servicio de generación de PDF, puede:
  1. Primero, cree una acción de solicitud HTTP para generar el PDF
  2. Pase la URL de PDF devuelta a la función de lógica como parámetro

Paso 4: Probar y activar

  1. Guarde el flujo de trabajo
  2. Vaya a un registro de Empresa
  3. Haga clic en el menú y seleccione su flujo de trabajo
  4. Revise la sección Adjuntos del registro para verificar que el PDF se haya adjuntado
  5. Activa el flujo de trabajo

Combinación con servicios de generación de PDF

Para crear cotizaciones o facturas dinámicas:

Ejemplo: Generar cotización → Adjuntar PDF

Servicios populares de generación de PDF

  • Carbone - Generación de documentos basada en plantillas
  • PDFMonkey - Creación dinámica de PDF a partir de plantillas
  • DocuSeal - Plataforma de automatización de documentos
  • Documint - Generación de documentos con enfoque API-first
Cada servicio proporciona una API que devuelve una URL de PDF, que luego puede pasar a la función de lógica.

Solución de Problemas

Relacionado