금융문서 풀이 기능을 앱에 임베드하세요

ConvoFin SDK는 약관, 대출 안내, 카드 혜택, 보험 설명서처럼 사용자가 이해하기 어려운 금융 텍스트를 분석하고 위험 문구를 하이라이트하는 B2B 임베드 도구입니다.

API Key 발급 브라우저 SDK 보기

브라우저 SDK

스크립트 한 줄로 기존 HTML 문서에 하이라이트와 바텀시트를 붙입니다.

React 컴포넌트

@convofin/sdk/react의 ConvoFinToggle로 React 앱에 바로 연결합니다.

API 엔드포인트

/api/v1/sdk/explain으로 서버 또는 앱에서 직접 분석 결과를 받을 수 있습니다.

설치

pnpm add @convofin/sdk

React 사용 예시

import { ConvoFinToggle } from '@convofin/sdk/react'

export function LoanTerms() {
  return (
    <ConvoFinToggle
      apiBase="https://convofin.pages.dev"
      token={userToken}
      tenantId="partner-bank"
      screenId="loan-terms"
      userMode="basic"
    >
      <section>
        <h2>대출 약관</h2>
        <p>중도상환수수료 및 변동금리 조건...</p>
      </section>
    </ConvoFinToggle>
  )
}

브라우저 SDK 사용 예시

<script type="module">
  import { createConvoFinOverlay } from '/sdk/index.js'

  createConvoFinOverlay({
    apiBase: 'https://convofin.pages.dev',
    token: userToken,
    tenantId: 'partner-bank',
    screenId: 'card-benefits',
    target: document.querySelector('#terms')
  })
</script>

REST API

POST /api/v1/sdk/explain
Authorization: Bearer USER_OR_PARTNER_TOKEN
Content-Type: application/json

{
  "tenantId": "partner-bank",
  "screenId": "loan-terms",
  "text": "분석할 금융문서 텍스트",
  "userMode": "basic"
}

응답 필드

필드	설명
`analysis.summary`	문서의 핵심 요약입니다.
`analysis.warningPoints`	주의 문구, 위험도, 쉬운 설명을 포함한 하이라이트 목록입니다.
`needsReview`	사용자에게 추가 확인을 권장해야 하는지 여부입니다.
`maskedCount`	분석 전에 마스킹된 개인정보 패턴 수입니다.

운영 메모

API Key 원문은 최초 발급 응답에서만 표시됩니다. 이후에는 해시와 마스킹된 식별자만 저장되므로 포털에서 재조회할 수 없습니다.