본문으로 건너뛰기

인바운드 웹훅 설정

목록 조회​

GET /inbound-webhook-configs — 워크스페이스에 연결된 공급사 인바운드 웹훅 설정 목록을 cursor pagination으로 조회합니다.

  • Scope: inbound-webhook-configs:read
  • 쿼리: limit(기본 50, 최대 100), cursor

limit이 [1, 100] 범위를 벗어나면 400 INVALID_QUERY로 거부됩니다(자동 보정 없음). cursor는 발급 후 24시간이 지나면 만료됩니다.

이 목록은 공급사로 필터링하지 않고 워크스페이스의 모든 연동을 반환합니다 — GET /integrations와 동일한 행 집합에 webhook_url·icon_url이 추가된 형태입니다. 인바운드 웹훅 경로가 없는 공급사(web·email)의 행도 포함되며, 이 경우 webhook_url 키는 생략됩니다.

curl "https://api.talk.zeroworks.ai/api/public/v1/inbound-webhook-configs?limit=50" \
  -H "Authorization: Bearer ztpat_..."

응답

{
  "success": true,
  "data": [
    {
      "id": "9f8e7d6c-...",
      "name": "카카오 채널 상담",
      "provider": "kakao",
      "status": "active",
      "webhook_url": "https://api.talk.zeroworks.ai/webhooks/kakao/abc123...",
      "icon_url": "https://cdn.zeroworks.ai/icons/kakao.png",
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-05-01T10:00:00Z"
    }
  ],
  "meta": { "has_more": false }
}

has_more가 true이면 응답의 meta.next_cursor(예: "eyJ...")를 다음 요청의 ?cursor=로 전달해 다음 페이지를 조회합니다. 마지막 페이지에서는 next_cursor가 생략됩니다.

webhook_url은 공급사 콘솔(Kakao/LINE 등)에 등록해야 할 수신 URL을 그대로 노출합니다. 고객이 "내가 등록한 URL이 맞는지" 대조할 수 있도록 의도적으로 공개되며, 모든 인바운드 요청은 HMAC 서명으로 검증되므로 URL만으로는 위조 전송이 불가능합니다. webhook_url과 icon_url은 미설정 시 null이 아니라 응답 객체에서 키가 생략됩니다 ("key" in obj로 판별).

서명 검증에 쓰이는 signing_secret(및 webhook token, vendor 자격증명, config)은 응답에 포함되지 않습니다. 이 값들은 SQL 단계에서 아예 조회되지 않으므로 공개 API로 노출되지 않습니다.

필드​

필드설명
name사용자가 지정한 연동 이름
provider연동 공급사 (아래 값 집합 참조)
status연동 상태 (아래 값 집합 참조)
icon_url연동 아이콘 URL (미설정 시 키 생략)

provider와 status는 DB CHECK 제약으로 고정된 닫힌 집합이므로 아래 값 외에는 반환되지 않습니다.

필드값 집합
providerweb · kakao · line · whatsapp · instagram · sms · email · naver
statusactive · inactive · error · pending · awaiting_setup · awaiting_activation