노션 API 통합 발급받고 연결하기
Last updated
Last updated
노션 액션 사용을 위해 API 통합 발급받는 방법을 알려드리겠습니다. 간단한 입력만으로 발급이 가능하며 자세한 방법은 아래 순서를 참고해 주세요.
🔎Click! 이미지를 클릭하면 예시 화면을 크게 볼 수 있습니다.
노션 개발자 페이지의 my integration(https://www.notion.so/profile/integrations)에 접속합니다.
'새 API 통합'을 선택합니다.
Integration을 설정합니다.
관련 워크스페이스 선택(바티와 연동할 DB가 있는 워크스페이스 선택)
유형=프라이빗(internal) *퍼블릭(public)은 지원하지 않습니다
로고 업로드(선택, 필수 아님)
'저장'을 선택하여 API 통합을 생성합니다.
생성된 API 통합 상세페이지에서 아래 기능이 설정되어있는지 확인해주세요
<기능>의 <콘텐츠 기능>에서 콘텐츠 읽기, 콘텐츠 업데이트, 콘텐츠 입력이 체크되어 있는지 확인
<기능>의 <사용자 기능>에서 이메일 주소를 포함하는 사용자 정보를 읽습니다가 선택되어 있는지 확인
위 기능 설정이되어 있지 않으면 바티에서 노션 DB에 접근할 수가 없어서 자동화 설정이 불가능합니다. 꼭 확인해주세요!
'프라이빗 API 통합 시크릿'의 '표시' 클릭 후 시크릿 키를 '복사'합니다.
복사한 시크릿 키를 바티 액션설정의 'API 통합 시크릿'에 붙여넣고 계정을 연동합니다.
1) 바티의 프로젝트 리스트에서 '새 작업' - '바티엑셀'을 만드시고
2) 오른쪽 워크플로 검색창에서 '노션'을 검색한 뒤, 한 가지 액션을 눌러 추가해주세요
3) 액션의 톱니바퀴 아이콘을 눌러 설정창을 열어주세요.
4) 설정창에 노션 API 통합 정보를 입력하고 '노션 계정 연결하기'를 눌러 계정을 추가해주세요.
별칭 : API 통합 생성 시 입력한 이름 또는 계정을 구분할 수 있는 별칭을 자유롭게 입력해 주세요.
API 통합 시크릿 : 5단계 화면의 '프라이빗 API 통합 시크릿'를 '복사'하여 붙여넣어 주세요.
노션 API 통합 후 사용하려는 DB와 연결해야 바티 액션을 사용하실 수 있습니다. 개인 워크스페이스 페이지에서 간단한 설정을 통해 적용할 수 있으므로 아래 순서를 확인해 주세요.
🔎Click! 이미지를 클릭하면 예시 화면을 크게 볼 수 있습니다.
사용할 DB가 포함된 노션 페이지에 접속합니다.
페이지 우측 상단 더보기(점 3개)를 클릭합니다.
아래의 '연결' 파트에서 '연결 항목'을 선택합니다.
생성한 API 통합의 이름을 선택하여 해당 페이지와 연결합니다.
해당 페이지 URL을 복사합니다.
복사한 노션페이지 URL을 바티 액션에 붙여 넣고 확인을 클릭해주세요.
잠깐! 혹시 사용하시려는 DB에 관계형(relation) 속성이 포함되어 있나요?
그렇다면 관계형의 원본 DB가 포함된 페이지도 위 방법대로 노션 API 통합과 연결해주셔야 합니다. 관계형의 원본 DB에 또 관계형이 있다면 그 원본 DB가 포함된 페이지 역시 노션 API 통합과 연결이 필요해요.
노션 페이지 vs 데이터베이스 차이
노션 페이지 : 일반적인 노션 문서, 텍스트, 이미지, 체크리스트, 데이터베이스, 캘린더 등을 삽입할 수 있어요
URL은 https://www.notion.so/ + (숫자&알파벳)이 붙어있어요
예시 : https://www.notion.so/batiai/10b00cfebbfc800e8abbcd9326b87d73
노션 데이터베이스 : 인라인/전체페이지 2개 유형으로 나뉘며, 테이블/보드/캘린더/갤러리 뷰 등 다양한 형태로 볼 수 있어요
URL은 https://www.notion.so/ + (숫자&알파벳?v=숫자&알파벳)이 붙어있어요
예시 : https://www.notion.so/batiai/fff00cfebbfc81ce9207ccc06f04b133?v=fff00cfebbfc81428710000c4d6ed1dc&pvs=4
