API 참조

모든 API 요청은 X-Api-Key 헤더에 전송된 API 키를 사용하여 인증됩니다.

API 키 얻기

1. 대시보드에서 설정 → API 키로 이동
2. API 키 만들기를 클릭하고 이름 지정
3. 키를 즉시 복사하세요 — 한 번만 표시됩니다
4. 안전하게 저장하세요 (환경 변수, 비밀 관리자)

요청 만들기

모든 요청에 키를 포함하세요:

curl -H "X-Api-Key: tak_your_key_here" \
     https://api.enuchat.com/api/v1/tenant-api/widgets

모든 응답은 JSON입니다. 성공적인 응답에는 data 필드가 있습니다. 오류에는 code 및 message가 있는 error 필드가 있습니다.

보안: API 키는 데이터베이스에서 해시됩니다 (SHA-256). 원시 키를 저장하지 않습니다. 키를 비밀번호처럼 취급하세요 — 코드에 커밋하거나 공개적으로 공유하지 마세요.

GET /widgets

계정의 모든 위젯 나열.

응답

{'{'}
  "data": [
{'{'}
      "id": "019d19c6-7e0b-...",
      "name": "Main Website Chat",
      "isActive": true,
      "aiEnabled": true,
      "translationEnabled": true,
      "primaryColor": "#2563eb",
      "position": "bottom-right"
    }
  ]
}

GET /conversations

최근 메시지별로 정렬된 대화 나열.

쿼리 매개변수

예제

curl -H "X-Api-Key: tak_..." \
     "https://api.enuchat.com/api/v1/tenant-api/conversations?status=open&limit=10"

응답

{'{'}
  "data": [
{'{'}
      "id": "019d6724-000e-...",
      "widgetId": "019d19c6-7e0b-...",
      "visitorId": "v-abc123",
      "visitorName": "John",
      "visitorEmail": "john{'@'}example.com",
      "visitorLanguage": "en",
      "status": "open",
      "assignedTo": null,
      "lastMessageAt": "2026-04-11T14:30:00+00:00",
      "startedAt": "2026-04-11T14:25:00+00:00"
    }
  ]
}

GET /conversations/{'{'}id}

모든 메시지와 함께 대화 가져오기.

쿼리 매개변수

응답

{'{'}
  "data": {'{'}
    "id": "019d6724-000e-...",
    "visitorLanguage": "en",
    "status": "open",
    "messages": [
{'{'}
        "id": "019d6724-1234-...",
        "role": "visitor",
        "content": "Hello, how much does it cost?",
        "contentLanguage": "en",
        "translatedContent": "Cześć, ile to kosztuje?",
        "translatedLanguage": "pl",
        "isAutoReply": false,
        "createdAt": "2026-04-11T14:25:30+00:00"
      },
{'{'}
        "id": "019d6724-5678-...",
        "role": "ai",
        "content": "Our plans start at €19/month...",
        "isAutoReply": true,
        "createdAt": "2026-04-11T14:25:32+00:00"
      }
    ]
  }
}

POST /conversations/{'{'}id}/messages

대화에 메시지를 보냅니다. 메시지는 채팅 위젯을 통해 방문자에게 실시간으로 전달됩니다.

요청 본문

{'{'}
  "content": "Thanks for reaching out! We'll process your request.",
  "role": "system"
}

응답 (201 Created)

{'{'}
  "data": {'{'}
    "id": "019d6725-abcd-...",
    "role": "system",
    "content": "Thanks for reaching out!",
    "createdAt": "2026-04-11T14:35:00+00:00"
  }
}

PATCH /conversations/{'{'}id}

대화의 상태 또는 할당 업데이트.

요청 본문

{'{'}
  "status": "closed"
}

GET /billing/balance

현재 요금제 및 크레딧 잔액 가져오기.

응답

{'{'}
  "data": {'{'}
    "plan": "pro",
    "creditBalance": 4500000,
    "totalCreditsAdded": 10000000
  }
}

CRM 통합

새 대화를 폴링하고 방문자 데이터 (이름, 이메일, 언어)를 CRM에 동기화하세요. 대화 ID를 외부 참조로 사용하세요.

자동화된 후속 조치

대화가 종료된 후 API를 통해 후속 메시지를 보내세요: „채팅 감사합니다! 더 도움이 필요한 것이 있나요?"

Webhook 대안

발신 웹훅을 사용할 수 있을 때까지 대화 엔드포인트를 주기적으로 폴링하여 새 메시지나 상태 변경을 감지하세요.

대량 작업

7일보다 오래된 모든 대화 닫기, 외부 논리에 따라 운영자에게 대화 할당 또는 분석을 위해 대화 기록 내보내기.