waafir-esign 참조
waafir-esign 서버는 Waafir의 자체 전자 서명 서비스를 연결된 AI 클라이언트에 제공합니다. 조직의 파일로 엔벨로프를 생성하고, 서명자가 서명(또는 거절)하게 하고, 상태를 추적하고, 서명된 PDF를 다운로드할 수 있습니다. 서명은 Waafir 자체 서명 엔진이 생성하는 eIDAS AES(PAdES) 서명입니다. 모든 서명은 위변조를 감지할 수 있는 감사 추적에 서명자의 동의(IP 주소, 사용자 에이전트, 타임스탬프)를 기록하며, 서명된 PDF는 원본 파일의 최신 버전으로 저장됩니다.
연결: https://app.waafir.io/api/mcp/waafir 또는 영역 서버 https://app.waafir.io/api/mcp/waafir-esign. 설정을 참조하세요. 도구 이름은 두 곳에서 동일합니다. 읽기 도구에는 로그인으로 생성한 연결이나 PAT에 read 범위가 필요합니다. 생성, 발송, 거절, 서명자 수정, 무효화에는 write 범위가 필요합니다. 서명에는 write 및 문서 서명 권한이 필요합니다. 연결의 경우 동의 화면에서 승인하고, 토큰의 경우 생성할 때 켭니다(토큰에 문서 서명 허용 참조). 이 권한이 없으면 esign_sign이 도구 목록에서 숨겨지고, 호출하면 거부됩니다. 특정 데이터룸으로 제한된 연결이나 토큰은 해당 데이터룸의 파일로 만든 엔벨로프만 다룰 수 있습니다. 이는 데이터룸 도구가 적용하는 것과 같은 경계입니다.
월간 엔벨로프 할당량
전자 서명은 엔벨로프 단위로 계량됩니다. 하나의 문서 / 서명 작업은 서명자가 몇 명이든 한 번으로 집계됩니다. 이 MCP 서버와 앱 내 서명 화면은 모두 하나의 공유 월간 풀에서 차감됩니다.
- 접근하려면 E-Signatures 추가 기능 또는 활성 Waafir 구독이 필요합니다. 둘 다 없으면
waafir-esign에 대한 모든 요청이 도구가 실행되기 전에 입구에서 HTTP 402로 거부됩니다. 이는 계층 1 거부입니다.ADDON_NOT_PURCHASED는 해당 응답의message텍스트 안에 나타나며, 별도의 기계 판독 가능 필드가 아니므로 코드가 아니라 402 상태로 분기하세요.waafir에서는 대신esign_도구가 도구 목록에서 숨겨지며, 그중 하나를 호출하면 계층 2에서QUOTA_EXCEEDED로 거부되고 해당 도구를 명시한 메시지가 반환되는데, 이 메시지에는ADDON_NOT_PURCHASED도 포함됩니다. - 플랜에는 월간 엔벨로프 번들이 포함됩니다: Starter 10개, Premium 50개, Enterprise 활성 시트당 50개(역월 기준).
- E-Signatures 추가 기능을 1유닛 구매할 때마다 플랜 번들에 더해 월 100개의 엔벨로프가 추가되며, 유닛은 어떤 플랜에서도 누적됩니다.
- 할당량은 엄격한 상한입니다. 한도에 도달한 상태에서 엔벨로프를 발송하면 발송이 와이어 코드
QUOTA_EXCEEDED코드로 거부되며, 유닛을 더 구매하거나 업그레이드하라는 안내가 표시됩니다. 엔벨로프당 자동으로 요금이 청구되는 일은 절대 없습니다. 메시지 텍스트에는 내부 토큰ESIGN_QUOTA_EXCEEDED도 언급되지만 이는 설명 문구이므로,QUOTA_EXCEEDED인error.code로 분기하세요. 상한에 걸린send: true생성 호출도 초안은 남겨 둡니다. 다시 생성하지 말고 여유가 생기면 그 초안을 발송하세요.
할당량은 엔벨로프가 발송될 때(서명이 시작될 때) 소비되며 서명 단위로 소비되지 않습니다. 따라서 서명과 거절은 할당량을 소비하지 않습니다. 읽기와 다운로드도 마찬가지입니다. 남은 여유는 언제든지 esign_quota_status로 확인하세요.
자체 NDA를 전자적으로 서명
조직이 자체 NDA를 업로드하면(투자자 → NDA → 자체 NDA 업로드, 사용자 지정 기능 참조) 각 투자자는 Waafir의 서명 화면에서 이에 서명합니다. 로그인한 투자자가 NDA에 서명을 선택하면 문서가 새 탭에서 열리고, 공유 링크 방문자는 입력한 주소로 서명 링크를 이메일로 받습니다. 이러한 NDA 엔벨로프는 월간 할당량에 포함되지 않으며, NDA 템플릿 자체를 일반 엔벨로프처럼 발송할 수는 없습니다.
도구
이 서버의 인수와 결과 키는
snake_case입니다. 다른 모든 Waafir MCP 서버와 같은 규칙입니다.file_id,envelope_id,signing_mode,field_layout,consent_affirmed,confirm_send,download_url,has_more.
호환성이 깨지는 변경 —
waafir-esign은 이전에camelCase인수를 받았습니다.fileId,envelopeId,signingMode,fieldLayout,consentAffirmed는 더 이상 허용되지 않으며, 각각 아래 표에 나열된snake_case표기가 있습니다.confirm_send는 원래 snake_case였으므로 변경되지 않았습니다.폐기된 표기가 필수 인수였다면 조용히 받아들여지지 않고 거부됩니다.
esign_create_envelope에 여전히fileId를 보내는 호출은 인수 유효성 검사에 실패하며, 누락된 키로file_id를 지목합니다. 선택 인수였다면 인식되지 않는 다른 키와 똑같이 조용히 버려집니다. 아래의 두 가지 실패 방식을 참조하세요. 호출을 이 페이지의 표기로 업데이트하세요.
철자가 틀린 키는 두 가지 방식 중 하나로 실패하며, 그중 하나는 조용히 일어납니다. 인식되지 않는 인수는 거부되지 않고 버려지므로, 그다음에 일어나는 일은 의도한 키가 필수였는지에만 달려 있습니다.
-
필수 키 → 호출이 거부됩니다. 인수가 단순히 누락된 것입니다. 이는 눈에 띄고 안전한 경우로,
esign_create_envelope(file_id),esign_get_envelope,esign_sign(envelope_id및consent_affirmed),esign_decline,esign_void_envelope,esign_revise_signers(envelope_id및signatories),esign_download_signed가 해당하며, 이 키들의 폐기된 camelCase 표기도 모두 포함됩니다.error.code가 포함되지 않습니다. 인수는 도구가 실행되기 전에 도구가 공개한 스키마에 대해 검증되므로, 필수 키가 누락되거나 유형이 잘못된 경우 서버가 직접 생성한 오류 결과로 반환됩니다. 응답은 오류로 표시되고 텍스트에 문제가 된 인수가 명시되지만, 도구가 실행되지 않았으므로 계층 2의error.code필드는 채워지지 않습니다. 인수 형태 오류에 대해INVALID_ARGUMENT로 분기하지 말고 메시지를 읽으세요. 형식이 잘못된confirm_token처럼 도구가 실행을 시작한 후 발생하는 거부에는 여전히INVALID_ARGUMENT가 반환됩니다. -
선택 키 → 호출은 성공하지만 다른 작업을 합니다.
200과 올바른 형식의 결과를 받지만, 그 결과는 다른 질문에 대한 답입니다.esign_list_envelopes의 필터는 선택 사항이므로, 잘못 들어간fileId는 버려지고 토큰이 볼 수 있는 모든 엔벨로프의 필터링되지 않은 목록을 받게 됩니다. 상위 집합이 마치 필터링된 답인 것처럼 반환되는 것입니다.esign_create_envelope에서signingMode: "sequential"이 버려지면 엔벨로프는 기본값인parallel모드로 남습니다. 이후 발송하면 법적 구속력이 있는 서명 요청 이메일이 모든 서명자에게 동시에 발송되며, 이는 바로sequential을 요청해 막으려던 일입니다.fieldLayout도 같은 방식으로 버려집니다.
버려진 선택 키는 스스로 알릴 수 없으므로 결과가 요청한 내용을 반영하는지 확인하세요. 생성된 엔벨로프는 자신의 signing_mode를 보고하며, esign_list_envelopes는 필터의 철자가 올바를 때만 필터링됩니다.
esign_create_envelope (쓰기)
조직의 파일로 엔벨로프를 생성하고 서명자를 지정합니다. 어떤 이메일 주소든 허용되며, 서명자에게 Waafir 계정이 필요하지 않습니다. 각 서명자에게 연락하는 방식은 엔벨로프가 발송될 때 해당 주소에 이미 Waafir 계정이 있는지에 따라 결정됩니다. 계정 보유자는 세션 내에서 서명하며(앱 내 알림과 서명 화면으로 연결되는 이메일), 그 밖의 모든 사람은 게스트 서명 링크를 이메일로 받습니다. 판단 기준은 조직 구성원 여부가 아니라 계정 존재 여부이므로, 다른 조직에 속한 서명자도 세션 내에서 서명합니다. 대기 중인 각 서명자는 둘 중 정확히 하나만 받으며, 둘 다 받거나 둘 다 받지 못하는 일은 없습니다.
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
file_id | string (UUID) | 예 | 서명할 파일. 조직에 속해 있어야 합니다. |
signatories | array | 예 | { "email": string, "name"?: string } 1–50개. 어떤 이메일이든 허용되며, 서명자가 Waafir 사용자일 필요가 없습니다. 외부 주소에는 게스트 서명 링크가 발송됩니다. |
transaction_id | string (UUID) | 아니요 | 더 이상 사용되지 않으며 무시됩니다. 기존 통합이 계속 작동하도록 허용되지만, 보내지 마세요. |
send | boolean | 아니요 | true이면 엔벨로프의 서명을 즉시 시작하며, 두 단계로 진행됩니다(아래 참조). 조직 외부 사람들에게 전송이 켜진 토큰이 필요합니다. |
confirm_token | string | 아니요 | send: true와 함께만 사용: 미리보기 호출에서 받은 토큰. |
confirm_send | boolean | 아니요 | 더 이상 사용되지 않으며 무시됩니다. send: true는 이제 confirm_token을 사용합니다. |
signing_mode | "parallel" | "sequential" | 아니요 | 서명 순서. "parallel"이 기본값입니다. 서명자는 어떤 순서로든 서명할 수 있으며, 발송 시 모두에게 동시에 이메일이 발송됩니다. "sequential"은 첫 번째 서명자에게만 이메일을 보내고, 앞선 모든 서명자가 서명할 때마다 다음 서명자를 순서대로 진행시킵니다. 순서를 어긴 서명은 CONFLICT로 거부됩니다. 생략하거나 signingMode로 잘못 쓰면 "parallel"이 됩니다. |
field_layout | array | 아니요 | 필드 배치 레이아웃 재정의. 기본 레이아웃을 사용하려면 생략합니다. |
observers | array | 아니요 | { "email": string, "name"?: string } 형식의 참관자(참조) 최대 20명. 참관자는 서명 요청과 각 알림의 사본을 상태를 확인할 수 있는 읽기 전용 링크와 함께 이메일로 받습니다. 참관자는 서명하지 않으며 서명된 사본도 받지 않습니다. |
send: true는 두 단계로 진행됩니다. 발송이 성공하는 순간 목록의 모든 주소로 실제 법적 구속력이 있는 서명 요청 이메일이 발송되기 때문입니다. 첫 번째 호출은 아무것도 생성하거나 발송하지 않으며, 미리보기(서명자, 참관자 수, 할당량)와 confirm_token을 반환합니다. 동일한 인수와 토큰으로 다시 호출하면 생성과 발송이 이루어집니다. 토큰은 한 번만 사용할 수 있으며 몇 분 후에 만료됩니다. 권한이 없으면 send: true는 FORBIDDEN(GRANT_REQUIRED)으로 거부됩니다. 이 경우 send 없이 엔벨로프를 생성한 다음 Waafir에서 발송하세요.
esign_revise_signers도 누군가에게 이메일을 보내게 되는 경우(발송된 엔벨로프의 새 서명자 또는 참관자)에는 같은 두 단계를 거치며 같은 권한이 필요합니다.
엔벨로프를 반환합니다. 필드는 정확히 id, file_id, status, signing_mode, created_by, signed_output_name, signed_output_version_count, field_layout, packet_page_count, expires_at입니다. 결과는 수동으로 매핑된 허용 목록이므로 그 밖의 어떤 것도 전송되지 않습니다. 타임스탬프는 ISO-8601 문자열입니다.
초안 엔벨로프는 누군가 서명하기 전에 발송되어야 합니다. 발송하면 월간 할당량에서 엔벨로프 1개가 소비됩니다. 상한에 도달하면 send는 QUOTA_EXCEEDED를 반환하며, 엔벨로프는 나중에 발송할 수 있는 초안으로 남습니다. 잘못 발송한 엔벨로프는 esign_void_envelope로 회수할 수 있습니다.
아직 검사 중인 파일. 파일이 Waafir가 아직 검사를 마치지 않은 새 업로드 또는 새 버전이면 호출은 error.reason: "ACTIVATION_PENDING" 및 메시지 This file is still being checked. Try again shortly.와 함께 UNAVAILABLE을 반환합니다. 아무것도 생성되지 않으므로 잠시 기다린 후 다시 호출하세요.
esign_list_envelopes (읽기)
조직의 엔벨로프를 최신순으로, 각 엔벨로프의 서명자 및 상태와 함께 나열합니다. 선택적 필터: file_id. (transaction_id는 더 이상 사용되지 않으며 무시됩니다.) 필터는 선택 사항이므로 폐기된 camelCase 표기는 조용히 버려지고, 호출은 오류 대신 필터링되지 않은 목록을 반환합니다. 위의 키 관련 안내를 참조하세요.
페이지네이션 — limit(선택, 1–100, 기본값 25)과 offset(선택, 기본값 0)은 숫자여야 합니다. 다른 유형의 값은 다른 유형 불일치와 마찬가지로 인수 유효성 검사에 실패합니다. 범위를 벗어난 숫자는 거부되지 않고 범위 안으로 조정됩니다. limit: 10000은 100이 되고, offset: -2는 0이 됩니다. 반환값:
{ envelopes: [...],
pagination: { limit, offset, count, has_more, next_offset, total },
filtered_by_pat_scope: boolean }잘린 결과와 완전한 결과를 구별하려면 has_more를 사용하고, next_offset이 null이 될 때까지 따라가세요. count === limit으로 다음 페이지가 있는지 추론하지 마세요. total은 이 토큰이 볼 수 있는 엔벨로프 수입니다.
filtered_by_pat_scope는 토큰이 특정 데이터룸으로 제한되어 있고 그 허용 목록이 결과를 제한했을 때 true입니다. 페이지 범위는 필터 이후에 적용되므로 페이지는 항상 정확합니다. 이 값은 의도적으로 숨겨진 엔벨로프 수가 아닌 불리언입니다. 몇 개가 숨겨졌는지 보고하면 토큰이 볼 수 없도록 제한된 엔벨로프의 존재와 양이 유출되기 때문입니다.
esign_get_envelope (읽기)
엔벨로프 하나를 서명자 및 서명자별 상태(pending / signed / declined)와 함께 가져옵니다. 입력: envelope_id. 위의 생성 도구 필드에 더해 엔벨로프에는 created_at, updated_at, signatories(각 항목은 { id, email, name, status, signed_at })가 포함됩니다.
esign_sign (쓰기)
본인의 대기 중인 서명 슬롯, 즉 토큰을 소유한 사용자와 이메일이 일치하는 슬롯에 서명합니다. 서명은 할당량을 소비하지 않습니다(엔벨로프는 발송될 때 이미 계량되었습니다). 문서 서명이 켜진 토큰이 필요합니다.
서명에는 두 번의 호출이 필요하므로, 어시스턴트는 무언가에 서명하기 전에 서명하려는 내용을 먼저 보여 줍니다.
- 미리보기.
confirm_token없이 호출합니다. 아무것도 서명되지 않습니다. 결과는dry_run: true이며 엔벨로프, 순서대로 나열된documents, 이 모두를 포괄하는 하나의document_hash,signer, 제공한fields, 동의 문구,confirm_token과 그expires_at이 포함됩니다. - 확인. 본인이 동의하면 동일한 인수에 해당
confirm_token을 더해 다시 호출합니다. 이 호출에서 서명이 이루어집니다.
confirm_token은 한 번만, 이 토큰과 이 인수에 대해서만 유효하며 5분 후에 만료됩니다. 그 사이에 엔벨로프, 문서, 서명 순서상의 위치 또는 필드가 바뀌면 확인이 거부되며 다시 미리보기를 해야 합니다.
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
envelope_id | string (UUID) | 예 | 서명할 엔벨로프. |
consent_affirmed | boolean | 예 | 반드시 문자 그대로 true여야 합니다. 동의 문구에 대한 명시적 확인입니다. 기본값이 없으며, 생략하거나 false를 전달하면 프로토콜 경계에서 호출이 실패합니다. |
fields | object | 아니요 | 필드 레이블을 키로 하는 입력값. 생략하면 이름과 날짜는 기본값이 사용됩니다. |
confirm_token | string | 아니요 | 생략하면 미리보기가 됩니다. 서명하려면 미리보기가 반환한 토큰을 전달합니다. |
확인 호출은 { envelope }를 반환하며, 이는 esign_create_envelope가 반환하는 것과 같은 허용 목록 형식의 엔벨로프입니다.
발생할 수 있는 오류: 엔벨로프의 대기 중인 서명자가 아니면 FORBIDDEN, 엔벨로프의 서명이 시작되지 않았거나 sequential 엔벨로프에서 앞선 서명자가 아직 서명하지 않았으면 CONFLICT. 이는 HTTP 상태가 아니라 페이로드 안의 error.code 값입니다. 설정을 참조하세요.
두 단계 확인에서는 다음 거부가 추가되며, 각각 메시지에 (code: …)가 포함됩니다.
error.code | code: | 조치 방법 |
|---|---|---|
FORBIDDEN | GRANT_REQUIRED | 이 토큰으로는 서명할 수 없습니다. 문서 서명을 켠 새 토큰을 생성하세요. |
INVALID_ARGUMENT | CONFIRM_TOKEN_MALFORMED | confirm_token 없이 다시 호출하여 토큰을 받으세요. |
CONFLICT | CONFIRM_TOKEN_INVALID | 토큰이 만료되었거나, 이미 사용되었거나, 다른 토큰의 것입니다. 다시 미리보기를 하세요. |
CONFLICT | CONFIRM_ARGS_MISMATCH | 인수가 미리보기 때와 다릅니다. 다시 미리보기를 하세요. |
CONFLICT | CONFIRM_STATE_CHANGED | 미리보기 이후 엔벨로프가 변경되었습니다. 다시 미리보기를 하고 본인에게 보여 주세요. |
CONFLICT | DOCUMENT_NOT_PINNED | 이 엔벨로프는 문서 고정 기능이 도입되기 전에 발송되었습니다. 서명 이메일을 통해 Waafir에서 서명하세요. |
UNAVAILABLE | CONFIRM_UNAVAILABLE | 확인 기능을 잠시 사용할 수 없습니다. 잠시 후 다시 시도하세요. |
엔벨로프의 레이아웃에 필수 필드가 있는데 fields가 이를 제공하지 않으면, 호출은 INVALID_ARGUMENT 코드로 거부되며 메시지에 (code: MISSING_REQUIRED_FIELDS)가 포함됩니다. 메시지에는 누락된 레이블이 표시되지 않지만, 앱 내 서명 화면에는 표시됩니다. 해당 필드를 채우고 다시 호출하세요.
esign_decline (쓰기)
본인의 대기 중인 슬롯을 거절합니다(최종 상태 — 엔벨로프가 declined가 됩니다). 입력: envelope_id. { id, status: "declined" }를 반환합니다. 할당량을 소비하지 않습니다.
esign_void_envelope (쓰기)
잘못 발송한 엔벨로프를 회수합니다. 보내지 말았어야 할 서명 요청이 발송되었을 때의 해결책입니다. 엔벨로프는 서명 접수를 중단하고, 처리되지 않은 모든 게스트 서명 링크가 즉시 무효화되며, 대기 중인 서명자는 더 이상 작업할 수 없습니다.
입력: envelope_id. 무효화된 엔벨로프를 esign_create_envelope가 반환하는 것과 같은 허용 목록 형식으로 반환합니다.
- 최종 상태. 무효화된 엔벨로프는 다시 발송할 수 없습니다. 대신 새 엔벨로프를 생성하세요.
- 이미 기록된 서명과 전체 감사 추적은 보존됩니다. 무효화해도 이미 서명된 내용은 지워지지 않습니다.
- 엔벨로프가
draft,sent또는partially_signed상태일 때만 가능합니다. 그 밖의 상태에서는CONFLICT가 반환되며, 만료된 엔벨로프는 오래된 상태 대신 만료되었음을 보고합니다. - 무효화할 수 있는 사람: 서명 요청을 생성한 사람 또는 조직 소유자나 관리자만 가능합니다. 그 밖의 사람은
FORBIDDEN을 받으며, 엔벨로프의 당사자가 전혀 아닌 호출자는NOT_FOUND를 받으므로, 이 도구는 알아서는 안 되는 사람에게 엔벨로프의 존재를 확인해 주지 않습니다. - 무효화는 할당량을 소비하지도, 환불하지도 않습니다. 할당량은 엔벨로프가 발송될 때 차감됩니다.
esign_revise_signers (쓰기, 파괴적)
엔벨로프를 무효화하고 할당량에서 엔벨로프를 하나 더 쓰지 않고도 서명 요청 대상을 바로잡습니다. 잘못 입력한 이메일, 누락된 거래 상대방, 잘못된 서명 순서 등에 사용합니다. 엔벨로프는 id, 감사 추적, 할당량 유닛을 그대로 유지합니다. 할당량을 소비하지 않습니다.
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
envelope_id | string (UUID) | 예 | 수정할 엔벨로프. |
signatories | array | 예 | 엔벨로프에 최종적으로 남아야 할 전체 서명자 목록(서명 순서대로): { "email": string, "name"?: string } 1–50개. 현재 목록을 대체합니다. |
signing_mode | "parallel" | "sequential" | 아니요 | 서명 순서를 변경합니다. 생략하면 현재 모드가 유지되며, "parallel"로 재설정되지 않습니다. |
observers | array | 아니요 | 전체 참관자(참조) 목록, 최대 20명. 생략하면 현재 참관자가 유지되며, 목록에서 뺀 참관자는 제거되고 읽기 전용 링크가 작동을 멈춥니다. |
이 작업은 파괴적입니다. signatories에서 뺀 서명자는 제거됩니다. 초대가 철회되고 서명 링크가 즉시 작동을 멈추며, 본인에게 알림이 가지 않습니다. 해당 서명자를 위해 배치된 필드도 모두 삭제됩니다. 이미 엔벨로프에 있는 서명자는 링크를 유지하며 다시 이메일을 받지 않습니다. 엔벨로프가 이미 발송되었다면 새 서명자에게는 즉시 초대가 발송됩니다. 이 도구는 destructiveHint: true로 표시되어 있으므로, 파괴적 호출을 확인하는 클라이언트는 실행 전에 확인을 요청합니다.
- 첫 서명 전까지만 가능합니다. 누군가 서명하면 서명자 목록과 서명 모드가 고정됩니다. 호출은
CONFLICT(code: ESIGN_SIGNERS_FROZEN)으로 거부되며, 해결 방법은 무효화한 후 새 엔벨로프를 생성하는 것입니다. 만료된 엔벨로프도CONFLICT로 거부됩니다. - 참관자만 변경하기. 변경하지 않은 서명자 목록(및 모드)을 새
observers목록과 함께 전달하세요. 참관자 제거는 서명이나 완료 이후를 포함해 언제든 가능합니다. 참관자 추가는 엔벨로프가 초안이거나 서명 진행 중일 때만 가능합니다. - 발송된 엔벨로프를 수정할 수 있는 사람: 서명 요청을 생성한 사람 또는 조직 소유자나 관리자만 가능하며, 그 밖의 사람은
FORBIDDEN을 받습니다. 초안은 볼 수 있는 사람이라면 누구나 수정할 수 있습니다. - 그 밖의 거부는 메시지에 이유가 포함됩니다. 중복된 주소(
ESIGN_DUPLICATE_SIGNATORY)나 빈 목록(ESIGN_EMPTY_ROSTER)은INVALID_ARGUMENT입니다. 발송된 엔벨로프가 포함하는 모든 문서를 읽을 수 없는데 그 엔벨로프에 새 서명자나 참관자를 추가하면FORBIDDEN입니다.
esign_get_envelope와 같은 형식의 엔벨로프에 더해, 변경된 내용의 revision 요약(참관자를 전달한 경우 observer_revision도 포함)을 반환합니다.
esign_list_my_pending_signatures (읽기)
이 조직에서 본인의 서명을 기다리는 엔벨로프를 나열합니다. 토큰 소유자의 이메일과 일치하는 대기 중인 서명자 슬롯이 있는 모든 진행 중인 엔벨로프입니다. esign_sign 전에 수행하기에 가장 유용한 읽기입니다.
입력이 없습니다. { envelopes: [{ id, file_id, document_name, status, created_at }] }를 반환합니다.
범위는 이 토큰의 조직으로 제한되며, 토큰이 제한된 경우 해당 데이터룸 허용 목록으로도 제한됩니다. 다른 조직의 대기 중인 서명은 본인이 그곳의 서명자이더라도 표시되지 않습니다.
esign_download_signed (읽기)
서명된 PDF의 단기 사전 서명 다운로드 URL을 받습니다. 입력: envelope_id. { download_url, expires_in_seconds }를 반환합니다. 엔벨로프에는 기록된 서명이 하나 이상 있어야 하며, 서명된 PDF는 제품에서 원본 파일의 최신 버전으로도 제공됩니다. 문서 내용 읽기가 켜진 토큰이 필요하며, 없으면 호출이 GRANT_REQUIRED로 거부됩니다.
esign_quota_status (읽기)
입력이 없습니다. 현재 역월의 { quota, used, remaining }, 즉 전체 엔벨로프 할당량(플랜 번들 + 구매한 유닛), 발송된 엔벨로프 수, 상한까지 남은 여유를 반환합니다.
esign_remind (쓰기)
입력은 envelope_id. 서명 진행 중인 엔벨로프의 모든 대기 서명자에게 다시 이메일을 보내고 모든 참관자에게 사본을 보내며, 엔벨로프당 최대 1시간에 한 번입니다. 조직 외부 사람들에게 전송이 필요하며 두 단계로 진행됩니다. 첫 번째 호출은 아무것도 보내지 않고 이메일을 받을 사람(참관자는 이름으로 표시)과 confirm_token을 반환하며, 그 토큰으로 다시 호출합니다. 그 사이에 참관자가 추가되면 확인이 실패합니다. 딜 팀 구성원만 사용할 수 있습니다.
esign_resend_signatory (쓰기)
입력은 envelope_id, signatory_id. 반송되었거나 차단된 주소를 해제하고 해당 서명자에게 다시 이메일을 보냅니다. 권한과 두 단계는 esign_remind와 같습니다.
esign_send_draft (쓰기)
입력은 envelope_id. 저장된 초안을 발송합니다. 모든 서명자에게 법적 구속력이 있는 서명 요청이 이메일로 발송되고, 모든 참관자에게 사본이 발송되며, 할당량에서 엔벨로프 1개가 사용됩니다. 권한과 두 단계는 같습니다. 미리보기에는 서명자, 참관자, 할당량이 표시되며, 미리보기한 서명자 명단과 참관자가 그대로 발송됩니다. 결과에는 이메일이 발송되지 않은 suppressed 주소가 나열됩니다.
esign_preview (읽기)
입력은 envelope_id. 서명 패널에 표시되는 그대로 엔벨로프를 반환합니다: { envelope_id, status, file_id, document_name, is_creator, signers, placed, fields, shows_signed_output, shows_live_source }. 문서를 읽을 수 없는 경우 document_name은 null입니다. 문서 내용은 반환되지 않습니다. 딜 팀 구성원만 사용할 수 있습니다.
esign_verify (읽기)
입력은 envelope_id. Waafir 검증 페이지에 표시되는 인증서와 무결성 요약을 반환합니다. 딜 팀 구성원만 사용할 수 있습니다.
법적 효력
서명은 eIDAS 고급 전자 서명(PAdES)이며, 미국 ESIGN/UETA 및 EU eIDAS에 따라 NDA와 계약에 유효합니다. 서명자의 동의(IP, 사용자 에이전트, 타임스탬프)는 서명 시점에 Waafir의 추가 전용, 해시 체인 감사 추적에 기록됩니다. 이 MCP 서버를 통해 생성되거나 발송된 엔벨로프는 해당 추적에 토큰이 시작한 작업으로 기록되므로, 에이전트가 시작한 발송은 사람이 앱에서 수행한 발송과 항상 구별됩니다. 적격 전자 서명(QES)은 이번 릴리스에 포함되지 않습니다.