iPhone 문자를 웹후크에 전달하는 방법
업데이트
내 HTTPS 엔드포인트
선택한 iPhone 메시지를 내가 관리하는 HTTPS 엔드포인트로 보내요.
이 보낼 곳의 작동 방식
이 보낼 곳이 Fwrd에서 활성 상태인 동안 Fwrd는 조건에 맞는 문자를 iPhone에서 이 보낼 곳으로 바로 HTTPS로 보내요.
iPhone 문자를 웹후크로 전달하기: 개요와 자주 묻는 질문시작하기 전에
- 내가 소유했거나 사용 권한이 있는 HTTPS 엔드포인트
- 엔드포인트가 JSON POST를 받고 2xx 상태 코드로 응답해요
- 메시지를 받는 iPhone에 설치한 Fwrd
보낼 곳 설정하기
9단계
이 단계에 나온 Fwrd의 전달 설정은 iOS 27이 필요해요. iOS 26에서는 ‘직접 만들기’ 아래에 나온 대로 웹후크 보낼 곳을 추가하세요.
Fwrd의 요청 수락하기
Fwrd는 원본 문자 내용을 content 필드와 text 필드에 두 번 담은 JSON 본문으로 POST 요청을 보내요. 둘 중 어느 필드를 읽는 서비스든 받을 수 있게 하려는 거예요. Fwrd의 ‘설정’에서 ‘보낸 사람 포함’을 켜고 단축어에서 Fwrd의 동작에 ‘보낸 사람’을 지정하면 본문에 sender 필드도 들어가요. 2xx 상태 코드로 응답하면 전달된 것으로 세어요. 리디렉션은 거부하므로 최종 주소를 알려 주세요.
{"content": "Your message", "text": "Your message"}중복 재시도 무시하기
요청이 실패하면 Fwrd가 다시 시도할 수 있어요. 같은 메시지의 모든 시도에는 같은 Idempotency-Key 헤더가 붙으므로, 엔드포인트에서 중복을 버릴 수 있어요.
URL은 비밀로 지키세요
Fwrd는 인증 헤더를 추가하지 않아요. 보낼 곳에서 비밀 값이 필요하면 URL에 넣으세요. Fwrd는 주소 전체를 iPhone의 키체인에 저장해요.
Fwrd의 전달 설정에서 ‘웹후크’ 선택하기
iPhone에서 Fwrd를 열고 소개 페이지 끝에 있는 ‘전달 설정’을 탭하세요. 문자를 어디로 보낼지 물으면 ‘웹후크’를 선택하세요.
URL을 Fwrd에 붙여 넣기
HTTPS 주소 전체를 ‘웹후크 URL’에 붙여 넣고 계속하세요.
‘웹후크 URL’ ← 내 HTTPS 엔드포인트준비된 단축어 추가하기
전달할 문자를 고르세요. ‘단축어 가져오기’를 탭하세요. 단축어 앱에서 ‘단축어 추가’를 탭한 다음 왼쪽 위의 ◀ Fwrd를 탭하세요.
켜기
‘단축어 열기’를 탭하세요. 단축어 앱에서 ‘편집’을 탭하고 ‘다음 조건에 맞는 메시지를 수신할 때’ 줄의 ›를 탭한 다음(×가 아니에요) ‘자동화’를 켜세요.
첫 실행 허용하기
Fwrd가 샘플 문자로 단축어를 한 번 실행하며, 이 실행은 전달 1건으로 세어요. 처음에는 단축어가 두 번 물어봐요. ‘허용’을 탭한 다음 ‘항상 허용’을 탭하세요.
모두 끝났어요
이제 끝났어요. 조건에 맞는 새 문자가 iPhone이 잠겨 있어도 알아서 내 엔드포인트로 전달돼요. iPhone을 재시작한 뒤에는 한 번 잠금을 해제하면 전달이 이어져요.
직접 만들기
iOS 26을 쓰고 있거나 자동화를 직접 만들고 싶다면, 대신 이 단계를 따르세요. 이미 Fwrd가 어딘가로 문자를 전달하고 있다면, 웹후크 저장까지만 하면 끝이에요. 내 자동화가 활성화된 모든 보낼 곳으로 보내요.
설정 과정 보기
iOS 27의 Fwrd와 단축어에서 하는 모든 탭을 1분 이내 안에 보여 드려요. 어느 단계에서든 멈추거나, 아래에서 단계를 골라 바로 이동하세요.
iOS 27의 Fwrd 1.1에서 보여 드려요. 주소와 번호는 예시예요.
Fwrd에 웹후크 추가
iPhone에서 Fwrd를 열고 화면 아래의 +를 탭한 다음 ‘웹후크’를 선택하세요. 이름을 바꿔 보낼 곳을 구분할 수 있어요.
URL을 Fwrd에 붙여 넣기
HTTPS 주소 전체를 ‘설정’ 필드에 붙여 넣으세요.
‘설정’ ← 내 HTTPS 엔드포인트저장하고 보낼 곳을 활성 상태로 두기
‘테스트 메시지 보내기’를 탭한 다음 오른쪽 위의 체크 표시를 탭해서 저장하세요. iOS에서 암호 저장을 제안하면 ‘지금 안 함’을 탭하세요. Fwrd가 이미 iPhone의 키체인에 보관해 두고 있어요. ‘보낼 곳 활성화’는 켜 둔 채로 두세요. 비활성 경로는 iPhone에 저장돼 있어도 메시지가 도착할 때 건너뛰어요.
‘보낼 곳 활성화’ ← 켬‘메시지’ 자동화 만들기
문자를 받는 iPhone에서 단축어를 여세요. iOS 27에서는 ‘보관함’ > ‘자동화’로 이동해 +를 탭하세요. ‘단축어 설명’이 보이면 ‘편집’을 탭하세요. ‘자동화’를 탭한 다음 ‘메시지’를 탭하고 ‘보낸 사람’을 ‘메시지’로 바꾸세요. 문자에 들어 있는 단어(예: code, verification)를 입력하세요. 메시지로 일치시키면 ‘보낸 사람’으로는 잡을 수 없는 단축 번호와 연락처에 없는 보낸 사람의 문자도 받을 수 있어요. 그다음 트리거 옆의 화살표를 탭하고 ‘실행 전에 확인’이 꺼져 있는지 확인하세요. ⓘ > ‘개인정보 보호’에서 ‘잠겨 있는 동안 실행 허용’이 켜져 있는지 확인하세요. iOS 26에서는 ‘자동화’, +, ‘메시지’를 차례로 탭하고 ‘즉시 실행’을 선택하세요.
‘메시지 다음을 포함’ ← 내 단어 · ‘실행 전에 확인’ ← 끔 · ‘잠겨 있는 동안 실행 허용’ ← 켬
Fwrd의 메시지 전달 동작 추가
‘전달’을 검색해서 트리거 아래에 Fwrd의 ‘모든 보낼 곳으로 메시지 전달’을 추가하세요. 그 안의 ‘메시지’를 탭하고 ‘변수 선택’을 탭한 다음 ‘단축어 입력’을 선택하세요. 단축어가 맨 위에 ‘…받기’ 블록을 추가하는데, 그대로 두면 돼요. ‘뒤로’를 탭해서 저장하세요. iOS 26에서는 먼저 ‘새로운 단축어 생성’을 탭한 다음 동작을 추가하세요. 그 동작의 ‘메시지’는 ‘단축어 입력’으로 채워져요. ‘완료’를 탭하세요.
‘메시지’ = ‘단축어 입력’
모두 끝났어요
이제 끝났어요. 조건에 맞는 새 문자가 iPhone이 잠겨 있어도 알아서 내 엔드포인트로 전달돼요. iPhone을 재시작한 뒤에는 한 번 잠금을 해제하면 전달이 이어져요.
단축어 화면은 iOS 26과 iOS 27에서 서로 달라요. 자동화 가이드에서 두 버전을 모두 안내해요.
메시지가 도착하지 않는 경우
- Fwrd가 그 시도를 ‘실패’로 표시해요
- 엔드포인트는 15초 안에 2xx 상태 코드로 응답해야 해요. Fwrd는 리디렉션을 따라가지 않으니 최종 주소를 쓰세요.
- 같은 메시지가 두 번 도착해요
- Fwrd는 요청이 실패하거나 시간이 초과되면 다시 시도해요. Idempotency-Key를 이미 본 요청은 모두 버리세요.
- 본문이 예상과 달라요
- Fwrd는 content와 text 필드가 있는 JSON을 보내요. 두 필드 모두 받은 그대로의 원본 문자 내용이 들어 있어요. 타임스탬프나 제목은 없어요. sender 필드는 Fwrd의 ‘설정’에서 ‘보낸 사람 포함’을 켜고 단축어에서 Fwrd의 동작에 ‘보낸 사람’을 지정한 경우에만 추가돼요.
모든 보낼 곳에 해당하는 문제, 예를 들어 문자가 자동화를 실행하지 않는 문제는 문제 해결 가이드에 있어요.
자주 묻는 질문
알아 두면 좋은 점
문자를 받는 iPhone은 켜 두고 온라인 상태를 유지하세요. 재시작한 뒤에는 잠금을 한 번 해제하면 전달이 이어져요. 모든 전달은 Fwrd의 ‘활동’에 기록돼요.