사내 AI 챗봇에게 계약 현황을 묻는 시대, 이싸인온 API 연동 구축법

사내 AI 챗봇에게 계약 현황을 묻는 시대, 이싸인온 API 연동 구축법

전자계약을 도입했는데도 사내 메신저에서는 이런 질문이 반복되고 있나요?

“지난주 보낸 A사 계약서 서명됐나요?”

“이번 달 아직 완료되지 않은 계약이 몇 건인가요?”

“B사 계약서는 상대방이 확인했나요?”

이싸인온(eSignon) API를 사내 시스템과 연결하면 계약 상태를 직접 조회하고, 문서 상태가 변경됐을 때 관련 정보를 외부 시스템으로 전달받는 업무 구조를 만들 수 있습니다.

여기에 사내 AI 챗봇을 연결하면 직원은 이싸인온에 직접 접속하지 않고도 “A사 계약 현황 알려줘”처럼 자연어로 질문하고, 회사가 연동한 계약 데이터를 바탕으로 답을 받는 시스템을 구성할 수 있습니다.

중요한 점은 이싸인온에 AI 챗봇 기능이 기본 탑재되어 있다는 뜻이 아니라, 이싸인온 API와 Webhook을 기업이 사용하는 챗봇·DB·ERP 등의 시스템과 연동해 만드는 구조라는 것입니다.

전자계약을 쓰는데 왜 아직 담당자에게 물어볼까요?

전자계약을 도입하면 종이를 출력하고 우편으로 주고받는 업무는 크게 줄어듭니다.

하지만 전자계약 서비스를 회사의 다른 시스템과 별도로 사용한다면 또 다른 반복 업무가 남을 수 있습니다.

예를 들어 영업 담당자가 CRM에서 거래처를 관리하고, 계약 담당자가 이싸인온에서 계약서를 관리한다고 가정해보겠습니다.

영업팀이 계약 진행 상태를 알고 싶을 때마다 계약 담당자에게 메시지를 보냅니다.

계약 담당자는 이싸인온에 접속해 문서를 검색하고 상태를 확인한 뒤 다시 메신저로 답변합니다.

전자계약으로 문서는 디지털화됐지만 계약 정보가 필요한 사람과 계약 데이터가 있는 시스템 사이에는 여전히 사람이 존재하는 구조입니다.

API 연동의 목적은 바로 이 단계를 줄이는 것입니다.

이싸인온 API로 어떤 계약 정보를 확인할 수 있나요?

이싸인온 API에서는 문서 목록과 문서 상세 정보를 조회할 수 있습니다.

문서 목록 조회 API에서는 문서명, 작성자, 부서, 생성일·수정일·만료일 등의 조건으로 문서를 검색할 수 있고 다음과 같은 진행 단계도 구분할 수 있습니다.

마감이 임박한 문서만 조회하는 조건도 제공합니다.

따라서 사내 시스템에서 예를 들어 다음과 같은 기능을 만들 수 있습니다.

“진행 중인 계약만 보여줘”

“이번 주 마감 예정 계약을 찾아줘”

“A사 계약 상태를 확인해줘”

AI 챗봇을 연결한다면 챗봇이 사용자의 자연어 질문을 적절한 조회 조건으로 변환하고, 내부 시스템이 API 또는 저장된 계약 데이터를 조회한 뒤 결과를 다시 사용자에게 설명하는 방식으로 구성할 수 있습니다.

상대방이 계약서를 열어봤는지도 확인할 수 있나요?

문서 상세 조회 API에서는 계약의 현재 상태뿐 아니라 문서 진행 과정의 이력도 확인할 수 있습니다.

이싸인온 개발자 문서에서는 다음과 같은 이력 상태를 제공합니다.

따라서 챗봇이 문서 상세 이력을 조회하도록 연동한다면

“상대방이 계약서를 확인했나요?”

라는 질문에 문서 이력을 기준으로 답하도록 구현할 수 있습니다.

다만 문서 열람 자체가 별도의 Webhook 이벤트로 실시간 Push된다고 가정해서 구현하는 것은 피하는 것이 좋습니다.

열람처럼 상세한 진행 기록이 필요한 경우에는 문서 상세 조회 API의 이력을 확인하는 구조로 설계하는 것이 정확합니다.

API와 Webhook은 무엇이 다른가요?

두 기능은 데이터를 사용하는 방향이 다릅니다.

API는 필요한 정보를 요청해 가져옵니다

예를 들어 사내 챗봇에서 직원이

“A사 계약 지금 어떻게 됐어?”

라고 질문했다고 가정해보겠습니다.

내부 시스템에서 이싸인온 API를 호출해 해당 계약의 현재 상태와 이력을 확인하고 그 결과를 챗봇에 전달할 수 있습니다.

즉 필요한 순간에 정보를 조회하는 구조입니다.

Webhook은 상태 변경 정보를 먼저 전달합니다

이싸인온에서는 Export API를 통해 Webhook 기능을 제공합니다.

비대면 문서를 API로 시작할 때 Callback URL을 설정하면 문서 작성 완료, 반려, 취소 등의 상태 변화가 발생했을 때 지정한 서버로 HTTP POST 요청이 전달됩니다.

전달되는 데이터에는 문서 ID, 작성 완료 시각, 작성자 정보, 입력 필드값, 문서 상태 등이 포함될 수 있습니다.

따라서 API = 필요한 시점에 현재 정보를 조회 / Webhook = 문서 진행 과정에서 발생한 상태 변경을 전달받음으로 구분해서 이해하면 쉽습니다.

실제 업무 자동화에서는 두 방식을 함께 사용하는 것이 유용합니다.

AI 챗봇과 연결하면 구조는 어떻게 되나요?

이싸인온이 Slack, Teams, 잔디 등의 AI 챗봇과 자동으로 직접 연결되는 것은 아닙니다.

기업이 사용하는 사내 메신저·AI 플랫폼과 이싸인온 사이에 연동 서버나 사내 DB를 구성하는 방식으로 구현할 수 있습니다.

예를 들면 다음과 같습니다.

계약 생성·서명 진행

이싸인온 → API 조회 / Webhook 상태 전달 → 사내 연동 서버 → 계약 상태 DB → 사내 AI 챗봇 → 직원이 챗봇에

“A사 계약 현황 알려줘” 라고 질문하면, 사내 챗봇이 회사가 구축한 계약 데이터에서 정보를 조회한 뒤 “A사 공급계약은 현재 진행 중이며 마지막 기록은 상대방 문서 열람입니다.” 처럼 답변하도록 만들 수 있습니다.

완료된 계약이라면 “A사 계약은 완료 상태이며 완료 문서 다운로드가 가능합니다.” 처럼 구성할 수도 있습니다.

어떤 데이터를 AI에게 제공하고 어떤 형식으로 답하게 할지는 회사의 챗봇 환경과 보안 정책에 따라 별도로 설계해야 합니다.

계약 완료를 챗봇이 먼저 알려주게 할 수도 있나요?

가능한 구조입니다.

예를 들어 Export API의 Webhook을 이용해 계약 완료 정보를 사내 서버가 받으면 후속 로직을 실행하도록 개발할 수 있습니다.

계약 완료

→ Webhook 수신

→ 사내 계약 DB 상태 변경

→ CRM·ERP 상태 변경

→ 담당자 또는 사내 채널에 완료 알림과 같은 방식입니다.

이 경우 직원이 계약 완료 여부를 계속 확인하지 않아도 상태 변경을 기준으로 후속 업무를 시작하도록 구성할 수 있습니다.

다만 Slack·Teams·잔디 알림이나 RPA 실행 자체는 이싸인온의 기본 기능이 아니라 고객사가 사용하는 외부 시스템의 API 또는 자동화 기능과 추가로 연결해야 하는 영역입니다.

완료된 계약서도 사내 시스템으로 가져올 수 있나요?

가능합니다.

문서가 완료된 경우 문서 상세 조회 API에서 완료 문서와 문서이력인증서를 다운로드할 수 있는 URL을 받을 수 있습니다.

해당 URL은 보안을 위해 발급 시점부터 24시간 동안 유효합니다.

이를 이용하면 예를 들어 계약 완료 → 완료 정보 수신 → 완료 문서 URL 요청 → 사내 문서관리시스템 저장 같은 흐름을 구성할 수 있습니다.

Export API에서 임베디드 옵션을 사용하는 경우에는 Webhook 데이터에 완료 문서 또는 이력인증서의 URL을 포함하도록 설정하는 방식도 지원합니다.

따라서 전자계약 완료 이후 문서를 다시 사람이 다운로드해 ERP나 문서관리시스템에 올리는 업무도 연동 범위에 따라 자동화할 수 있습니다.

계약서 작성부터 AI 챗봇 조회까지 연결할 수도 있나요?

API 연동 범위를 계약 상태 조회에만 한정할 필요는 없습니다.

이싸인온 API에서는 ERP·CRM 등에 이미 저장된 정보를 전자계약 서식에 미리 입력해 문서를 생성할 수 있습니다.

예를 들어 CRM에 다음 데이터가 있다고 가정해보겠습니다.

이 데이터를 이용해 계약서를 만들고 전송한 뒤 진행 상태와 완료 결과를 다시 사내 시스템으로 가져오는 흐름을 설계할 수 있습니다.

전체 흐름은 다음처럼 이어집니다.

CRM·ERP 데이터

→ 전자계약 생성

→ 서명 요청

→ 진행 상태 관리

→ 계약 완료

→ 완료 데이터·문서 내부 시스템 반영

→ AI 챗봇에서 계약 정보 조회

즉 AI 챗봇은 계약 자동화의 시작점이라기보다, 이미 연결된 계약 데이터를 직원이 가장 쉽게 활용하도록 만드는 조회 인터페이스 역할을 할 수 있습니다.

이싸인온 API 연동은 어디서부터 시작하나요?

API 연동을 처음부터 전체 시스템에 적용할 필요는 없습니다.

먼저 작은 시나리오 하나를 만드는 것이 좋습니다.

STEP 1. API 인증 토큰을 확인합니다

이싸인온 API 호출에는 인증 토큰이 사용됩니다.

CompanyID와 사용자 계정 정보를 이용해 토큰을 발급하고, 이후 요청의 Authorization Header에 해당 토큰을 사용합니다.

현재 개발자 문서 기준 인증 토큰의 유효기간은 1개월입니다.

STEP 2. 사용할 계약 서식을 정합니다

API를 통해 시작할 서식의 ID를 확인하고 어떤 필드에 어떤 데이터를 입력할지 정의합니다.

STEP 3. 테스트 계약 한 건을 만들어봅니다

ERP나 CRM의 테스트 데이터를 이용해 계약서를 생성하고 실제 서명 요청까지 진행합니다.

STEP 4. 상태 조회와 Webhook을 연결합니다

문서 상태 조회 API를 이용해 계약 진행 상황을 확인하고, 필요한 경우 Export API의 Callback URL을 설정해 상태 변경 정보를 받아봅니다.

STEP 5. 사내 챗봇과 연결합니다

계약 데이터가 내부 시스템에 안정적으로 쌓이는 것을 확인한 뒤 사내 AI 챗봇의 조회 기능과 연결합니다.

실제 운영 환경에 붙이기 전에 테스트할 수 있나요?

가능합니다.

이싸인온에서는 API 요금제 구매 전에 TESTAPI 환경을 기간 제한 없이 무료로 테스트할 수 있도록 제공하고 있습니다.

고객센터를 통해 TESTAPI 가입 링크를 받아 계정을 만든 뒤 API 기능을 확인할 수 있습니다.

처음에는 다음 정도의 작은 흐름부터 테스트하는 것이 좋습니다.

토큰 발급 → 서식 조회 → 테스트 문서 생성 → 서명 요청 → 상태 조회 → Webhook 수신 → 완료 문서 확인

이 흐름이 정상적으로 동작하는 것을 확인한 뒤 ERP나 CRM, AI 챗봇으로 연동 범위를 넓히면 개발 범위를 훨씬 명확하게 정할 수 있습니다.

AI 챗봇 연동 전에 무엇을 정해야 하나요?

기술 개발보다 먼저 챗봇이 어떤 계약 질문에 답해야 하는지를 정하는 것이 좋습니다.

예를 들어 다음과 같이 정의할 수 있습니다.

질문을 먼저 정하면 어떤 API가 필요하고 어떤 데이터를 내부 DB에 저장해야 하는지도 자연스럽게 결정됩니다.

반대로 모든 계약 데이터를 무조건 AI에게 제공하는 방식은 권장하기 어렵습니다.

계약에는 거래금액과 개인정보, 영업정보 등이 포함될 수 있으므로 챗봇 사용자의 권한에 따라 조회할 수 있는 계약 범위를 제한하는 구조를 함께 설계해야 합니다.

Webhook 연동 시 개발팀이 확인해야 할 것은 무엇인가요?

Export API를 이용하려면 문서를 시작할 때 export_api_info에 Callback URL을 지정합니다.

외부에서 접근할 수 있는 서버 엔드포인트가 필요하며, 요청 Header의 Authorization에 고객사가 정한 값을 포함하도록 설정할 수도 있습니다.

실제 서비스에 적용할 때는 회사의 보안·개발 기준에 맞춰 다음과 같은 사항을 별도로 설계하는 것이 좋습니다.

▪️Callback 요청 인증 방법

▪️동일 이벤트의 중복 처리 방지

▪️수신 실패 시 처리 방법

▪️사내 DB와 계약 상태의 정합성 확인

▪️계약 정보에 대한 사용자 권한 관리

▪️로그 및 오류 모니터링

이 가운데 중복 처리 방식이나 Retry 정책 등은 회사의 연동 구조에 따라 별도 설계가 필요한 영역입니다.

공식 API 문서에 명시되지 않은 보안·재시도 방식을 이싸인온의 기본 기능이라고 가정하기보다는 실제 개발 전에 API 문서와 기술 상담을 통해 확인하는 것이 좋습니다.

이싸인온 API로 실제 가능한 기능은 무엇인가요?

이싸인온 개발자 문서에서는 API를 통해 다음과 같은 업무를 지원하고 있습니다.

문서 생성·서명 요청

서식 기반으로 비대면 문서를 시작하고 수신인에게 서명을 요청할 수 있습니다.

사내 데이터 활용

ERP·CRM 등의 데이터를 서식 필드에 미리 입력해 계약서를 생성할 수 있습니다.

문서 관리

문서 목록·상세 조회뿐 아니라 취소, 재전송, 다운로드 등 계약 문서 생명주기의 여러 업무를 처리할 수 있습니다.

임베디드 서명

고객사가 운영하는 웹·앱 화면 안에서 전자서명 프로세스를 구성할 수 있습니다.

완료 데이터 활용

Export API를 통해 작성 필드값과 완료 상태 등을 외부 시스템으로 전달받아 후속 업무에 활용할 수 있습니다.

이 때문에 API 연동을 단순히 “계약서를 자동 발송하는 기능”으로만 볼 필요는 없습니다.

계약 전후의 데이터를 회사 내부 시스템과 이어주는 연결 수단에 가깝습니다.

전자계약 자동화는 어디까지 확장할 수 있을까요?

전자계약 자동화를 단계별로 생각하면 현재 우리 회사에 필요한 범위를 찾기 쉽습니다.

1단계 — 전자화

종이 계약을 전자서명으로 전환합니다.

2단계 — 데이터 연결

ERP·CRM·HRM의 데이터를 계약서에 자동 반영합니다.

3단계 — 상태 연결

계약 진행 상태와 완료 결과를 내부 시스템에서 확인합니다.

4단계 — 후속 업무 자동화

계약 완료를 기준으로 ERP 상태 변경, 문서 보관 등 다음 업무를 실행합니다.

5단계 — AI 조회

사내 AI 챗봇이 연결된 계약 데이터를 직원의 자연어 질문에 맞춰 조회합니다.

AI 챗봇이 계약 현황에 답하는 환경은 별도의 특별한 AI 계약 기능이라기보다 전자계약 데이터가 사내 업무 시스템과 제대로 연결되어 있을 때 가능한 다음 단계입니다.

“계약서 어디까지 됐나요?”를 시스템에게 물어보세요

전자계약 시스템을 도입해도 계약 현황을 확인할 때마다 담당자에게 메시지를 보내고 있다면 자동화할 영역이 아직 남아 있는 것입니다.

이싸인온 API를 이용하면 ERP·CRM 등의 데이터를 계약서에 연결하고 문서를 생성·발송한 뒤 상태와 완료 결과까지 내부 시스템에서 활용할 수 있습니다.

Export API의 Webhook을 이용하면 작성 완료·반려·취소 등의 상태 변화를 Callback URL로 전달받아 후속 업무를 시작하는 구조도 만들 수 있습니다.

그리고 그 위에 사내 AI 챗봇을 연결하면 계약 담당자가 매번 대신 조회하지 않아도

“A사 계약 어디까지 됐어?”

라는 질문에 시스템이 연결된 계약 데이터를 바탕으로 답하도록 구성할 수 있습니다.

AI 시대의 전자계약 자동화는 AI가 계약서를 대신 체결하는 것이 아니라,

필요한 계약 정보가 필요한 사람에게 자연스럽게 흐르도록 만드는 것에서 시작합니다.

이싸인온 TESTAPI에서 먼저 한 건의 계약 흐름을 연결해보고, 우리 회사에서 가장 많이 반복되는 조회 업무부터 API로 바꿔보세요.

오늘 시작하는 전자계약, 내일의 경쟁력이 됩니다.

전자계약이 필요할 때, 이싸인온

이싸인온은 기업의 계약 업무를 더 쉽고 체계적으로 관리할 수 있도록 돕는 전자계약 서비스입니다.

▪️22년의 서비스 경험을 바탕으로

▪️200만 명 이상의 사용자가 이싸인온을 이용했으며,

▪️100만 건 이상의 전자문서 서명이 완료되었습니다.

계약서 작성부터 발송, 서명, 완료 문서 관리까지

업무 환경에 맞는 다양한 전자계약 기능을 활용할 수 있습니다.

전자계약이 처음이어도 어렵지 않습니다

처음 전자계약을 도입하는 기업부터 여러 부서에서 반복적으로 계약을 처리하는 기업까지, 이싸인온을 업무 방식에 맞게 활용할 수 있습니다.

도입 방법이나 필요한 기능이 궁금하다면 이싸인온 고객센터에 문의해 주세요.

▪️ 채널톡 문의 하기

▪️ 전화 상담: 02-3444-4660

📢 실무자를 위한 전자계약, 이싸인온