monday.com 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 monday.com 연동 가이드는 파트너와 IT 팀을 대상으로 monday.com 보드를 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 monday.com과 양방향으로 연동됩니다.
- 제품, 수량, 납기, 우선순위, 상태가 포함된 주문 항목을 가져옵니다.
- 계획된 시작일과 종료일은 Timeline 열에, 작업장은 별도 열에 기록합니다.
- 생산 현장 작업자의 진행 상황을 Status 열에 반영합니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 보드에 맞게 연동을 설정하고, 운영 개시 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 문서화된 SkyPlanner REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
monday.com 플랫폼 API
monday.com은 단일 GraphQL API를 POST https://api.monday.com/v2에서 제공합니다. 버전은 분기마다 출시되며, API-Version 헤더로 사용할 버전을 고정합니다. 지원 중단은 최소 여섯 개월 전에 공지됩니다. (API 버전 관리)
스케줄링 연동에는 다음 객체를 사용합니다.
- Boards와 groups: 주로 단계별 또는 주별 구분에 사용합니다.
- Items와 subitems: 일반적으로 item은 주문이나 작업을 나타내고, subitems에는 공정을 담습니다.
- Column values: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards, Mirror.
- Webhooks: 변경 이벤트를 전달합니다.
조회에는 보드 또는 그룹 안에 중첩된 items_page를 사용합니다. 기본 페이지 크기는 항목 25개이며, “the maximum is 500.”(이 수가 최대 항목 수입니다.) 다음 페이지는 next_items_page로 조회하며, “each cursor will expire 60 minutes after the first request.”(각 커서는 첫 요청 후 이 시간이 지나면 만료됩니다.) query_params로 필터링하면 미완료 주문만 조회할 수 있습니다. (items_page)
쓰기에는 create_item, create_subitem, change_column_value, change_multiple_column_values를 사용합니다. 마지막 함수는 한 번의 호출로 한 항목의 여러 열을 업데이트하므로, 스케줄 결과를 다시 반영하는 데 적합합니다.
API 버전 2026-07부터는 대량 데이터 적재를 위한 ingest_items와 backfill_items가 추가됩니다. 사전 서명된 URL에 CSV를 업로드한 뒤 작업 상태를 폴링합니다. (대량 가져오기)
인증
monday.com은 세 가지 토큰 유형을 지원합니다.
- 개인 API 토큰. “Each token is unique to a user”(각 토큰은 사용자별로 고유합니다.) 해당 사용자의 권한이 적용되며, 개념 검증에 적합합니다.
- 앱 토큰. 연동 앱에 사용하며 권한 범위를 지정할 수 있습니다.
- OAuth.
auth.monday.com/oauth2/authorize와/oauth2/token을 사용하며,boards:read,boards:write,webhooks:read,webhooks:write등의 권한 범위를 지정합니다.
운영 환경에서는 앱 토큰이나 OAuth 토큰을 사용하세요. 개인 토큰은 소유자가 토큰을 재생성하면 더 이상 작동하지 않습니다. (인증)
SkyPlanner REST API는 API 토큰(SkyPlanner Settings > API)으로 인증하며, Swagger/OpenAPI 문서가 제공됩니다. API 토큰만 있으면 시작할 수 있고, 연동 튜토리얼에서 첫 API 호출 방법을 안내합니다.
웹훅과 데이터 정합성 확인
create_webhook(board_id, url, event, config)로 구독을 생성합니다. 스케줄링 연동에는 다음 이벤트가 필요합니다.
- 신규 주문과 공정:
create_item,create_subitem. - 납기, 수량, 우선순위 변경:
change_column_value또는change_specific_column_value. - 사용자가 직접 변경한 상태:
change_status_column_value. - 취소되거나 완료된 주문:
item_archived,item_deleted,item_moved_to_specific_group.
웹훅을 생성할 때 수신 URL은 챌린지 토큰에 응답해야 합니다. 전송에 실패하면 “retry once a minute for 30 minutes,”(해당 시간 동안 매분 한 번 재시도)한 뒤 중단합니다. 따라서 연동 서비스는 items_page로 최근 업데이트된 항목을 필터링해 주기적으로 조회하고 데이터 정합성도 확인합니다. (웹훅)
반대 방향에서는 상태나 스케줄이 변경되면 SkyPlanner가 웹훅을 전송합니다. 연동 서비스는 이를 수신해 monday.com에 새로운 날짜를 기록합니다. 따라서 스케줄 결과 반영은 이벤트 기반으로 이루어집니다.
데이터 매핑
monday.com에는 표준 주문 객체가 없으므로 계정별로 열 ID를 매핑합니다. 일반적인 구성은 다음과 같습니다.
| monday.com 객체 | SkyPlanner 객체 | 전송 방향 | 전송 주기 |
|---|---|---|---|
| 생산 보드의 항목: Name, Numbers(수량), Date(납기), Status 또는 Dropdown(우선순위) | 제품, 수량, 납기, 우선순위가 포함된 주문 | monday.com → SkyPlanner | 생성·변경 시 웹훅 전송 및 정합성 확인 |
| Subitems 또는 Connect Boards로 연결된 보드의 항목 | 소요 시간이 포함된 공정 | monday.com → SkyPlanner | 주문과 함께 |
| 제품 보드의 항목(제품 데이터에 Mirror 사용) | 제품 및 제품 구조 | monday.com → SkyPlanner | 최초 적재 후 변경 시 |
| monday.com에서 관리하는 경우, 재고 또는 자재 보드의 항목 | 자재 및 재고 수량 | monday.com → SkyPlanner | 정해진 주기로 조회 |
| 예상 납품일이 포함된 구매 발주 보드의 항목 | 납품일부터 사용 가능한 입고 예정 자재 | monday.com → SkyPlanner | 웹훅 또는 정해진 주기로 조회 |
| 사용자 및 팀 | 작업자를 스케줄에 배정하는 경우, 인력 정보 | monday.com → SkyPlanner | 최초 적재 |
| monday.com에서 관리하지 않음 | 작업장, 교대조, 작업 준비 시간 매트릭스, 공구, 대체 설비 | SkyPlanner에서 관리 | 온보딩 중 설정 |
| Timeline 열 | 계획된 시작일 및 종료일 | SkyPlanner → monday.com | 스케줄 변경 시 SkyPlanner 웹훅으로 전송 |
| Status, Dropdown 또는 Text 열 | 배정된 작업장 | SkyPlanner → monday.com | 스케줄 변경 시 |
| Status 열(예: 생산 중, 완료) | Mobile Confirmations로 기록한 작업 진행 상황 | SkyPlanner → monday.com | 실적 등록 시마다 |
연동 방식
1. 기준정보 최초 적재. items_page로 제품, 자재, 미완료 주문을 조회합니다. 작업장, 교대조, 제약 조건은 SkyPlanner에서 생성하거나 Excel에서 가져옵니다. 공정을 subitems로 관리할지, 연결된 보드에서 관리할지 초기에 결정하세요.
2. 주문 동기화. 생산 보드의 웹훅은 새로 생성되거나 변경된 항목을 SkyPlanner에 주문으로 전송합니다. 보드에서 구매 발주를 관리한다면 SkyPlanner는 발주한 자재를 납품일부터 사용 가능한 것으로 처리하고, 발주 상태가 납품 완료로 표시되면 재고를 업데이트합니다.
3. 스케줄 결과 반영. 엔진이 배정하거나 이동한 각 주문에 대해 연동 서비스가 change_multiple_column_values를 호출합니다. Timeline 열에 계획된 시작일과 종료일을 설정하고 작업장 열을 채웁니다. 항목당 한 번만 호출하므로 요청 수를 적게 유지할 수 있습니다.
4. 생산 현장 진행 상황. 작업자는 Mobile Confirmations, Production Timer 또는 Quick Log Mode로 작업을 기록합니다. 작업 시간 기록을 바탕으로 스케줄이 최신 상태로 유지되고, 해당 진행 상태를 나타내는 Status 라벨이 보드에 반영됩니다. 영업 담당자는 따로 묻지 않고도 진행 상황을 확인할 수 있습니다.
5. 데이터 관리 주체 및 충돌 처리 규칙. 운영 개시 전에 다음 내용을 문서화하세요.
| 데이터 | 관리 주체 |
|---|---|
| 주문, 고객, 수량, 납기, 우선순위 | monday.com |
| 공정 순서, 시작일 및 종료일, 작업장 | SkyPlanner |
| 교대조, 작업 준비, 공구, 대체 설비 | SkyPlanner |
| 진행 상황을 나타내는 Status 라벨 | SkyPlanner에서 기록, monday.com에서 표시 |
충돌은 주로 사용자가 Timeline 열을 직접 수정할 때 발생합니다. 해당 열은 SkyPlanner만 수정하도록 합의하거나, 수동 수정을 변경 요청으로 처리해 SkyPlanner가 스케줄을 다시 잡도록 하세요. Autopilot은 생산 상황이 바뀌면 자동으로 스케줄을 조정합니다.
일반적인 프로젝트 단계
구축은 보통 온보딩 시작 후 몇 주 내에 완료됩니다. 그에 앞서 30일 무료 체험에서 자체 데이터로 사용해 볼 수 있습니다. 생산 보드를 Excel로 내보낸 뒤 SkyPlanner로 가져오세요.
- 보드 검토. 보드, 그룹, 열 ID, 상태 라벨을 매핑하고 monday.com 요금제를 확인합니다.
- 매핑 및 관리 주체 확정. 매핑 표, 데이터 관리 규칙, 동기화 주기를 확정합니다.
- SkyPlanner 제약 조건 설정. 작업장, 교대조, 준비 시간 매트릭스, 공구 및 대체 설비를 설정합니다.
- 주문 동기화. 웹훅, 데이터 대조용 조회 및 토큰 처리를 구현합니다.
- 결과 반영. Timeline 열, 작업장 열 및 상태 열에 결과를 기록합니다.
- 병행 테스트. 기존 보드와 SkyPlanner를 함께 운영하면서 날짜를 비교하고 데이터를 수정합니다.
- 정식 운영 시작. 날짜가 일치하면 결과 쓰기를 활성화합니다.
monday.com 연동 시 미리 고려할 사항
- 계정마다 주문을 구성하는 방식이 다릅니다. 고객별로 보드를 하나씩 만들거나, 공정을 항목 또는 하위 항목으로 구성하거나, 설비를 People 또는 Status 열로 표현하기도 합니다. 열 제목이 아닌 열 ID를 기준으로 계정별 매핑을 설정해야 합니다.
- 요금제별 한도. 하루 API 호출 한도는 Free, Basic, Standard가 1,000회, Pro가 10,000회, Enterprise가 25,000회입니다. 변경 사항은 웹훅으로 받고, 결과는
change_multiple_column_values로 일괄 기록하세요. (호출 한도) - 연결할 수 있는 보드 수에는 한도가 있습니다. Basic은 보드 한 개, Standard는 다섯 개까지 연결할 수 있어 공정이나 제품 보드를 연결하는 데 제한이 있습니다. (Connect Boards 한도)
- API 버전을 고정하세요. 버전은 분기마다 바뀝니다. 2026-04 버전 이전에는 기본 boards 쿼리에서 다단계 보드가 제외되었습니다.
- 커서 만료.
items_page커서의 유효 시간은 60분입니다. 오래 걸리는 데이터 대조 작업은 처음부터 정상적으로 다시 시작할 수 있어야 합니다. - 웹훅 제한. URL은 최대 255자이며 재시도는 30분 후 중단됩니다. 수신 측은 멱등성을 보장해야 합니다.
- 단위와 소요 시간. Numbers 열에는 단위가 없습니다. 데이터를 처음 가져오기 전에 소요 시간을 분으로 표시할지 시간으로 표시할지 합의하세요.
monday.com 연동 설정과 지원은 누가 담당하나요?
연동 작업에는 보드와 열의 매핑뿐 아니라 monday.com에서 관리하지 않는 제약 조건 설정도 포함됩니다. 작업장, 교대조, 준비 시간 매트릭스, 공구 및 대체 설비가 여기에 해당합니다.
- SkyPlanner 팀이 온보딩 과정에서 연동을 설정하고 정식 운영 이후에도 지원합니다. 회사마다 보드를 구성하는 방식이 다르므로, 이 과정에 그 노하우를 반영합니다.
- 기존 monday.com 파트너도 참여할 수 있습니다. 파트너는 고객사의 보드와 자동화 구성을 잘 알고 있어 열 매핑과 토큰 설정을 검토할 수 있습니다.
- 사내 개발자가 직접 확장 개발할 수도 있습니다. 문서화된 SkyPlanner REST API와 API 토큰을 사용하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때는 SkyPlanner 팀이 지원합니다. 공개 제품 문서는 SkyPlanner 문서에서 확인할 수 있습니다.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 결제됩니다. 연동 비용은 고객사의 프로세스와 요구 사항에 맞춰 요금제와 함께 사전에 견적을 제공하므로, 시작 전에 전체 비용을 확인할 수 있습니다. monday.com 자체 보기 기능과의 차이는 monday.com 생산 스케줄링에서 확인하세요. 전반적인 내용은 monday.com 페이지에, 다른 시스템과의 연동은 ERP 연동 안내에 정리되어 있습니다.
제조업 고객의 SkyPlanner 사용 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 벗어나 실시간으로 생산을 최적화하게 되었습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획 업무 시간이 매주 2시간 줄었으며, 새 작업 대기열이 몇 초 만에 생산 라인에 전달됩니다.
+90%생산 효율
“생산 효율이 90% 향상되었습니다.”
Abdul Rucyinga, IT 책임자
Laboratory & Allied · 의약품 제조
생산 효율이 90% 향상되었으며, 모든 작업장을 대상으로 석 달간의 최적화된 계획을 세우는 데 30분도 걸리지 않습니다.
6개월앞의 여유 생산능력을 영업팀이 확인
“SkyPlanner는 모든 생산 계획의 기반을 마련하고 신뢰성을 높여 줍니다.”
Anu Järvinen, 생산 관리자
Fredman Operations · 식품용 포장지
영업팀은 여섯 달 앞의 여유 생산능력을 확인할 수 있습니다. 한 시간 이상 걸리던 일정 변경 요청에도 이제 몇 초 만에 답변합니다.
자주 묻는 질문
연동에는 어떤 monday.com API를 사용하나요?
api.monday.com/v2에서 제공되는 GraphQL API인 monday.com 플랫폼 API를 사용하며, API-Version 헤더로 버전을 고정합니다. 조회에는 items_page, 쓰기에는 change_multiple_column_values를 사용하고, 변경 사항은 웹훅으로 전달받습니다.
monday.com에서는 무엇을 설정해야 하나요?
접근 권한과 열 두 개를 설정하면 됩니다. monday.com 관리자가 권한 범위를 지정한 OAuth 또는 앱 토큰을 한 번 승인하고, 결과를 기록할 Timeline 열과 작업장 열을 보드에 추가합니다. 기존 보드와 자동화는 그대로 유지됩니다.
어떤 monday.com 요금제가 필요한가요?
하루 API 호출 한도는 요금제에 따라 늘어납니다. Standard 이하는 1,000회, Pro는 10,000회, Enterprise는 25,000회입니다. 변경이 잦은 양방향 동기화에는 Pro 또는 Enterprise가 적합합니다. SkyPlanner 팀이 보드를 검토하면서 요금제와 처리량을 확인합니다.
monday.com에서 변경 사항을 실시간으로 전송할 수 있나요?
네. 항목 생성, 열 변경, 상태 변경 시 웹훅이 실행됩니다. monday.com의 30분 재시도 시간이 지난 뒤에도 전달되지 않은 변경 사항은 주기적인 데이터 대조용 조회로 보완합니다.
계획된 날짜는 monday.com에 어떻게 기록되나요?
각 항목에 change_multiple_column_values를 사용합니다. Timeline 열에 계획된 시작일과 종료일을 기록하고, 같은 호출에서 작업장 열과 상태 열도 업데이트합니다.
