엔드포인트
Public API는 읽기(GET)와 쓰기(POST·PATCH·DELETE) 엔드포인트를 모두 제공합니다.
- 읽기: 워크스페이스 데이터를 server-to-server로 읽어옵니다.
/search는 색인된 메시지 본문을 검색하고,/workflows는 워크스페이스의 워크플로 목록을 반환합니다. - 쓰기 · outbound-webhook 관리: 답장 전송·채널 조작(읽음/종료/재오픈/배정)과 이벤트 webhook 관리를 수행합니다.
| 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 | 상세 |
GET | /contact-tags | contact-tags:read | 상세 |
GET | /channels | channels:read | 상세 |
GET | /channels/{id} | channels:read | 상세 |
GET | /channels/{id}/messages | channels:read + messages:read | 상세 |
GET | /messages/{id} | 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 | 상세 |
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 에이전트(ai-agents)는 프롬프트·키, 음성(voice/calls)은 녹취 URL, 인바운드 웹훅 설정(inbound-webhook-configs)은 서명 시크릿, outbound 웹훅(outbound-webhooks)은 서명 시크릿(생성·회전 응답에서만 1회 노출)을 노출하지 않습니다.