Notion 알림 연동

개요#

파일 전송 작업의 상태 변화를 Notion에 자동으로 기록하려면 Notion 알림을 연동할 수 있습니다.

연동을 완료하면 전송이 시작(Started), 완료(Completed), 실패(Failed) 되는 등 지정한 이벤트가 발생할 때마다 지정한 Notion 데이터베이스에 알림 항목이 자동으로 추가됩니다.

전체 과정은 ① Notion 통합 생성 및 토큰 발급 → ② 데이터베이스 연결 및 Database ID 확인 → ③ 제품에서 알림 설정 순으로 진행됩니다.

준비 사항#

시작하기 전에 다음 사항을 확인하세요.

Notion 통합 생성 및 토큰 발급#

Notion으로 알림을 받으려면 먼저 Notion 통합(Integration)을 생성하고 발급된 토큰을 사용합니다.

Step 1. 통합 생성#

https://www.notion.so/my-integrations 에 접속한 후 + New integration을 선택합니다.

또는 Notion 설정의 Connections 메뉴에서도 접근할 수 있습니다.

통합 유형은 내부(Internal) 로 두고 이름을 입력한 뒤(예: INNORIX CONNECTION) 연결할 워크스페이스를 선택합니다.

Step 2. 권한(Capabilities) 설정#

알림 항목을 데이터베이스에 추가할 수 있도록 최소한 콘텐츠 읽기(Read content) 와 콘텐츠 삽입(Insert content) 권한을 활성화한 뒤 저장합니다.

Step 3. 토큰 복사#

Internal Integration Token(내부 통합 시크릿)을 복사합니다. 토큰은 ntn_으로 시작합니다.

ℹ️ 이 토큰은 비밀번호와 같은 정보입니다. 값을 알고 있는 사람은 연결된 데이터에 접근할 수 있으므로 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다. 토큰이 유출된 경우에는 Integration 설정에서 다시 발급(Refresh)할 수 있습니다.

확인 사항#

• ✔ 내부 통합이 생성되었습니다.
• ✔ 필요한 권한이 설정되었습니다.
• ✔ Internal Integration Token을 복사했습니다.

데이터베이스 연결 및 Database ID 확인#

통합은 생성만으로는 데이터베이스에 접근할 수 없습니다.

알림을 기록할 데이터베이스에 통합을 연결한 뒤 Database ID를 확인합니다.

Step 1. 데이터베이스에 통합 연결#

알림을 기록할 Notion 데이터베이스를 전체 페이지로 엽니다.

우측 상단의 ••• 메뉴에서 연결 추가(Add connections) 를 선택한 후, 통합 생성에서 생성한 Integration을 검색하여 연결합니다.

Step 2. Database ID 확인#

데이터베이스를 전체 페이지로 연 상태에서 브라우저 주소창의 URL을 확인합니다.

워크스페이스 이름 뒤의 /와 ?v= 사이에 있는 32자리 문자열이 Database ID입니다.

https://app.notion.com/p/3b45f9584aaa8018b99ed8a0c558ba2c?v=...
                        └──────── Database ID ────────┘

Database ID는 원본 데이터베이스의 ID여야 합니다.

인라인 데이터베이스 또는 링크된 데이터베이스 뷰의 ID는 사용할 수 없습니다.

URL에 ?v=가 포함되어 있다면 데이터베이스 뷰이며, 일반 페이지 ID를 입력하면 연결에 실패합니다.

확인 사항#

• ✔ 통합이 대상 데이터베이스에 연결되었습니다.
• ✔ Database ID를 복사했습니다.

Notion 알림 설정#

발급받은 토큰과 Database ID를 제품의 알림 설정에 입력합니다.

Notifications 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Internal Integration Token 입력#

Internal Integration Token 항목에 통합 생성에서 복사한 토큰을 붙여넣습니다.

Step 2. Database ID 입력#

Database ID 항목에 확인한 Database ID를 붙여넣습니다.

Step 3. 알림 이벤트 선택#

Events 항목에서 알림을 받을 이벤트를 선택합니다.

여러 개를 선택할 수 있으며, 선택한 이벤트가 발생할 때만 데이터베이스에 새로운 항목이 추가됩니다.

Step 4. 설정 저장#

입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.

확인 사항#

• ✔ Internal Integration Token이 입력되었습니다.
• ✔ Database ID가 입력되었습니다.
• ✔ 알림받을 이벤트가 선택되었습니다.

연동 확인#

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생#

실제 전송 작업을 실행하거나 선택한 이벤트 중 하나를 발생시킵니다.

Step 2. Notion 데이터베이스 확인#

지정한 Notion 데이터베이스에 새로운 알림 항목이 생성되었는지 확인합니다.

확인 사항#

• ✔ 데이터베이스에 알림 항목이 추가되었습니다.
• ✔ 발생한 이벤트가 정확하게 기록되었습니다.

설정 완료#

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 지정한 Notion 데이터베이스에 알림 항목이 자동으로 추가됩니다.

문제 해결 (Troubleshooting)#

알림 항목이 생성되지 않는 경우 아래 항목을 확인하세요.