Skip to main content
Twenty에서 PDF를 자동으로 생성하거나 가져와 레코드에 첨부합니다. 이는 Company, Opportunity 또는 기타 객체에 연결된 견적서, 송장, 보고서를 생성할 때 흔히 사용됩니다.

개요

이 워크플로우는 수동 트리거를 사용하므로 사용자가 선택한 레코드에 대해 필요할 때 PDF를 생성할 수 있습니다. 로직 함수가 다음을 처리합니다:
  1. URL에서 PDF를 다운로드(PDF 생성 서비스에서 제공)
  2. 파일을 Twenty에 업로드
  3. 레코드에 연결된 첨부 파일 생성

사전 준비

워크플로우를 설정하기 전에:
  1. API 키 생성: Settings → APIs로 이동하여 새 API 키를 만드세요. 이 토큰은 로직 함수에 필요합니다.
  2. PDF 생성 서비스 설정(선택 사항): PDF를 동적으로 생성하려면(예: 견적서) Carbone, PDFMonkey, DocuSeal 같은 서비스를 사용해 PDF를 만들고 다운로드 URL을 받으세요.

단계별 설정

1단계: 트리거 구성

  1. 워크플로우로 이동해 새 워크플로우를 생성합니다
  2. 수동 트리거를 선택합니다
  3. PDF를 첨부할 객체를 선택하세요(예: Company 또는 Opportunity).
수동 트리거를 사용하면 사용자가 레코드를 선택한 후 우측 상단에 표시되는 버튼으로 이 워크플로우를 실행해 PDF를 생성하고 첨부할 수 있습니다.

2단계: 로직 함수 추가

  1. Code 액션(로직 함수)을 추가합니다
  2. 아래 코드로 새 함수를 만드세요
  3. 입력 매개변수를 구성하세요

입력 매개변수

다른 객체(Person, Opportunity 등)에 첨부하는 경우 해당 매개변수 이름을 바꾸고(예: personId, opportunityId) 로직 함수를 업데이트하세요.

로직 함수 코드

3단계: 사용 사례에 맞게 사용자 지정

다른 객체에 첨부하려면

companyId를 해당 필드로 바꾸세요: 함수 매개변수와 첨부 생성 mutation의 variables.data 객체를 모두 업데이트하세요.

동적 PDF URL을 사용하려면

PDF 생성 서비스를 사용하는 경우 다음을 수행할 수 있습니다:
  1. 먼저 PDF를 생성하기 위해 HTTP 요청 작업을 만듭니다
  2. 반환된 PDF URL을 로직 함수의 매개변수로 전달합니다

4단계: 테스트 및 활성화

  1. 워크플로우를 저장합니다
  2. Company 레코드로 이동합니다
  3. 메뉴를 클릭하고 워크플로우를 선택합니다
  4. 레코드의 Attachments 섹션에서 PDF가 첨부되었는지 확인합니다
  5. 워크플로우를 활성화합니다

PDF 생성 서비스와 결합하기

동적 견적서나 송장을 생성하려면:

예시: 견적서 생성 → PDF 첨부

널리 사용되는 PDF 생성 서비스

  • Carbone - 템플릿 기반 문서 생성
  • PDFMonkey - 템플릿 기반 동적 PDF 생성
  • DocuSeal - 문서 자동화 플랫폼
  • Documint - API 우선 문서 생성
각 서비스는 PDF URL을 반환하는 API를 제공하며, 이 URL을 로직 함수에 전달할 수 있습니다.

문제 해결

관련 항목