Asana 알림 연동

개요#

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

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

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

준비 사항#

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

Personal Access Token(PAT) 발급#

Asana에서 태스크를 생성하려면 Asana Developer Console에서 Personal Access Token(PAT)을 발급받아야 합니다.

Step 1. Developer Console 접속#

프로필 사진을 클릭한 후 Settings → Apps → Build new apps → View developer console을 선택합니다.

또는 아래 주소로 직접 접속할 수 있습니다.

https://app.asana.com/1/my-apps

Step 2. 토큰 생성#

Personal access tokens 메뉴에서 Create new token을 선택합니다.

토큰 이름을 입력한 후 Asana API 약관에 동의하고 Create token을 클릭합니다.

Step 3. 토큰 복사#

생성된 Personal Access Token을 복사합니다.

ℹ️ 이 토큰은 생성 시 한 번만 확인할 수 있으므로 안전한 위치에 보관해야 합니다. PAT는 발급한 계정의 권한을 그대로 가지므로 비밀번호와 동일하게 관리해야 하며 외부에 노출되어서는 안 됩니다. 유출된 경우 Developer Console에서 해당 토큰을 비활성화(Deauthorize)할 수 있습니다.

확인 사항#

• ✔ Developer Console에서 토큰을 생성했습니다.
• ✔ Personal Access Token을 안전하게 복사했습니다.

대상 Project ID 확인#

태스크를 생성할 대상 프로젝트의 Project ID를 확인합니다.

Step 1. 프로젝트 URL에서 확인#

대상 프로젝트를 열면 브라우저 주소창 URL에 Project ID가 포함되어 있습니다.

/1/ 뒤에 표시되는 숫자가 Project ID입니다.

https://app.asana.com/1/<Project ID>/...

Step 2. API Explorer에서 확인 (선택)#

Developer Console의 API Explorer에서 GET /projects를 실행하면 접근 가능한 프로젝트 목록과 각 프로젝트의 project_gid를 확인할 수 있습니다.

확인 사항#

• ✔ 대상 프로젝트의 Project ID를 확인했습니다.

Asana 알림 설정#

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

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

Step 1. Personal Access Token(PAT) 입력#

Personal Access Token (PAT) 항목에 복사한 토큰을 입력합니다.

Step 2. Project ID 입력#

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

Step 3. 알림 이벤트 선택#

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

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

Step 4. 설정 저장#

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

확인 사항#

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

연동 확인#

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

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

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

Step 2. Asana 프로젝트 확인#

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

확인 사항#

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

설정 완료#

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

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

문제 해결 (Troubleshooting)#

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