본문으로 건너뛰기

인바운드 등록 ​

웹사이트의 문의 폼을 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이메일·전화가 모두 없거나 필수값 누락
401API 키 누락 또는 무효
403content 권한 키 — 문의 접수가 허용되지 않아요
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_...)" }