개요#
파일 전송 작업의 상태 변화를 monday.com 보드 항목으로 자동 생성하려면 monday.com 연동을 설정할 수 있습니다.
연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 지정한 monday.com 보드에 항목(Item)이 자동으로 생성됩니다.
전체 과정은 ① monday.com API Token 발급 → ② 대상 Board ID 확인 → ③ 제품에서 연동 설정 순으로 진행됩니다.
준비 사항#
시작하기 전에 다음 사항을 확인하세요.
| 항목 | 설명 |
|---|---|
| monday.com 계정 | 대상 보드에 접근 및 편집할 수 있는 monday.com 계정이 필요합니다. API Token은 계정의 권한을 그대로 가집니다. |
| 대상 보드 | 항목(Item)을 생성할 monday.com 보드를 미리 준비합니다. |
| 네트워크 | 제품이 설치된 환경에서 api.monday.com(443)으로의 외부 HTTPS 통신이 허용되어야 합니다. |
monday.com API Token 발급#
monday.com으로 항목을 생성하려면 개인 API Token을 발급받습니다.
Step 1. Developer Center 열기#
우측 상단의 프로필 사진을 클릭하고 Developers를 선택합니다.
Developer Center가 새 탭으로 열립니다.

Step 2. API Token 복사#
My Access Tokens(또는 API Token)에서 Show를 클릭하고 표시된 토큰을 복사합니다.
토큰은 일반적으로 eyJ로 시작하는 JWT 형식입니다.
ℹ️ 이 토큰은 계정의 권한을 그대로 가지므로 비밀번호처럼 취급하여 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다. 유출된 경우 Developer Center에서 Regenerate를 실행하면 기존 토큰이 무효화됩니다.

확인 사항#
- ✔ Developer Center에서 API Token을 확인했습니다.
- ✔ API Token을 안전하게 복사했습니다.
대상 Board ID 확인#
항목을 생성할 대상 보드의 ID를 확인합니다.
Step 1. Board ID 확인#
대상 보드를 열면 브라우저 주소창 URL의 /boards/ 다음에 오는 숫자가 Board ID입니다.
https://<account>.monday.com/boards/<Board ID>
확인 사항#
- ✔ 대상 Board ID를 확인했습니다.
monday.com 연동 설정#
발급받은 API Token과 Board ID를 제품의 설정에 입력합니다.
Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Monday API Token 입력#
Monday API Token 항목에 복사한 API Token을 입력합니다.
Step 2. Board ID 입력#
Board ID 항목에 확인한 Board ID를 입력합니다.
Step 3. 이벤트 선택#
Events 항목에서 모니터링할 이벤트를 선택합니다.
여러 개를 선택할 수 있으며, 선택한 이벤트가 발생할 때만 monday.com에 항목이 생성됩니다.
| 이벤트 | 발생 시점 |
|---|---|
| Transfer Started | 전송 작업이 시작되었을 때 |
| Transfer Completed | 전송이 정상적으로 완료되었을 때 |
| Transfer Paused | 전송이 일시 중지되었을 때 |
| Transfer Recovered | 중단 또는 오류 후 전송이 자동 복구되어 재개되었을 때 |
| Device Connected | 기기가 연결되었을 때 |
| Device Disconnected | 기기 연결이 해제되었을 때 |
Step 4. 설정 저장#
입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.
확인 사항#
- ✔ Monday API Token이 입력되었습니다.
- ✔ Board ID가 입력되었습니다.
- ✔ 모니터링할 이벤트가 선택되었습니다.
연동 확인#
설정이 정상적으로 동작하는지 확인합니다.
Step 1. 테스트 이벤트 발생#
실제 전송 작업을 실행하거나 선택한 이벤트를 발생시킵니다.

Step 2. monday.com 보드 확인#
지정한 monday.com 보드에 새로운 항목(Item)이 생성되었는지 확인합니다.

확인 사항#
- ✔ monday.com 보드에 항목이 생성되었습니다.
- ✔ 발생한 이벤트가 정상적으로 기록되었습니다.
설정 완료#
설정을 저장하면 연동이 적용됩니다.
이후 선택한 이벤트가 발생할 때마다 지정한 monday.com 보드에 항목이 자동으로 생성됩니다.
문제 해결 (Troubleshooting)#
| 문제 | 확인 사항 |
|---|---|
| 항목이 생성되지 않음 | Monday API Token과 Board ID가 정확한지, 앞뒤 공백이나 누락이 없는지 확인 |
| 인증 오류(401)가 발생함 | API Token이 유효한지, Regenerate로 무효화되지 않았는지 확인 |
| 권한 오류가 발생함 | API Token을 발급한 계정에 대상 보드의 접근 및 편집 권한이 있는지 확인 |
| 보드를 찾을 수 없음 | Board ID가 대상 보드의 /boards/ 뒤에 있는 숫자인지 확인 |
| 폐쇄망에서 연동 실패 | api.monday.com(443)으로의 아웃바운드 HTTPS 통신이 방화벽 또는 프록시에서 허용되는지 확인 |