엔드포인트
Public API의 모든 엔드포인트를 메서드·경로·필요한 scope별로 모아 둔 목록입니다. 경로는 Base URL 뒤에 붙여서 호출합니다. 상세 페이지 링크를 따라가면 엔드포인트별 요청 파라미터와 응답 필드를 볼 수 있습니다.
- 읽기(
GET): 워크스페이스 데이터를 server-to-server로 읽어옵니다./search는 색인된 메시지 본문을 검색하고,/workflows는 워크스페이스의 워크플로 목록을 반환합니다. 태그 목록은 연락처(/contact-tags)와 상담(/channel-tags)이 별개입니다. - 쓰기(
POST·PATCH·PUT·DELETE): 답장 전송, 채널 조작(읽음·종료·재오픈·배정·상담 태그 부여·해제·상담 메모 쓰기), 연락처 생성·수정, outbound 웹훅 관리를 수행합니다.
| Method | Path | Scope | 문서 |
|---|---|---|---|
GET | /workspace | workspaces:read | 상세 |
GET | /members | members:read | 상세 |
GET | /members/{id} | members:read | 상세 |
GET | /teams | teams:read | 상세 |
GET | /teams/{id}/members | teams:read | 상세 |
GET | /contacts | contacts:read | 상세 |
GET | /contacts/{id} | contacts:read | 상세 |
GET | /contacts/{id}/tags | contacts:read | 상세 |
POST | /contacts | contacts:write | 상세 |
PATCH | /contacts/{id} | contacts:write | 상세 |
POST | /contacts/{id}/tags | contacts:write | 상세 |
DELETE | /contacts/{id}/tags | contacts:write | 상세 |
PUT | /contacts/{id}/sms-consent | contacts:write | 상세 |
GET | /contact-tags | contact-tags:read | 상세 |
GET | /channel-tags | channel-tags:read | 상세 |
GET | /channels (?tags=·?tag_match= 필터) | channels:read | 상세 |
GET | /channels/{id} | channels:read | 상세 |
GET | /channels/{id}/messages | channels:read + messages:read | 상세 |
GET | /messages/{id} | messages:read | 상세 |
GET | /board/answer-changes | channels:read + messages:read | 상세 |
GET | /attachments/{id} | attachments:read + messages:read | 상세 |
GET | /macros | macros:read | 상세 |
GET | /hours | hours:read | 상세 |
GET | /integrations | integrations:read | 상세 |
GET | /campaigns | campaigns:read | 상세 |
GET | /campaigns/{id} | campaigns:read | 상세 |
GET | /tasks | tasks:read | 상세 |
GET | /tasks/{id} | tasks:read | 상세 |
GET | /search | search:read | 상세 |
GET | /inbound-webhook-configs | inbound-webhook-configs:read | 상세 |
GET | /ai-agents | ai-agents:read | 상세 |
GET | /voice/calls | voice:read | 상세 |
GET | /workflows | workflows:read | 상세 |
POST | /channels/{id}/messages | messages:write | 상세 |
POST | /channels/{id}/read | channels:write | 상세 |
POST | /channels/{id}/close | channels:write | 상세 |
POST | /channels/{id}/reopen | channels:write | 상세 |
POST | /channels/{id}/assign | channels:write | 상세 |
POST | /channels/{id}/tags | channels:write | 상세 |
DELETE | /channels/{id}/tags | channels:write | 상세 |
PUT | /channels/{id}/consultation-memo | channels:write | 상세 |
GET | /outbound-webhooks | webhooks:read | 상세 |
POST | /outbound-webhooks | webhooks:write | 상세 |
GET | /outbound-webhooks/{id} | webhooks:read | 상세 |
PATCH | /outbound-webhooks/{id} | webhooks:write | 상세 |
DELETE | /outbound-webhooks/{id} | webhooks:write | 상세 |
POST | /outbound-webhooks/{id}/regenerate-secret | webhooks:write | 상세 |
POST | /outbound-webhooks/{id}/toggle | webhooks:write | 상세 |
GET | /outbound-webhooks/{id}/delivery-logs | webhooks:read | 상세 |
쓰기 엔드포인트의 동작(하이브리드 발신 주체·권한·멱등)은 메시지·채널 쓰기와 Outbound Webhooks 관리를 참고하세요. 상담 콘솔을 붙이는 전체 흐름은 상담 콘솔 임베드 가이드에 있습니다.
인증, 스코프, 페이지네이션, 에러, 요청 한도는 모든 엔드포인트에 똑같이 적용됩니다.
응답에서 빠지는 정보
아래 엔드포인트는 민감한 값을 응답에 싣지 않습니다.
| 엔드포인트 | 응답에서 빠지는 값 |
|---|---|
integrations | 시크릿 |
ai-agents | 프롬프트, LLM API 키 |
voice/calls | 녹취 URL |
inbound-webhook-configs | 서명 시크릿 |
outbound-webhooks | 서명 시크릿. 생성·회전 응답에서만 한 번 보여 줍니다. |