개요
이 워크플로우는 수동 트리거를 사용하므로 사용자가 선택한 레코드에 대해 필요할 때 PDF를 생성할 수 있습니다. 로직 함수가 다음을 처리합니다:- URL에서 PDF를 다운로드(PDF 생성 서비스에서 제공)
- 파일을 Twenty에 업로드
- 레코드에 연결된 첨부 파일 생성
사전 준비
워크플로우를 설정하기 전에:- API 키 생성: Settings → APIs로 이동하여 새 API 키를 만드세요. 이 토큰은 로직 함수에 필요합니다.
- PDF 생성 서비스 설정(선택 사항): PDF를 동적으로 생성하려면(예: 견적서) Carbone, PDFMonkey, DocuSeal 같은 서비스를 사용해 PDF를 만들고 다운로드 URL을 받으세요.
단계별 설정
1단계: 트리거 구성
- 워크플로우로 이동해 새 워크플로우를 생성합니다
- 수동 트리거를 선택합니다
- PDF를 첨부할 객체를 선택하세요(예: Company 또는 Opportunity).
2단계: 로직 함수 추가
- Code 액션(로직 함수)을 추가합니다
- 아래 코드로 새 함수를 만드세요
- 입력 매개변수를 구성하세요
입력 매개변수
다른 객체(Person, Opportunity 등)에 첨부하는 경우 해당 매개변수 이름을 바꾸고(예:
personId, opportunityId) 로직 함수를 업데이트하세요.로직 함수 코드
3단계: 사용 사례에 맞게 사용자 지정
다른 객체에 첨부하려면
targetCompanyId를 해당 필드로 바꾸세요:
함수 매개변수와 첨부 생성 mutation의
variables.data 객체를 모두 업데이트하세요.
동적 PDF URL을 사용하려면
PDF 생성 서비스를 사용하는 경우 다음을 수행할 수 있습니다:- 먼저 PDF를 생성하기 위해 HTTP 요청 작업을 만듭니다
- 반환된 PDF URL을 로직 함수의 매개변수로 전달합니다
4단계: 테스트 및 활성화
- 워크플로우를 저장합니다
- Company 레코드로 이동합니다
- ⋮ 메뉴를 클릭하고 워크플로우를 선택합니다
- 레코드의 Attachments 섹션에서 PDF가 첨부되었는지 확인합니다
- 워크플로우를 활성화합니다
PDF 생성 서비스와 결합하기
동적 견적서나 송장을 생성하려면:예시: 견적서 생성 → PDF 첨부
널리 사용되는 PDF 생성 서비스
- Carbone - 템플릿 기반 문서 생성
- PDFMonkey - 템플릿 기반 동적 PDF 생성
- DocuSeal - 문서 자동화 플랫폼
- Documint - API 우선 문서 생성