# iPhone 문자를 Home Assistant로 보내기

> 웹후크 트리거로 iPhone 문자를 Home Assistant 자동화에 연결해요. 트리거 설정, 인터넷에 여는 방법, 문자를 JSON으로 읽는 방법을 알려드려요.

마지막 업데이트: 2026-10-23
표준 HTML 페이지: https://www.fwrdsms.com/ko/blog/iphone-texts-to-home-assistant
Published: 2026-10-18

iPhone 문자를 Home Assistant로 보내려면, 자동화에 웹후크 트리거를 달고, Home Assistant Cloud나 내 도메인으로 그 트리거의 HTTPS 주소를 마련한 다음, 단축어 ‘메시지’ 자동화가 새 문자를 그 주소로 보내게 하세요. Home Assistant는 문자를 `trigger.json`으로 읽어요. 그래서 알람 문자가 오면 조명을 켜거나 택배 도착을 스피커로 알릴 수 있어요.

**준비물:** 문자를 받는 iPhone, Home Assistant 서버, 그리고 서버로 가는 HTTPS 주소(Home Assistant Cloud(Nabu Casa)나 내 도메인과 리버스 프록시). Fwrd를 쓰려면 iOS 26 이상도 필요해요.

## 문자는 Home Assistant에 어떻게 닿나요?

웹후크로 닿아요. 어떤 앱도 문자를 스스로 읽을 수 없으니, 단축어 자동화가 조건에 맞는 문자를 Home Assistant의 웹후크 주소로 올리는 동작에 넘겨줘요.

Home Assistant의 [자동화 트리거 문서](https://www.home-assistant.io/docs/automation/trigger/#webhook-trigger)(2026년 10월 18일 확인)에 따르면 주소는 `/api/webhook/` 뒤에 웹후크 ID를 붙인 형태이고, 트리거에 ID를 설정하는 즉시 만들어져요. 또 요청이 `application/json`으로 전송되기만 하면 그 주소로 온 JSON을 `trigger.json`으로 쓸 수 있다고 해요. Fwrd가 그렇게 보내요.

## iPhone 문자를 Home Assistant로 보내는 방법

1. **자동화를 만드세요.** Home Assistant에서 ‘Settings’, ‘Automations & scenes’, ‘Create automation’, ‘Create new automation’ 순서로 가세요. ‘When’ 섹션에서 ‘Add trigger’를 선택하고 Webhook 트리거를 추가한 다음 ‘Webhook ID’는 그대로 두세요.

2. **iPhone이 어떻게 닿을지 정하세요.** Home Assistant 문서에 따르면 웹후크는 기본으로 같은 네트워크의 기기나 Nabu Casa Cloud 웹후크에만 응답해요. Home Assistant Cloud라면 ‘Only accessible from the local network’를 켜 둔 채로 두세요. 내 도메인이나 리버스 프록시라면 ‘Webhook ID’ 옆 톱니바퀴를 선택해서 그 옵션을 끄세요. iPhone은 어디에 있든 그 위치에서 보내기 때문이에요.

3. **HTTPS 주소를 마련하세요.** Home Assistant Cloud라면 자동화를 저장하고 ‘Settings’, ‘Cloud’로 가서 웹후크 카드까지 스크롤한 다음 내 웹후크 옆의 ‘Manage’를 선택하세요. Nabu Casa의 [웹후크 문서](https://support.nabucasa.com/hc/en-us/articles/25619382358685)(2026년 10월 18일 확인)에 따르면 그 대화상자에 웹후크의 고유 URL이 나와요. 내 도메인이라면 주소는 `https://`, 도메인, `/api/webhook/`, ID 순서예요.

4. **[Fwrd](https://apps.apple.com/app/apple-store/id6759069713?pt=128544281&ct=ko-blog-home-assistant&mt=8)에서 ‘웹후크’ 보낼 곳을 추가하세요.** Fwrd를 열고 ‘+’를 탭한 다음 ‘웹후크’를 고르세요. HTTPS 주소 전체를 ‘설정’에 붙여 넣으세요. ‘테스트 메시지 보내기’를 탭한 뒤 체크 표시로 저장하세요.

5. **단축어에서 ‘메시지’ 자동화를 만드세요.** iOS 27에서는 단축어 앱을 열고 ‘보관함’, ‘자동화’, ‘+’를 차례로 탭한 다음 ‘메시지’를 고르세요. iOS 26에서는 ‘자동화’ 탭을 열고 ‘+’를 탭한 다음 ‘메시지’를 고르세요. ‘메시지 포함 내용’(iOS 27에서는 ‘메시지 다음을 포함’)을 고르고 문자들이 공통으로 쓰는 단어를 입력하세요. 예를 들면 alarm이에요.

6. **묻지 않고 실행되게 하세요.** iOS 27에서는 트리거 옆 화살표를 탭하고 ‘실행 전에 확인’이 꺼져 있는지 확인하세요. ⓘ > ‘개인정보 보호’에서 ‘잠겨 있는 동안 실행 허용’이 켜져 있는지도 확인하세요. iOS 26에서는 ‘즉시 실행’을 고르고 ‘다음’, ‘새로운 단축어 생성’을 차례로 탭하세요.

7. **Fwrd의 동작을 추가하세요.** ‘전달’로 검색하고 ‘모든 보낼 곳으로 메시지 전달’을 추가하세요. ‘메시지’를 ‘단축어 입력’으로 설정하세요(iOS 26에서는 ‘단축어 입력’, ‘메시지’ 순서예요). 뒤로 가기를 탭해 저장하세요(iOS 26에서는 ‘완료’).

8. **이제 끝났어요.** 내 단어가 들어 있는 새 문자가 iPhone이 잠겨 있어도 알아서 Home Assistant에 닿아요.

[웹후크 안내](https://www.fwrdsms.com/ko/guides/webhook)에 Fwrd의 모든 화면이 있고, 요청은 [iPhone SMS를 웹후크로 전달하기](https://www.fwrdsms.com/ko/iphone-sms-to-webhook)에서 자세히 다뤄요.

Watch the setup video on the [setup guide](https://www.fwrdsms.com/ko/guides/webhook).

### 자동화는 YAML로 어떻게 생겼나요?

Fwrd의 본문은 `{"content": "…", "text": "…"}`이고 두 항목 모두 문자가 받은 그대로 들어 있어서, 자동화는 `trigger.json.content`를 읽어요. 아래 자동화는 문자에 alarm이 들어 있으면 현관 조명을 켜요.

```yaml
alias: Alarm text turns on the porch light
triggers:
  - trigger: webhook
    webhook_id: "a-long-random-id-only-you-know"
    allowed_methods:
      - POST
    local_only: false # only needed without Home Assistant Cloud
conditions:
  - condition: template
    value_template: "{{ 'alarm' in trigger.json.content | lower }}"
actions:
  - action: light.turn_on
    target:
      entity_id: light.porch
```

동작을 스피커 안내 방송으로 바꾸면 택배 기사님의 “배송 출발” 문자가 집에 택배가 온다고 알려 줄 수 있어요. Fwrd 설정에서 ‘보낸 사람 포함’을 켜고 Fwrd 동작의 ‘보낸 사람’ 항목을 채우면 본문에 `sender` 항목도 더해지고, `trigger.json.sender`로 읽을 수 있어요.

## Fwrd는 웹후크에 무엇을 더하나요?

Fwrd의 ‘웹후크’ 보낼 곳이 올리는 일을 맡아서, 자동화는 동작 하나면 돼요.

- **필터.** 웹후크 보낼 곳은 내가 고른 단어가 들어 있는 문자, 인증 코드처럼 보이는 문자, 정해진 시간대에 온 문자만 남길 수 있어요. ‘문자로 테스트’는 샘플 문자로 필터를 확인해 줘요. 필터가 건너뛴 문자는 무료 전달 1건으로 세지 않아요.
- **문자 하나를 여러 곳으로.** 같은 동작으로 Home Assistant와 Slack, Discord, Telegram, Teams의 가족 채팅에 문자를 한꺼번에 보낼 수 있어요.
- **중복 없는 재시도.** 시간이 초과되거나 서버가 바쁘면 Fwrd가 최대 두 번 다시 보내고, 매번 같은 `Idempotency-Key` 헤더를 달아요.
- **주소는 비공개로 남아요.** Fwrd는 URL을 단축어 안이 아니라 iPhone의 키체인에 보관해요. Fwrd 계정도 서버도 없어요. 문자는 내 iPhone에서 Home Assistant로 바로 가요.
- **휴대폰에 남는 기록.** 전달마다 Home Assistant가 받아들였는지 보여 줘요.

## 알아 둘 한계

- **웹후크 ID가 곧 암호예요.** Home Assistant 문서에 따르면 웹후크에는 다른 로그인이 없으니, 길고 추측하기 어려운 ID를 쓰고 비공개로 하세요. Fwrd는 로그인 헤더를 추가하지 않아요.
- **잠금장치를 여는 데 쓰지 마세요.** 같은 문서가 문이나 차고 문의 잠금을 여는 웹후크 자동화를 경고해요. 조명, 스피커, 알림이 더 알맞아요.
- **Fwrd에는 공개 HTTPS 주소가 필요해요.** IP 주소와 .local로 끝나는 이름은 받지 않고 리디렉션도 거부하니, 최종 주소를 붙여 넣으세요. 클라우드 웹후크 URL에는 Home Assistant Cloud 구독이 필요해요.
- **휴대폰이 켜져 있고 온라인이어야 해요.** 자동화에 맞는 새 문자만 보내고, 재시작한 뒤에는 iPhone 잠금을 한 번 해제할 때까지 전달이 기다려요.

## 자주 묻는 질문

### Home Assistant가 문자 자체를 읽을 수 있나요?

네. Fwrd는 문자 전체를 `content`와 `text`에 담아 보내서, `trigger.json.content` 같은 템플릿에 들어 있어요. 조건에서 단어를 맞추거나, 알림에 문자를 넣거나, 스피커가 읽어 주게 할 수 있어요.

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

아니요. 내 서버에 닿는 HTTPS 주소라면 어떤 것이든 돼요. 리버스 프록시 뒤에 있는 내 도메인이 그 예예요. Home Assistant의 [원격 접속 페이지](https://www.home-assistant.io/docs/configuration/remote/)(2026년 10월 18일 확인)는 Home Assistant Cloud를 공유기 포트를 열 필요가 없는 쉬운 방법이라고 설명해요.

### 집 밖에서도 작동하나요?

네, Home Assistant Cloud 웹후크 URL로, 또는 ‘Only accessible from the local network’를 끈 내 공개 HTTPS 도메인으로 작동해요. iPhone은 어디에 있든 Wi-Fi나 셀룰러 데이터로 보내요.

### Fwrd는 비용이 얼마나 드나요?

Fwrd는 매달 15건까지 무료이고, 문자 하나는 몇 곳으로 보내도 1건으로 세어요. Fwrd Pro는 한도를 없애 주며, 요금은 미국 기준으로 월 $4.99 또는 연 $29.99예요.

## 더 읽어 보기

- [알람 문자를 그룹 채팅방에 함께 보기](https://www.fwrdsms.com/ko/blog/forward-alarm-sensor-texts-to-group-chat)
- [단축어 앱에서 웹후크 보내는 방법](https://www.fwrdsms.com/ko/blog/apple-shortcuts-webhook)