Atlassian Trello 알림 연동

개요#

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

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

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

준비 사항#

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

Trello API Key / Token 발급#

Trello API Key는 Power-Up(App)에 연결되어 발급됩니다.

먼저 Power-Up을 생성한 후 API Key와 Token을 발급받습니다.

Step 1. Power-Up 생성#

https://trello.com/power-ups/admin 에 접속한 후 New를 클릭합니다.

Power-Up 이름 등 필수 정보를 입력한 뒤 Create를 클릭하여 Power-Up을 생성합니다.

Step 2. API Key 발급#

생성한 Power-Up의 API Key 탭에서 Generate a new API Key를 선택합니다.

생성된 API Key를 복사합니다.

ℹ️ 동일한 화면에 표시되는 Secret은 OAuth 1.0 인증용으로 사용되며 본 연동에서는 필요하지 않습니다.

Step 3. Token 발급#

API Key 옆의 Token 링크를 클릭합니다.

권한 요청 화면이 표시되면 Allow를 선택한 후 발급된 Token을 복사합니다.

ℹ️ API Key는 애플리케이션을 식별하는 값이며, Token은 계정에 접근할 수 있는 권한을 가지므로 비밀번호처럼 안전하게 관리해야 합니다. Token이 유출된 경우 Trello 계정 설정에서 언제든지 취소(Revoke)할 수 있습니다.

확인 사항#

• ✔ Power-Up이 생성되었습니다.
• ✔ API Key를 복사했습니다.
• ✔ Token을 복사했습니다.

대상 List ID 확인#

카드를 생성할 대상 리스트의 ID를 확인합니다.

Step 1. 보드 JSON에서 확인#

대상 보드를 브라우저에서 연 뒤 주소 끝에 .json을 추가하여 다시 엽니다.

https://trello.com/b/<boardId>.json

표시된 JSON 데이터에서 원하는 리스트를 찾아 해당 항목의 id 값을 확인합니다.

Step 2. API로 확인 (선택)#

발급받은 API Key와 Token을 사용하면 아래 API를 통해 리스트 정보를 조회할 수 있습니다.

https://api.trello.com/1/boards/<boardId>/lists?key=<API Key>&token=<Token>

응답에서 대상 리스트의 id 값을 확인합니다.

확인 사항#

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

Trello 알림 설정#

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

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

Step 1. API Key 입력#

API Key 항목에 복사한 API Key를 입력합니다.

Step 2. Token 입력#

Token 항목에 복사한 Token을 입력합니다.

Step 3. List ID 입력#

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

Step 4. 알림 이벤트 선택#

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

여러 개를 선택할 수 있으며 선택한 이벤트가 발생할 때만 Trello 카드가 생성됩니다.

Step 5. 설정 저장#

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

확인 사항#

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

연동 확인#

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

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

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

Step 2. Trello 리스트 확인#

지정한 Trello 리스트에 새로운 카드가 생성되었는지 확인합니다.

확인 사항#

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

설정 완료#

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

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

문제 해결 (Troubleshooting)#

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