Integrate ClickUp Notifications

개요

파일 전송 작업의 상태 변화를 ClickUp 태스크로 자동 생성하려면 ClickUp 알림을 연동할 수 있습니다.

연동을 완료하면 전송이 시작(Started), 완료(Completed), 실패(Failed) 되는 등 지정한 이벤트가 발생할 때마다 지정한 ClickUp 리스트에 태스크가 자동으로 생성됩니다.

전체 과정은 ① Personal API Token 발급 → ② 대상 List ID 확인 → ③ 제품에서 알림 설정 순으로 진행됩니다.

준비 사항

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

Personal API Token 발급

ClickUp에서 태스크를 생성하려면 Personal API Token을 발급받아야 합니다.

Step 1. Apps 설정 열기

우측 상단의 프로필(Avatar)을 클릭한 후 Settings로 이동합니다.

왼쪽 메뉴에서 Apps를 선택합니다.

Step 2. Personal API Token 생성

API Token 항목에서 Generate를 클릭합니다.

이미 토큰이 있는 경우에는 Regenerate를 선택하여 새 토큰을 생성할 수 있습니다.

생성된 Personal API Token은 pk_로 시작하며 기본적으로 만료되지 않습니다.

이 토큰은 발급한 계정의 권한을 그대로 가지므로 비밀번호와 동일하게 관리해야 하며 외부에 노출되어서는 안 됩니다.

토큰이 유출된 경우에는 Regenerate를 실행하여 기존 토큰을 무효화할 수 있습니다.

확인 사항

• ✔ Personal API Token을 생성했습니다.
• ✔ 토큰을 안전하게 복사하여 보관했습니다.

대상 List ID 확인

태스크를 생성할 대상 리스트의 List ID를 확인합니다.

Step 1. List ID 확인

사이드바에서 대상 리스트를 마우스 오른쪽 버튼으로 클릭한 후 Copy link를 선택합니다.

복사한 URL에서 /l/ 또는 /li/ 뒤에 있는 숫자가 List ID입니다.

동일한 값은 대상 리스트를 연 상태의 브라우저 주소창에서도 확인할 수 있습니다.

확인 사항

• ✔ 대상 리스트의 List ID를 확인했습니다.

ClickUp 알림 설정

발급받은 Personal API Token과 List ID를 제품의 알림 설정에 입력합니다.

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

Step 1. Personal API Token 입력

Personal API Token 항목에 생성한 토큰을 입력합니다.

Step 2. List ID 입력

List ID 항목에 확인한 List ID를 입력합니다.

Step 3. 알림 이벤트 선택

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

여러 개를 선택할 수 있으며 선택한 이벤트가 발생할 때만 ClickUp 태스크가 생성됩니다.

Step 4. 설정 저장

입력을 완료한 후 Add를 클릭하여 연동을 저장합니다.

확인 사항

• ✔ Personal API Token이 입력되었습니다.
• ✔ List ID가 입력되었습니다.
• ✔ 알림받을 이벤트가 선택되었습니다.

연동 확인

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

Step 1. 테스트 이벤트 발생

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

Step 2. ClickUp 리스트 확인

지정한 ClickUp 리스트에 새로운 태스크가 생성되었는지 확인합니다.

확인 사항

• ✔ ClickUp 리스트에 태스크가 생성되었습니다.
• ✔ 발생한 이벤트가 정확하게 기록되었습니다.

설정 완료

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

이후 선택한 이벤트가 발생할 때마다 지정한 ClickUp 리스트에 태스크가 자동으로 생성됩니다.

문제 해결 (Troubleshooting)

태스크가 생성되지 않는 경우 아래 항목을 확인하세요.