Integrate Notion Notifications

개요

파일 전송 작업의 상태 변화를 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입니다.

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)

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