Notion 연결 가이드

이 연동으로 할 수 있는 것

• Soha 노션 템플릿을 내 Notion database에 연동합니다.
• 발행 후 원문 URL을 Soha와 연결합니다.
• 카테고리별로 같은 database를 기준으로 동기화합니다.

미리 준비할 것

• 연결할 Notion database
• 해당 database에 접근 가능한 Notion integration
• 실제 글이 공개되는 배포 주소

Notion에서 값을 찾는 방법

1. Database ID 찾기

1. 연결할 database를 전체 페이지로 엽니다.
2. 브라우저 주소창이나 공유 링크를 확인합니다.
3. 마지막에 있는 UUID 형태 값을 복사합니다.

예시:

• 758b60d346a74a61adecd0c6d23e6872
• 758b60d3-46a7-4a61-adec-d0c6d23e6872

페이지 ID가 아니라 database ID여야 합니다.

2. Integration Token 찾기

1. Notion에서 Settings & members → Connections → Develop or manage integrations로 이동합니다.
2. 사용할 integration을 선택하거나 새로 만듭니다.
3. Internal Integration Token 값을 복사합니다.

3. Database 공유 확인하기

1. database 우측 상단의 Share를 엽니다.
2. 생성한 integration을 초대합니다.
3. integration이 해당 database에 접근할 수 있는지 확인합니다.

4. 배포 주소 확인하기

실제 방문자가 보는 사이트 주소를 넣습니다.

예시:

• https://example.com/blog
• https://content.example.com

Soha에 어디에 입력하나요?

자주 틀리는 값 / 주의사항

• 상위 페이지 ID를 넣으면 동작하지 않습니다.
• Notion 공유를 하지 않으면 token이 맞아도 쓰기 실패가 납니다.
• 배포 주소에는 Notion URL이 아니라 공개 블로그 주소를 넣어야 합니다.

연결 확인 방법

1. wizard Step 3 입력을 저장합니다.
2. 테스트 발행 또는 초안 저장을 실행합니다.
3. Notion database에 새 페이지가 생성되는지 확인합니다.

문제 해결

권한 오류가 나와요

• integration이 database에 초대되었는지 다시 확인하세요.

ID 형식이 맞지 않는다고 나와요

• URL 전체가 아니라 UUID 부분만 넣었는지 확인하세요.

발행 주소가 이상하게 연결돼요

• 공개 주소에 관리자 URL이나 Notion URL을 넣지 않았는지 확인하세요.