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:- Descargar el PDF desde una URL (de un servicio de generación de PDF)
- Subir el archivo a Twenty
- Crear un archivo adjunto vinculado al registro
Prerrequisitos
Antes de configurar el flujo de trabajo:- 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.
- 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
- Vaya a Flujos de trabajo y cree un nuevo flujo de trabajo
- Seleccione Activador manual
- Elija el objeto al que desea adjuntar archivos PDF (p. ej., Empresa u Oportunidad)
Paso 2: Añadir una Función de lógica
- Añada una acción Code (función de lógica)
- Cree una nueva función con el siguiente código
- Configure los parámetros de entrada
Parámetros de entrada
| Parámetro | Valor |
|---|---|
companyId | {{trigger.object.id}} |
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
ReemplacecompanyId por el campo correspondiente:
| Objeto | Nombre del campo |
|---|---|
| Empresa | companyId |
| Persona | personId |
| Oportunidad | opportunityId |
| Objeto personalizado | yourCustomObjectId |
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:- Primero, cree una acción de solicitud HTTP para generar el PDF
- Pase la URL de PDF devuelta a la función de lógica como parámetro
Paso 4: Probar y activar
- Guarde el flujo de trabajo
- Vaya a un registro de Empresa
- Haga clic en el menú ⋮ y seleccione su flujo de trabajo
- Revise la sección Adjuntos del registro para verificar que el PDF se haya adjuntado
- 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
| Paso | Acción | Propósito |
|---|---|---|
| 1 | Activador manual (Empresa) | El usuario lo inicia en un registro |
| 2 | Buscar registro | Obtener detalles de la oportunidad o de las partidas |
| 3 | Solicitud HTTP | Llamar a la API de generación de PDF con los datos del registro |
| 4 | Función sin servidor | Descargar y adjuntar el PDF generado |
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
Solución de Problemas
| Problema | Solución |
|---|---|
| ”Error al descargar el PDF” | Compruebe que la URL del PDF sea accesible y devuelva un PDF válido |
| ”Error al subir” | Verifique que su clave de API sea válida y tenga permisos de escritura |
| ”Error al crear el adjunto” | Asegúrese de que el nombre del campo de ID del objeto coincida con su objeto de destino |