Integrate Zoho Monitoring
개요
파일 전송 작업과 기기 상태 변화를 Zoho로 전송하여 모니터링하려면 Zoho 연동을 설정할 수 있습니다.
연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 수신 Webhook으로 연결된 Zoho 대상(예: Zoho Cliq 채널)으로 알림이 자동으로 전송됩니다.
전체 과정은 ① Zoho 수신 Webhook URL 발급 → ② 제품에서 연동 설정 두 단계로 진행됩니다.
준비 사항
시작하기 전에 다음 사항을 확인하세요.
| 항목 | 설명 |
|---|---|
| Zoho 계정 | 수신 Webhook을 생성할 수 있는 Zoho 계정이 필요합니다. (Zoho Cliq의 경우 채널 관리자 권한) |
| 대상 채널 | 알림을 받을 Zoho Cliq 채널을 미리 준비합니다. |
| 네트워크 | 제품이 설치된 환경에서 Zoho Webhook 엔드포인트(예: cliq.zoho.com, 443)로의 외부 HTTPS 통신이 허용되어야 합니다. |
Zoho 수신 Webhook URL 발급
Zoho로 알림을 전송하려면 대상에 메시지를 게시할 Webhook URL을 발급받아야 합니다.
Step 1. 수신 Webhook 생성
Zoho Cliq에서 알림을 받을 채널을 열고 Connectors 탭에서 Webhook을 생성합니다. (채널 관리자만 구성할 수 있습니다.)
또는 Webhook Tokens 페이지에서 Get Webhook URL을 선택한 후 Channels와 대상 채널을 지정합니다.

Step 2. Webhook URL 복사
생성된 Webhook URL을 복사합니다.
예시:
URL에 포함된 zapikey는 비밀번호와 동일한 권한을 가지므로 외부에 노출되지 않도록 주의합니다.
유출된 경우 Webhook Token을 재발급합니다.

확인 사항
✔ 수신 Webhook을 생성했습니다.
✔ Webhook URL을 복사했습니다.
Zoho 연동 설정
발급받은 Webhook URL을 제품에 입력합니다.
Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.

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

Step 2. Zoho 확인
대상 Zoho Cliq 채널에 알림 메시지가 도착했는지 확인합니다.

확인 사항
✔ Zoho 대상에 알림이 도착했습니다.
✔ 발생한 이벤트가 정상적으로 전달되었습니다.
설정 완료
설정을 저장하면 연동이 적용됩니다.
이후 선택한 이벤트가 발생할 때마다 Zoho 대상에 알림이 자동으로 전송됩니다.
문제 해결 (Troubleshooting)
| 문제 | 확인 사항 |
|---|---|
| 알림이 도착하지 않음 | Webhook URL이 정확한지(zapikey 포함), 앞뒤 공백이나 누락이 없는지 확인 |
| 인증 오류(401)가 발생함 | zapikey가 유효한지 확인하고 필요 시 재발급 |
| 메시지가 게시되지 않음 | Webhook이 대상 채널에 게시할 수 있도록 구성되어 있는지(채널 관리자 설정) 확인 |
| 폐쇄망에서 연동 실패 | Zoho Webhook 엔드포인트(예: cliq.zoho.com, 443) 아웃바운드 통신이 방화벽 또는 프록시에서 허용되는지 확인 |