인바운드 등록
웹사이트의 문의 폼을 Cherpa 통합문의함에 바로 연결하는 쓰기 전용 API예요. API 키를 Authorization: Bearer 헤더로 전달해 인증하고, 스페이스는 키에서 자동으로 결정돼요. full(전체 접근) 또는 inquiry(문의 접수) 권한 키로 호출할 수 있어요.
접수만 할 수 있어요. 문의 목록·상세 조회는 제공하지 않아서, 키가 브라우저 번들에 노출돼도 다른 고객의 문의가 읽히지 않아요.
인증
bash
curl -X POST https://api.cherpa.me/v1/public/inquiries \
-H "Authorization: Bearer chp_..." \
-H "Content-Type: application/json" \
-d '{ "name": "김하늘", "email": "haneul@example.com", "message": "견적 문의드려요" }'문의 접수
POST/v1/public/inquiries
통합문의함에 website 채널의 신규(new) 문의를 만들어요. 문의 내용은 고객이 보낸 첫 메시지로도 남아 상세 화면 타임라인에 바로 보여요.
| 파라미터 | 설명 |
|---|---|
name | 필수. 문의자 이름 |
message | 필수. 문의 내용 (최대 5,000자) |
email phone | 둘 중 하나는 필수. 전화번호는 어떤 표기든 E.164(+8210…)로 정규화돼요 |
company | 회사명. 같은 이름의 거래처가 있으면 거기에 묶이고, 없으면 새로 만들어요 |
title | 문의 제목. 비우면 내용 첫 줄(60자)로 만들어요 |
source_type | 사이트에서 구분하는 문의 유형 (예: quote, partnership). 자유 문자열 |
metadata | 문자열 값 맵. utm_source 등 — 통합문의함 UTM 필터가 utm_source를 읽어요 |
연락처 자동 연결 — 이메일 또는 전화가 같은 연락처가 이미 있으면 새로 만들지 않고 그 연락처에 문의를 붙여요. 처음에 비어 있던 연락 수단은 이번 값으로 채워지고, 기존 값은 덮어쓰지 않아요.
반환 — 접수된 문의의 id · title · status · created_at. 상태 코드 201.
| 상태 | 의미 |
|---|---|
400 | 이메일·전화가 모두 없거나 필수값 누락 |
401 | API 키 누락 또는 무효 |
403 | content 권한 키 — 문의 접수가 허용되지 않아요 |
429 | 같은 IP 에서 10분에 10건 초과 |
브라우저에서 직접 호출할 때
API 키는 번들에 포함되므로 노출된 셈이에요. 그래서 이 API 는 접수만 허용하고, 호출 IP 기준으로 폭주를 제한해요. 브라우저에 넣는 키는 inquiry 권한으로 발급하세요 — 노출돼도 문의 접수 말고는 아무것도 할 수 없어요. 더 엄격한 통제가 필요하면 서버에서 프록시해 호출하세요. 사이트 오리진은 Cherpa 에 CORS 허용 요청이 필요해요.
요청
bash
curl -X POST https://api.cherpa.me/v1/public/inquiries \
-H "Authorization: Bearer chp_..." \
-H "Content-Type: application/json" \
-d '{
"name": "김하늘",
"company": "루미너스 스튜디오",
"email": "haneul.kim@luminous.example",
"phone": "010-2345-6789",
"source_type": "quote",
"message": "성수동 신규 오피스 60평 인테리어 견적을 받고 싶어요.",
"metadata": { "utm_source": "naver", "utm_campaign": "office_fall", "page_url": "https://bridgeworks.example/contact" }
}'응답 · 201
json
{
"id": "0d6f3c2a-7b1e-4c8a-9f2d-1a2b3c4d5e6f",
"title": "성수동 신규 오피스 60평 인테리어 견적을 받고 싶어요.",
"status": "new",
"created_at": "2026-10-05T04:27:24Z"
}응답 · 401
json
{ "code": 16, "message": "API 키가 필요해요 (Authorization: Bearer chp_...)", "detail": "API 키가 필요해요 (Authorization: Bearer chp_...)" }