인증과 리드 인입 API

외부 폼·챗봇·웹사이트의 리드/문의를 sufly® CRM으로 밀어 넣는 공개 API 레퍼런스입니다.

🔑 인증과 리드 인입 API 외부 폼·챗봇·웹사이트의 리드/문의를 sufly® CRM으로 밀어 넣는 공개 API 레퍼런스입니다. 1️⃣ 인증 모든 요청은 테넌트가 발급한 API 키 로 인증합니다. API 키 발급 (앱에서) — 테넌트 관리자가 테넌트 관리 > 연동 > API 키 에서 발급합니다. scope: inbound:write (기본) 발급 시 원문 키는 그 한 번만 표시됩니다(저장은 SHA-256 해시). 안전한 곳에 보관하세요. 폐기하면 즉시 무효화됩니다. 인증 헤더 — 아래 둘 중 하나를 씁니다(동일 효과): X-API-Key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY 키가 어느 테넌트 것인지로 인입 대상 테넌트가 결정됩니다. 키 없음·오류 시 401 . 레이트리밋 — 발신 IP 기준으로 제한이 걸립니다. 초과 시 429 (잠시 후 재시도). 대량 전송은 지수 백오프를 권장합니다. 2️⃣ 리드 인입 — POST /api/webhooks/inbound 외부에서 받은 문의를 CRM 리드(또는 사전 리드 수신함)로 넣습니다. Base URL : https://pp.sufly.net Content-Type : application/json 요청 필드 라우팅 규칙 — completeness="full" 이고 category 가 tech_support 가 아니면 리드 직접 생성 . 그 밖(부분·지원 성격)은 사전 리드 수신함 에 쌓였다가 사람이 보강·승격합니다. 회사는 이름으로 자동 match-or-create 됩니다. 요청 예제 curl -X POST https://pp.sufly.net/api/webhooks/inbound \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "externalId": "web-2026-000123", "source": "homepage-form", "category": "sales", "completeness": "full", "contact": { "company": "샘플컴퍼니", "name": "홍길동", "phone": "010-1234-5678", "email": "hong@example.com" }, "detail": { "message": "도입 견적 문의드립니다.", "answers": [ { "label": "관심 제품", "va