{
  "slug": "ref/manual/content-launcher-콘텐츠-런처-notion",
  "doc_type": "ref",
  "title": "Notion — Content Launcher (콘텐츠 런처)",
  "title_en": null,
  "one_liner": "Notion 개요 — Notion 위키 발행 노션 \\ \\ 데이터베이스(DB)\\ \\ 에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다. 발행하려면 세 가지가 필요합니다: ① 통합 토큰 ② 대",
  "summary_bullets": [
    "Notion 데이터베이스에 위키 글을 페이지(행)로 자동 발행하는 기능에 대한 안내 문서입니다.",
    "본문은 Markdown이 Notion 블록으로 자동 변환되며 차트·표·다이어그램은 이미지로 삽입됩니다.",
    "발행을 위해서는 통합 토큰(notion_token), 대상 DB에 통합 연결, database_id 세 가지가 필요합니다.",
    "통합 토큰 발급, DB에 통합 연결(공유), URL에서 database_id 확인하는 절차를 단계별로 설명합니다.",
    "404·401 오류 등 자주 발생하는 문제와 원인, 그리고 설정 시 권장 사항을 안내합니다."
  ],
  "body_md": "# Notion\n\n**개요 — Notion 위키 발행**\n\n노션 \\*\\*데이터베이스(DB)\\*\\*에 위키 글을 페이지(행)로 발행합니다. 본문은 Markdown → Notion 블록으로 자동 변환되고, 차트·표·다이어그램은 이미지로 들어갑니다.\n\n발행하려면 세 가지가 필요합니다: ① **통합 토큰** ② **대상 DB를 통합에 연결(공유)** ③ **database\\_id**. 아래 \\[토큰 발급 · DB 연결 · DB ID 확인]을 따라 설정하세요.\n\n**필수 필드 — 필수 필드**\n\n* **notion\\_token** — 통합 시크릿. `ntn_` 또는 `secret_` 로 시작합니다.\n* **database\\_id** — 발행 대상 노션 데이터베이스 ID(32자리).\n* **category\\_prop** (선택) — 카테고리를 기록할 DB 속성명(예: `분류`, `태그`).\n\n**토큰/인증 발급 — 토큰 발급 · DB 연결 · DB ID 확인**\n\n### 1) 통합 토큰 발급\n\n1. **https://www.notion.so/my-integrations** 접속 (또는 노션 좌하단 **설정 → Connections → 통합 개발/관리**)\n2. 기존 통합 선택, 또는 **+ New integration**으로 생성(워크스페이스 선택, Capabilities에 **Read content + Insert content** 체크)\n3. **Configuration** 탭 → **Internal Integration Secret** → **Show → Copy** → `notion_token`에 입력 (`ntn_…`)\n\n### 2) 통합을 대상 DB에 연결(공유) — 필수\n\n> 통합이 그 DB에 접근 권한이 없으면 토큰이 맞아도 **404**가 납니다.\n\n1. 발행할 **데이터베이스를 full page로 열기**\n2. 우측 상단 **···(More) → Connections(연결)** → 위에서 만든 통합 선택해 추가\n\n### 3) database\\_id 확인 (URL에서)\n\n* 데이터베이스를 full page로 연 상태의 주소창 URL: `https://www.notion.so/{워크스페이스}/{32자리DB ID}?v={뷰ID}`\n* **`?v=` 바로 앞 32자리**가 database\\_id 입니다(대시 없어도 됨).\n* ⚠️ URL에 **`?v=` 가 있어야 데이터베이스**입니다. 없으면 _페이지_ ID라 발행이 안 됩니다.\n* **인라인 데이터베이스**는 제목 옆 **⤢(open as full page)** 로 펼친 뒤 URL을 확인하세요.\n\n### 4) 입력 · 확인\n\n* 연결 정보 탭에 `notion_token` · `database_id` · (선택)`category_prop` 입력 → 저장.\n* 통합이 보는 DB가 맞는지 확실치 않으면, 대상 DB를 2)처럼 연결했는지 다시 확인하세요.\n\n**자주 발생하는 오류 — 자주 발생하는 오류**\n\n* **404 object\\_not\\_found / Could not find database** — 통합이 그 DB에 **공유되지 않음**(2단계 누락), 또는 _페이지_ ID를 넣음(데이터베이스 ID 필요 — URL의 `?v=` 확인).\n* **401 unauthorized / API token is invalid** — 토큰 오류·만료. my-integrations에서 시크릿 재확인.\n* **category\\_prop이 반영 안 됨** — DB에 그 속성명이 없거나 타입 불일치. DB 속성명을 정확히(대소문자) 입력.\n\n**권장 사항 — 권장 사항**\n\n* **데이터베이스 ID**를 사용하세요(페이지 ID 아님) — URL의 `?v=` 앞 32자리.\n* 통합 Capabilities에 **Insert content** 포함.\n* 노션 위키는 **대표(특성)이미지·CTA를 사용하지 않고**, 3줄 요약·FAQ·도입부 인포그래픽은 본문에 포함됩니다.\n",
  "related_slugs": [],
  "keywords": [],
  "faq": [
    {
      "a": "https://www.notion.so/my-integrations 에 접속하거나 노션 좌하단 설정 → Connections → 통합 개발/관리에서 발급받을 수 있습니다. 기존 통합을 선택하거나 New integration으로 새로 생성한 뒤, Configuration 탭의 Internal Integration Secret을 복사해 입력하면 됩니다. 토큰은 ntn_ 또는 secret_ 로 시작합니다.",
      "q": "notion_token은 어디서 발급받나요?"
    },
    {
      "a": "데이터베이스를 full page로 연 상태의 주소창 URL에서 ?v= 바로 앞 32자리가 database_id입니다. URL에 ?v=가 없으면 페이지 ID이므로 발행이 되지 않으니, 인라인 데이터베이스라면 제목 옆 ⤢ 아이콘으로 full page로 펼친 뒤 확인해야 합니다.",
      "q": "database_id는 어떻게 확인하나요?"
    },
    {
      "a": "통합이 해당 데이터베이스에 공유(연결)되지 않았을 가능성이 큽니다. 데이터베이스를 full page로 열고 우측 상단 ···(More) → Connections에서 만든 통합을 추가로 연결해야 합니다. 또한 페이지 ID를 database_id로 잘못 입력한 경우에도 발생하니 URL의 ?v= 여부를 확인하세요.",
      "q": "토큰과 database_id를 맞게 넣었는데 404 오류가 나요. 왜 그런가요?"
    },
    {
      "a": "토큰이 잘못됐거나 만료된 경우입니다. my-integrations 페이지에서 시크릿을 다시 확인하고 재발급받아 입력하세요.",
      "q": "401 unauthorized 오류가 뜨는 경우는 어떻게 해결하나요?"
    },
    {
      "a": "DB에 해당 속성명이 없거나 속성 타입이 맞지 않는 경우입니다. DB에 설정된 속성명을 대소문자까지 정확히 입력해야 합니다.",
      "q": "category_prop 값이 DB에 반영되지 않아요."
    }
  ],
  "jsonld": null,
  "image_url": null,
  "caption": null,
  "width": null,
  "height": null,
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "solution_slug": null,
  "source_id": "gitbook:UzjWwGASsQFDcNaCAGUu:EJCLcwCRJh2xY9umFfwI",
  "created_at": "2026-08-23T14:32:39.611542+00:00",
  "updated_at": "2026-09-03T08:08:20.394+00:00",
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-notion",
  "markdown_url": "https://bizspring.ai/kb/ref/manual/content-launcher-콘텐츠-런처-notion.md"
}