PandaDoc 자동화은(는) 무엇을 하나요?
Claude Code에서 직접 PandaDoc 문서 워크플로를 관리하세요. 업로드된 파일로 문서를 만들고, 수신자와 연락처를 관리하며, 폴더로 정리하고, 이벤트 웹훅을 설정하며, 템플릿을 만들고, 터미널을 벗어나지 않고 문서 상태를 추적할 수 있습니다.
툴킷 문서: composio.dev/toolkits/pandadoc
설정
- 구성에 Composio MCP 서버를 추가하세요:
https://rube.app/mcp - 프롬프트에 따라 PandaDoc 계정을 연결하세요. 에이전트가 인증을 위한 OAuth 링크를 제공합니다.
- 필요한 기능(예: 전자 서명, 템플릿, 웹훅)에 맞는 PandaDoc 작업 공간 요금제를 확인하세요.
핵심 워크플로
1. 파일로 문서 생성
PDF, DOCX 또는 RTF 파일을 업로드하여 서명 및 추적을 위한 지정 수신자가 포함된 새로운 PandaDoc 문서를 만듭니다.
도구: PANDADOC_CREATE_DOCUMENT_FROM_FILE
주요 매개변수:
name(필수) -- 문서 이름recipients(필수) -- 수신자 객체 배열, 각각 다음 포함:email(필수) -- 수신자 이메일first_name,last_name-- 수신자 이름role--signer(기본값),approver또는cc(수신자별로 고유해야 함)signing_order-- 숫자 순서 (한 명에 설정하면 모든 수신자에 설정해야 함)
file--name,mimetype,s3key를 포함한 업로드된 파일 객체url-- 대안으로, 파일에 대한 공개 HTTPS URLparse_form_fields(기본값 false) -- PDF 양식 필드 구문 분석tags-- 분류를 위한 문자열 배열owner-- 문서 소유자 (이메일 또는 membership_id)
예시 프롬프트: "contract.pdf로 PandaDoc 문서를 만들고 [email protected]은 서명자, [email protected]은 승인자로 지정해줘"
2. 문서 세부 정보 가져오기
수신자, 필드, 토큰, 가격, 태그 및 콘텐츠 블록 참조를 포함한 문서의 종합 메타데이터를 가져옵니다.
도구: PANDADOC_GET_DOCUMENT_DETAILS
주요 매개변수:
id(필수) -- 고유 문서 식별자 (예:BhVzRcxH9Z2LgfPPGXFUqa)
문서 상태 확인, 수신자 완료 검사, 필드 값 검토 또는 보고를 위한 메타데이터 수집에 사용합니다.
예시 프롬프트: "PandaDoc 문서 BhVzRcxH9Z2LgfPPGXFUqa의 전체 세부 정보와 상태를 가져와줘"
3. 연락처 관리
PandaDoc에서 새 연락처를 만들거나 기존 연락처를 업데이트합니다. 연락처는 이메일로 일치됩니다. 주어진 이메일의 연락처가 있으면 업데이트되고, 없으면 새로 생성됩니다.
도구: PANDADOC_CREATE_OR_UPDATE_CONTACT
주요 매개변수:
email(필수) -- 연락처 이메일 주소first_name,last_name-- 연락처 이름company-- 회사명job_title-- 직책phone-- 전화번호street_address,city,state,postal_code,country-- 주소 필드
예시 프롬프트: "Acme Corp의 Software Engineer인 [email protected] PandaDoc 연락처를 생성해줘"
4. 폴더로 정리
폴더를 만들고 문서를 이동하여 PandaDoc 작업 공간을 정리합니다.
도구: PANDADOC_CREATE_FOLDER, PANDADOC_LIST_DOCUMENT_FOLDERS, PANDADOC_MOVE_DOCUMENT_TO_FOLDER
폴더 생성:
name(필수) -- 폴더 이름parent_uuid-- 중첩 구조를 위한 상위 폴더 UUID
예시 프롬프트: "PandaDoc에 '2026년 1분기 계약서' 폴더를 만들고 문서 BhVzRcxH9Z를 그 폴더로 이동해줘"
5. 웹훅 설정
문서 이벤트 발생 시 실시간 알림을 받을 웹훅 구독을 만듭니다.
도구: PANDADOC_CREATE_WEBHOOK
주요 매개변수:
name(필수) -- 웹훅 설명 이름url(필수) -- 알림을 수신할 엔드포인트 URLtriggers(필수) -- 이벤트 유형:document_state_changed,recipient_completed,document_updated등active(기본값 true) -- 웹훅 활성화/비활성화payload-- 포함할 추가 데이터:fields,products,metadata,tokens,pricing
예시 프롬프트: "문서 상태가 변경되거나 수신자가 완료했을 때 https://api.example.com/hooks로 알림을 보내는 PandaDoc 웹훅을 설정해줘"
6. 템플릿 생성
PDF 파일에서 또는 구조화된 콘텐츠 블록으로 처음부터 재사용 가능한 템플릿을 만듭니다.
도구: PANDADOC_CREATE_TEMPLATE
주요 매개변수:
name(필수) -- 템플릿 이름file_path-- 템플릿 생성을 위한 PDF 파일 경로content-- 처음부터 생성을 위한title과blocks배열을 포함한 구조화된 콘텐츠 객체description-- 템플릿 설명tags-- 분류 태그
예시 프롬프트: "nda-template.pdf 파일로 '표준 NDA'라는 PandaDoc 템플릿을 만들어줘"
알려진 문제점
- 고유한 수신자 역할: PandaDoc API는 단일 문서 내에서 중복 역할을 허용하지 않습니다. 각 수신자는 고유한
role값을 가져야 합니다 (예:signer,signer_2,approver,cc). - 서명 순서 일관성: 어떤 수신자에 대해
signing_order를 지정하면 문서의 모든 수신자에 대해 이를 지정해야 합니다. 부분적으로 순서를 지정하면 오류가 발생합니다. - 파일 업로드 요구사항: 문서 생성을 위해
file(s3key포함) 또는url중 하나만 제공해야 하며, 둘 다 제공해서는 안 됩니다. URL은 공개적으로 접근 가능한 HTTPS여야 합니다. - 연락처 업데이트 동작:
PANDADOC_CREATE_OR_UPDATE_CONTACT는 이메일로 일치합니다. 연락처의 이메일 자체를 업데이트해야 하는 경우 새 연락처를 만들고 이전 연락처는 별도로 처리해야 합니다. - 문서 ID 형식: 문서 ID는 영숫자 문자열입니다 (예:
BhVzRcxH9Z2LgfPPGXFUqa). 문서 생성 시 반환되며 PandaDoc 대시보드에서 찾을 수 있습니다. - 웹훅 이벤트 이름: 트리거 이벤트 이름은 정확히 일치해야 합니다 (예:
document_state_changed,stateChanged또는state_changed가 아님). 전체 목록은 PandaDoc API 문서를 확인하세요. - 폴더 작업에는 UUID 필요: 문서를 이동하려면 문서 ID와 대상 폴더 UUID가 모두 필요합니다. 올바른 UUID를 얻으려면 먼저 폴더 목록을 조회하세요.
- 템플릿 콘텐츠 블록: 처음부터 템플릿을 만들 때
blocks배열은 PandaDoc 스키마에 따른 유효한 콘텐츠 블록 객체를 포함해야 합니다. 지원되는 블록 유형은 API 문서를 확인하세요.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
PANDADOC_CREATE_DOCUMENT_FROM_FILE | PDF/DOCX/RTF로 수신자와 함께 문서 생성 |
PANDADOC_GET_DOCUMENT_DETAILS | 전체 문서 메타데이터, 상태 및 필드 가져오기 |
PANDADOC_CREATE_OR_UPDATE_CONTACT | 이메일로 연락처 생성 또는 업데이트 |
PANDADOC_CREATE_FOLDER | 문서 구성을 위한 폴더 생성 |
PANDADOC_LIST_DOCUMENT_FOLDERS | 모든 문서 폴더 나열 |
PANDADOC_MOVE_DOCUMENT_TO_FOLDER | 문서를 특정 폴더로 이동 |
PANDADOC_CREATE_WEBHOOK | 이벤트 알림 웹훅 설정 |
PANDADOC_CREATE_TEMPLATE | 재사용 가능한 문서 템플릿 생성 |
Composio 제공