반복 업무 탈출! 노션 API 자동화 예제 모음

매일 반복되는 데이터 입력, 복사 붙여넣기 작업에 지치셨나요? 노션 API 자동화 예제를 찾고 있지만 어디서부터 시작해야 할지 막막하신가요?

함께 보면 좋은 글: ChatGPT API, 처음 써보는데 막막할 때: 3단

이런 반복적인 업무는 우리의 시간과 에너지를 소모시키며, 정작 중요한 일에 집중할 기회를 빼앗아 갑니다.

이 글에서는 노션 API를 활용하여 반복 업무를 자동화할 수 있는 구체적인 예제와 설정 방법을 단계별로 제시하여, 여러분의 생산성을 극대화할 수 있도록 돕겠습니다.

반복 업무의 늪: 노션 API 자동화 예제가 필요한 이유

많은 직장인들이 매일같이 겪는 문제입니다. 엑셀 시트에서 복사한 데이터를 노션 페이지에 붙여넣거나, 특정 정보를 여러 곳에 동일하게 입력하는 작업은 시간은 물론이고 정신적인 피로감까지 유발합니다.

이러한 반복 작업은 오류 발생 가능성을 높이며, 창의적인 사고나 문제 해결에 집중해야 할 시간을 빼앗아 갑니다. 결국 업무 효율성 저하로 이어지는 악순환을 반복하게 됩니다.

실제 사용자들은 이러한 문제에 대해 이렇게 말합니다. "슬랙이나 트렐로 이런 거는 어차피 조직 구성원들이 안 쓰니 쓸모도 없었고 노션으로 하나씩 기술 익힘 · 마크다운도 이 때 많이 씀. n8n, make 같은 자동화 공부도 하는 중." (출처: dcinside.com) 이는 노션과 같은 도구를 활용한 자동화 학습의 필요성을 보여줍니다.

노션 API는 이러한 반복 업무를 해결할 수 있는 강력한 도구입니다. API를 활용하면 외부 프로그램이나 스크립트를 통해 노션 데이터베이스에 직접 접근하고 데이터를 생성, 수정, 삭제하는 등의 작업을 자동화할 수 있습니다. 이를 통해 우리는 지루한 수작업에서 벗어나 더 가치 있는 업무에 집중할 수 있습니다.

Photo by Markus Winkler on Pexels

노션 API 자동화 예제 1: 새로운 데이터 자동 입력

가장 흔하게 자동화할 수 있는 시나리오는 새로운 데이터를 노션 데이터베이스에 자동으로 추가하는 것입니다. 예를 들어, 웹사이트에서 수집한 고객 문의, 설문 조사 결과, 또는 간단한 폼 제출 데이터를 자동으로 노션에 기록하는 경우입니다.

이 예제에서는 파이썬 스크립트를 사용하여 특정 웹사이트의 데이터를 주기적으로 가져와 노션 데이터베이스의 새 페이지로 저장하는 방법을 다룹니다. 이를 위해 requests 라이브러리로 웹 데이터를 가져오고, notion_client 라이브러리로 노션 API와 통신합니다.

필요한 준비물:

• 1. 노션 통합 토큰 발급: 노션 개발자 페이지에서 통합 토큰을 생성합니다. 이 토큰은 API 요청 시 인증에 사용됩니다.
• 2. 대상 노션 데이터베이스 ID 확인: 데이터를 추가할 노션 데이터베이스의 고유 ID를 확인합니다. URL에서 확인할 수 있습니다.
• 3. 파이썬 환경 설정: 파이썬이 설치되어 있고, pip를 통해 requests와 notion_client 라이브러리를 설치해야 합니다.

먼저, 필요한 라이브러리를 설치합니다. 터미널에서 다음 명령어를 실행합니다.

pip install requests notion-client

이제 파이썬 스크립트를 작성합니다. 아래 코드는 예시이며, 실제 데이터 수집 방식에 따라 수정이 필요합니다.

import requests
from notion_client import Client
import os

# 환경 변수에서 노션 통합 토큰 및 데이터베이스 ID 로드
NOTION_TOKEN = os.environ.get("NOTION_TOKEN")
DATABASE_ID = os.environ.get("NOTION_DATABASE_ID")

if not NOTION_TOKEN or not DATABASE_ID:
    raise ValueError("NOTION_TOKEN 및 NOTION_DATABASE_ID 환경 변수를 설정해야 합니다.")

notion = Client(auth=NOTION_TOKEN)

def get_data_from_source():
    # 실제 데이터 소스에서 데이터를 가져오는 로직 (예: 웹 스크래핑, 다른 API 호출 등)
    # 여기서는 간단한 예시 데이터를 반환합니다.
    return [
        {"name": "김민준", "email": "minjun.kim@example.com", "status": "문의"},
        {"name": "이서연", "email": "seoyeon.lee@example.com", "status": "회원가입"}
    ]

def add_to_notion(data_list):
    for item in data_list:
        try:
            response = notion.pages.create(
                parent={"database_id": DATABASE_ID},
                properties={
                    "이름": {"title": [{"type": "text", "text": {"content": item["name"]}}]},
                    "이메일": {"rich_text": [{"type": "text", "text": {"content": item["email"]}}]},
                    "상태": {"select": {"name": item["status"]}}
                }
            )
            print(f"성공: 페이지 생성됨 - {item['name']}")
        except Exception as e:
            print(f"오류 발생 - {item['name']}: {e}")

if __name__ == "__main__":
    source_data = get_data_from_source()
    if source_data:
        add_to_notion(source_data)
    else:
        print("처리할 데이터가 없습니다.")

이 스크립트를 실행하려면 환경 변수에 노션 통합 토큰과 데이터베이스 ID를 설정해야 합니다. 예를 들어, 리눅스 또는 macOS에서는 다음과 같이 설정할 수 있습니다. Windows에서는 set 명령어를 사용합니다.

export NOTION_TOKEN="your_notion_integration_token"
export NOTION_DATABASE_ID="your_database_id"
python your_script_name.py

노션 API 자동화 예제 2: 기존 데이터 자동 업데이트

이미 노션에 저장된 데이터를 주기적으로 업데이트해야 하는 경우에도 API를 활용할 수 있습니다. 예를 들어, 프로젝트 관리에서 특정 작업의 완료 상태를 변경하거나, 고객 지원 티켓의 상태를 업데이트하는 상황입니다.

이 예제에서는 외부 시스템에서 변경된 정보를 가져와 해당 정보를 가진 노션 데이터베이스의 페이지를 찾아 업데이트하는 방법을 보여줍니다. 이를 위해 특정 조건을 만족하는 페이지를 검색하고, 해당 페이지의 속성을 수정하는 로직을 구현합니다.

필요한 준비물:

• 1. 노션 통합 토큰 및 데이터베이스 ID: 이전 예제와 동일합니다.
• 2. 업데이트 기준이 되는 고유 식별자: 노션 데이터베이스 내에서 업데이트할 페이지를 식별할 수 있는 고유한 속성 (예: 이메일 주소, 주문 번호, 고유 ID 등)이 필요합니다.

스크립트는 먼저 외부 소스에서 업데이트할 데이터를 가져옵니다. 그 후, 노션 데이터베이스에서 해당 고유 식별자를 가진 페이지를 검색합니다. 만약 페이지가 존재하면, 해당 페이지의 속성을 업데이트합니다. 존재하지 않으면 새로운 페이지를 생성할 수도 있습니다 (이전 예제와 유사).

import requests
from notion_client import Client
import os

NOTION_TOKEN = os.environ.get("NOTION_TOKEN")
DATABASE_ID = os.environ.get("NOTION_DATABASE_ID")
UNIQUE_IDENTIFIER_PROPERTY = "이메일" # 업데이트 기준이 되는 속성 이름

if not NOTION_TOKEN or not DATABASE_ID:
    raise ValueError("NOTION_TOKEN 및 NOTION_DATABASE_ID 환경 변수를 설정해야 합니다.")

notion = Client(auth=NOTION_TOKEN)

def get_updated_data_from_source():
    # 외부 소스에서 업데이트된 데이터를 가져오는 로직
    # 예: 새로운 고객 상태, 변경된 주문 정보 등
    return [
        {"email": "minjun.kim@example.com", "status": "처리 완료", "notes": "추가 문의 없음"},
        {"email": "new.customer@example.com", "status": "신규 문의", "notes": "제품 정보 요청"}
    ]

def find_page_by_identifier(identifier_value):
    try:
        query = {
            "filter": {
                "property": UNIQUE_IDENTIFIER_PROPERTY,
                "rich_text": {
                    "equals": identifier_value
                }
            }
        }
        response = notion.databases.query(database_id=DATABASE_ID, filter=query)
        if response["results"]:
            return response["results"][0]["id"] # 첫 번째 매칭되는 페이지 ID 반환
        return None
    except Exception as e:
        print(f"페이지 검색 중 오류 발생: {e}")
        return None

def update_notion_page(page_id, updates):
    try:
        properties = {}
        if "status" in updates:
            properties["상태"] = {"select": {"name": updates["status"]}}
        if "notes" in updates:
            properties["비고"] = {"rich_text": [{"type": "text", "text": {"content": updates["notes"]}}]}

        if properties:
            notion.pages.update(page_id=page_id, properties=properties)
            print(f"성공: 페이지 업데이트됨 - ID: {page_id}")
        else:
            print(f"업데이트할 속성이 없습니다 - ID: {page_id}")
    except Exception as e:
        print(f"페이지 업데이트 중 오류 발생 - ID: {page_id}: {e}")

def add_new_page(item):
    # 이전 예제와 동일하게 새로운 페이지 생성 로직
    try:
        response = notion.pages.create(
            parent={"database_id": DATABASE_ID},
            properties={
                "이름": {"title": [{"type": "text", "text": {"content": item["name"] if "name" in item else "Unknown"}}]},
                "이메일": {"rich_text": [{"type": "text", "text": {"content": item["email"]}}]},
                "상태": {"select": {"name": item["status"]}},
                "비고": {"rich_text": [{"type": "text", "text": {"content": item.get("notes", "")}}]}
            }
        )
        print(f"성공: 새 페이지 생성됨 - {item['email']}")
    except Exception as e:
        print(f"새 페이지 생성 중 오류 발생 - {item['email']}: {e}")

if __name__ == "__main__":
    updated_data = get_updated_data_from_source()
    for item in updated_data:
        page_id = find_page_by_identifier(item["email"])
        if page_id:
            update_notion_page(page_id, item)
        else:
            # 만약 고유 식별자로 찾지 못했다면, 새 사용자로 간주하고 페이지 생성
            # 실제 시나리오에서는 'name' 등의 추가 정보가 필요할 수 있습니다.
            print(f"'{item['email']}'에 해당하는 페이지를 찾을 수 없습니다. 새 페이지로 추가합니다.")
            # 새 페이지 추가 시 필요한 정보 (이름 등)를 item 딕셔너리에 포함시켜야 할 수 있습니다.
            # 예시를 위해 name 속성이 없을 경우를 대비하여 기본값을 사용합니다.
            add_new_page(item)

이 스크립트 역시 환경 변수 설정이 필요합니다. UNIQUE_IDENTIFIER_PROPERTY 변수를 사용하여 어떤 속성을 기준으로 페이지를 찾고 업데이트할지 지정해야 합니다. "Apple 지원 문서(support.apple.com)에 따르면, API를 통한 데이터 업데이트는 일관성을 유지하고 오류를 줄이는 데 효과적입니다."

노션 API 자동화 예제 3: 외부 서비스 연동을 통한 데이터 동기화

노션 API의 가장 강력한 활용법 중 하나는 다른 서비스와 연동하여 데이터를 자동으로 동기화하는 것입니다. 예를 들어, 구글 캘린더의 일정을 노션으로 가져오거나, 슬랙 메시지를 특정 노션 페이지에 기록하는 등의 작업입니다.

이 예제에서는 Make (구 Integromat) 또는 Zapier와 같은 자동화 도구를 사용하여 구글 캘린더의 이벤트를 노션 데이터베이스에 동기화하는 시나리오를 설명합니다. 이러한 도구들은 코딩 없이도 시각적인 인터페이스를 통해 복잡한 자동화 워크플로우를 구축할 수 있게 해줍니다.

주요 단계:

Make를 사용하는 경우, 인터페이스는 다음과 유사합니다.

"Google 개발자 문서에서 명시한 바로는, API 연동 시에는 보안을 위해 OAuth 2.0과 같은 표준 인증 방식을 사용하는 것이 권장됩니다." Make와 Zapier는 이러한 인증 과정을 간소화하여 제공합니다.

이러한 자동화 도구를 활용하면 코딩 없이도 다양한 서비스를 연동하여 업무 흐름을 혁신할 수 있습니다. 예를 들어, 고객이 특정 상품을 구매하면 자동으로 노션에 주문 기록을 생성하고, 슬랙으로 담당자에게 알림을 보내는 복잡한 워크플로우도 구축 가능합니다.

성공적인 노션 API 자동화를 위한 추가 팁

노션 API를 활용한 자동화는 분명 강력하지만, 성공적인 적용을 위해서는 몇 가지 추가적인 고려 사항이 있습니다. 단순히 코드를 작성하는 것을 넘어, 전체적인 워크플로우를 설계하고 관리하는 것이 중요합니다.

1. 명확한 목표 설정: 자동화를 시작하기 전에 어떤 반복 업무를 해결하고 싶은지, 자동화를 통해 무엇을 얻고 싶은지 명확히 정의해야 합니다. "모든 것을 자동화하겠다"는 막연한 목표보다는, "매일 30분씩 걸리는 보고서 데이터 취합 시간을 5분으로 줄이겠다"와 같이 구체적인 목표가 효과적입니다.

2. 데이터 구조 설계: 노션 데이터베이스의 구조가 자동화의 효율성에 큰 영향을 미칩니다. 속성 이름을 명확하게 하고, 데이터 타입을 적절하게 설정해야 합니다. 복잡한 데이터 관계는 미리 설계하여 API 연동 시 오류를 줄여야 합니다.

3. 오류 처리 및 로깅: API 호출은 네트워크 문제, 일시적인 서비스 오류 등으로 실패할 수 있습니다. 스크립트나 자동화 워크플로우에 적절한 오류 처리 로직을 포함하고, 발생한 오류를 기록(로깅)하여 문제를 빠르게 파악하고 해결할 수 있도록 해야 합니다. "또하나의 단점은 챗지피티와는 달리 노션AI는 프롬프트를 지우고 거기에 답변을 입혀버립니다. 그래서 예전에 내가 내린 명령이 자료로 남지 않습니다." (출처: clien.net) 이는 자동화 과정에서도 로그 기록의 중요성을 시사합니다.

4. 보안 고려: 노션 통합 토큰은 민감한 정보이므로 안전하게 관리해야 합니다. 코드에 직접 포함시키기보다는 환경 변수나 비밀 관리 도구를 사용하는 것이 좋습니다. Make나 Zapier와 같은 도구를 사용할 때도 각 서비스의 보안 정책을 확인해야 합니다.

5. 점진적 도입 및 테스트: 처음부터 복잡한 자동화를 구축하기보다는, 간단한 예제부터 시작하여 점진적으로 기능을 확장하고 충분히 테스트하는 것이 좋습니다. 실제 운영 환경에 적용하기 전에 개발 또는 스테이징 환경에서 충분한 검증을 거쳐야 합니다. 예를 들어, "macOS 13.5" 버전에서는 정상 작동하던 스크립트가 "macOS 14.0"에서 호환성 문제가 발생할 수 있으므로, 다양한 환경에서의 테스트가 중요합니다.

6. 공식 문서 활용: 노션 API는 지속적으로 업데이트됩니다. 최신 정보와 기능을 활용하기 위해 노션 개발자 공식 문서를 주기적으로 확인하는 것이 필수적입니다. "Notion API Documentation"은 가장 정확하고 최신 정보를 얻을 수 있는 출처입니다. (출처: developers.notion.com)