Integrate Asana Notifications

개요

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

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

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입니다.

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)

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