# 카메라에 누군가 나타나는 순간.

> Frigate가 사람이나 차량을 감지하면 휴대폰으로 푸시 알림을 받아보세요. Home Assistant 자동화나 Node-RED 플로우가 Frigate MQTT 이벤트를 HTTP POST 한 번으로 Pocket Alert에 전달해요.

<!-- source: https://pocketalert.app/ko/use-cases/frigate-nvr-alerts -->

마지막 업데이트: 2026-08-11

Frigate가 진입로에서 사람을 감지하면 1초 안에 휴대폰에 알림이 도착해요. Home Assistant 자동화나 Node-RED 플로가 Frigate의 MQTT 이벤트를 구독하고, Pocket Alert로 HTTP POST 요청을 한 번 보내요. 라벨과 점수로 필터링할 수 있고, 밤에 감지된 사람을 critical로 보내면 방해 금지 모드도 뚫을 수 있어요.

## 카메라 알림까지 세 단계

1. **토큰 또는 URL 준비하기** — API 키를 만들거나, 카메라마다 애플리케이션 웹훅 URL을 복사하세요.
2. **브리지 연결하기** — frigate/events MQTT 토픽에 Home Assistant 자동화나 Node-RED 플로를 추가하세요.
3. **푸시 알림 받기** — 카메라 앞을 지나가면 해당 카메라의 채널로 1초 안에 휴대폰이 울려요.

## 추가 애드온 없이 Frigate에서 푸시 알림 받기

이미 NVR을 운영하고 계시죠. 자동화 하나만 추가하면 카메라에 잡힌 사람이 휴대폰에 도착해요. 필터링되고, 우선순위가 정해지고, 기록으로도 남아요.

- **나뭇잎 말고 사람만** — 자동화에서 라벨 "person"과 점수 임계값을 함께 설정하세요. 흔들리는 나뭇가지 때문에 깨는 일은 없어요.
- **카메라별 채널** — 카메라마다 애플리케이션 하나씩 두면 진입로, 현관, 차고 알림이 각각 다른 채널로 나뉘어요.
- **중요할 때만 critical** — 밤에 감지된 사람을 critical로 보내면 방해 금지 모드를 우회할 수 있어요. 일상적인 이벤트는 조용히 유지돼요.
- **영상은 집 안에** — Frigate는 완전히 로컬에서 동작해요. 네트워크 밖으로 나가는 것은 직접 보내는 알림 텍스트뿐이고, 영상은 절대 나가지 않아요.
- **사용 중인 브리지와 함께** — Home Assistant 자동화나 Node-RED 플로가 MQTT 이벤트를 HTTP POST 요청 한 번으로 전달해요.
- **감지 기록** — 전달된 모든 감지 결과는 통계와 함께 검색 가능한 기록에 쌓여요. 외출 중에 무슨 일이 있었는지 확인해 보세요.

## Frigate 연결하기

### 1. API 키 만들기

[API 키](https://pocketalert.app/ko/account/apikeys) 페이지에서 키를 만드세요. 브리지는 메시지 API로 보내는 모든 POST 요청에 이 키를 `Token` 헤더로 담아 보내요.

### 2. Home Assistant에 rest_command 추가하기

```
rest_command:
  pocketalert:
    url: "https://api.pocketalert.app/v1/messages"
    method: POST
    headers:
      Token: "YOUR_API_KEY"
    content_type: "application/json"
    payload: '{"title":"{{ title }}","message":"{{ message }}","level":"{{ level | default(''high'') }}"}'
```

### 3. Frigate 이벤트에서 실행하기

```
automation:
  - alias: "Person on driveway"
    trigger:
      - platform: mqtt
        topic: frigate/events
    condition:
      - "{{ trigger.payload_json['type'] == 'new' }}"
      - "{{ trigger.payload_json['after']['label'] == 'person' }}"
      - "{{ trigger.payload_json['after']['top_score'] > 0.7 }}"
    action:
      - service: rest_command.pocketalert
        data:
          title: "Person on {{ trigger.payload_json['after']['camera'] }}"
          message: "Frigate detected a person ({{ (trigger.payload_json['after']['top_score'] * 100) | round }}% confidence)"
          level: critical
```

### 4. Node-RED로 연결하기

Home Assistant를 쓰지 않나요? `mqtt in`에 `frigate/events` 노드를 놓고, `switch`에 `msg.payload.after.label` 노드를 연결한 다음, 제목과 메시지를 `http request`로 POST하는 `https://api.pocketalert.app/v1/messages` 노드를 추가하세요. 이때 `Token` 헤더를 함께 넣으세요. 전체 메시지 API 내용은 [문서](https://info.pocketalert.app/getting-started.html)를 참고하세요.

## 자주 묻는 질문

### Frigate 알림을 휴대폰으로 받으려면 어떻게 하나요?

Frigate는 모든 감지 결과를 MQTT 이벤트로 발행해요. Home Assistant 자동화(또는 Node-RED 플로)가 frigate/events 토픽을 구독하고, 제목과 메시지를 담아 Pocket Alert 메시지 API로 HTTP POST 요청을 한 번 보내요. 푸시 알림은 1초 안에 휴대폰에 도착해요.

### Home Assistant가 꼭 필요한가요?

아니요. MQTT를 구독하고 HTTP POST 요청을 보낼 수 있는 도구라면 무엇이든 괜찮아요. Node-RED, 간단한 Python 스크립트, 이미 사용 중이라면 Home Assistant도 가능해요. Frigate 자체는 알림을 보내지 않고 이벤트만 발행해요. 선택한 브리지가 이벤트를 전달하는 역할을 해요.

### 밤에 사람이 감지되면 깨워 줄 수 있나요?

"level":"critical"을 넣어 보내면 돼요. 안드로이드에서는 방해 금지 모드를 우회하는 전용 채널로 전달돼요. 방해 금지 접근 권한은 한 번만 허용하면 돼요. 아이폰에서는 high와 critical 알림이 시간 민감형 알림으로 전달되어 집중 모드를 뚫고 들어와요. 무료 플랜에서는 critical이 high로 전달돼요. 여전히 즉시 전달되지만 방해 금지 우회는 되지 않아요.

### 움직임이 감지될 때마다 푸시가 오지 않게 하려면 어떻게 하나요?

휴대폰이 아니라 자동화에서 필터링하세요. 유형이 "new"이고 라벨이 "person"(또는 "car")인 이벤트만 일치시키고, 점수 임계값을 추가하면 흔들리는 나뭇가지에는 알림이 울리지 않아요. 카메라마다 애플리케이션을 따로 만들고, 일상적인 감지 결과는 level을 silent로 보내세요. 소리 없이 기록에만 남아요.

### 카메라 영상이 로컬에만 남나요?

네. Frigate는 녹화와 감지를 모두 사용자의 하드웨어에서만 처리해요. 네트워크 밖으로 나가는 것은 직접 고른 알림 텍스트뿐이에요. 예를 들어 "진입로에 사람" 같은 제목과 짧은 메시지 정도예요.

### 나중에 과거 감지 기록을 다시 볼 수 있나요?

전달한 모든 감지 결과는 앱과 웹 대시보드의 검색 가능한 기록에 쌓이고, 애플리케이션별 통계도 볼 수 있어요. 외출 중에 카메라가 무엇을 봤는지 집에 돌아와서 훑어보고 싶을 때 유용해요. 마지막 푸시 알림만 보는 것으로 끝나지 않아요.
