iPhone 문자를 Home Assistant로 보내기

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의 자동화 트리거 문서(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의 웹후크 문서(2026년 10월 18일 확인)에 따르면 그 대화상자에 웹후크의 고유 URL이 나와요. 내 도메인이라면 주소는 https://, 도메인, /api/webhook/, ID 순서예요.

4. Fwrd에서 ‘웹후크’ 보낼 곳을 추가하세요. 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에 닿아요.

웹후크 안내에 Fwrd의 모든 화면이 있고, 요청은 iPhone SMS를 웹후크로 전달하기에서 자세히 다뤄요.

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

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

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 잠금을 한 번 해제할 때까지 전달이 기다려요.