아웃바운드 등록
먼저 컨택할 대상을 Cherpa 아웃바운드 목록에 넣는 쓰기 전용 API예요. 리드 수집 도구나 사내 스크립트에서 모은 대상을 콘솔에 일일이 입력하지 않고 바로 쌓을 수 있어요.
API 키를 Authorization: Bearer 헤더로 전달해 인증하고, 스페이스는 키에서 자동으로 결정돼요. full(전체 접근) 권한 키가 필요해요.
등록만 할 수 있어요. 아웃바운드 목록·상세 조회와 수정은 제공하지 않아요.
인증
bash
curl -X POST https://api.cherpa.me/v1/public/outbounds \
-H "Authorization: Bearer chp_..." \
-H "Content-Type: application/json" \
-d '{ "name": "박서준", "company": "루미너스 스튜디오", "channel": "email" }'아웃바운드 등록
POST/v1/public/outbounds
아웃바운드 목록에 새 건을 만들어요. 상태는 스페이스의 첫 상태(기본 미접촉)로, 담당자는 미배정으로 들어가요. 담당자 배정과 상태 변경은 콘솔 아웃바운드 관리에서 이어서 해요.
| 파라미터 | 설명 |
|---|---|
name | 필수. 고객명 — 컨택할 대상 (최대 255자) |
company | 회사명 |
email | 대상 이메일 |
phone | 대상 전화번호. 어떤 표기든 E.164(+8210…)로 정규화돼요 |
channel | 컨택 경로. 아래 값 중 하나, 생략하면 other |
notes | 제안 내용 (최대 5,000자) |
channel에 쓸 수 있는 값이에요.
| 값 | 의미 |
|---|---|
phone | 전화 |
email | 이메일 |
linkedin | 링크드인 |
dm | DM |
event | 행사 |
referral | 소개 |
other | 기타 (기본) |
중복 확인은 하지 않아요. 같은 대상을 두 번 보내면 두 건이 만들어지니, 재시도할 때는 호출하는 쪽에서 걸러 주세요.
반환 — 등록된 건의 id · name · status · created_at. status는 상태 키예요 (기본 not_started). 상태 코드 201.
| 상태 | 의미 |
|---|---|
400 | name 누락, 허용되지 않은 channel, 길이 초과 |
401 | API 키 누락 또는 무효 |
403 | full 권한이 아닌 키 |
429 | 같은 IP에서 1분에 60건 초과 |
서버에서 호출하세요
이 API는 full 권한 키가 필요해요. 키가 브라우저 번들에 들어가면 누구나 볼 수 있으니, 웹 페이지가 아니라 서버나 스크립트에서 호출하세요. 웹사이트 문의 폼처럼 브라우저에서 바로 보내야 한다면 인바운드 등록과 inquiry 권한 키를 쓰세요.
요청
bash
curl -X POST https://api.cherpa.me/v1/public/outbounds \
-H "Authorization: Bearer chp_..." \
-H "Content-Type: application/json" \
-d '{
"name": "박서준",
"company": "루미너스 스튜디오",
"email": "seojun.park@luminous.example",
"phone": "010-2345-6789",
"channel": "email",
"notes": "신규 오피스 이전 예정 — 인테리어 패키지 제안 메일 발송 대상"
}'응답 · 201
json
{
"id": "38e99fd0-dabd-4264-9977-1e5b5a5d8dc9",
"name": "박서준",
"status": "not_started",
"created_at": "2026-11-06T09:49:20Z"
}응답 · 403
json
{
"code": 7,
"message": "이 API 키에는 해당 권한이 없어요",
"detail": "이 API 키에는 해당 권한이 없어요"
}