iPhone SMS API가 있나요? iOS에서 문자 받는 법

아니요, 공개된 iPhone SMS API는 없어요. iOS에서는 앱이 문자 메시지를 읽을 수 없고, 문자가 왔다는 사실조차 알 수 없어요. 지원되는 방법은 Apple 단축어 앱에서 한 번 만들어 두는 ‘메시지’ 자동화이고, 이 자동화가 조건에 맞는 문자를 하나씩 동작에 넘겨 줘요. Fwrd는 개발자를 위한 그 동작이에요. 각 문자를 iPhone에서 내 HTTPS 웹후크로 JSON 형태로 보내요.

준비물: iOS 26 이상의 iPhone, 단축어 앱(iPhone에 이미 들어 있어요), 그리고 JSON POST를 받는 HTTPS 엔드포인트예요. 내 서버나 Zapier, Make, n8n 웹후크가 해당해요.

iOS 앱은 SMS 메시지를 읽을 수 있나요?

아니요. 서드파티 iOS 앱은 메시지 받은 편지함을 읽을 수 없고, 문자가 도착해도 알림을 받지 못해요. iPhone에서 문자를 꺼내는 모든 방법은 사용자가 일부러 설정해 둔 것을 거쳐요.

Apple 개발자 포럼의 2017년 답변은 앱이 SMS 메시지를 볼 수 없고 도착했다는 사실도 알 수 없다고 분명히 말해요. 2025년 10월에는 Apple 엔지니어가 포럼에서 macOS에도 사용자의 SMS 메시지를 위한 API가 없다고 밝혔어요. 그래서 내 Apple 계정에 로그인한 Mac이 뒷문이 되지는 않아요.

TelephonyMessagingKit은 어떤가요?

TelephonyMessagingKit은 실제로 있지만, 메시지 앱을 대체하는 기본 통신사 메시지 앱을 위한 것이고 EU에서만 쓸 수 있어요. 일반 앱이 내 문자를 읽는 방법은 아니에요.

Apple 문서에 따르면 이 프레임워크는 iPhone의 SMS, MMS, RCS를 다뤄요. 하지만 앱에 특별한 권한이 필요하고, 사용자가 기본 통신사 메시지 앱으로 고른 뒤에만 작동하고, 사용자가 EU 계정을 갖고 기기가 EU에 있어야 해요. 스크립트, 데이터베이스, AI 에이전트에서 문자를 쓰려는 경우에는 맞는 도구가 아니에요.

그러면 앱은 SMS 코드를 어떻게 채우나요?

메시지를 읽는 것이 아니라 자동 완성으로 채워요. iOS가 받은 문자에서 일회용 코드를 알아보고 키보드 위에 보여 주고, 사용자가 탭해야 앱이 코드를 받아요.

Apple의 텍스트 입력 보기에서 암호 자동 완성 사용하기 가이드는 일회용 코드를 콘텐츠 유형으로 꼽고, SMS 로그인 흐름의 보안 코드를 자동 완성할 수 있다고 설명해요. UIKit에서는 textContentType = .oneTimeCode예요. 내 앱의 로그인을 매끄럽게 하는 데는 이것으로 충분해요.

iPhone 문자를 내 코드로 가져오려면?

단축어 ‘메시지’ 자동화를 만들고 Fwrd의 동작을 추가하세요. Fwrd는 조건에 맞는 문자를 iPhone에서 내 엔드포인트로 JSON 형태로 보내요. Apple의 메시지 트리거는 내가 추가한 보낸 사람이나 문구가 들어 있는 메시지가 오면 실행돼요.

아래 단계는 Fwrd의 ‘웹후크’ 보낼 곳을 써요.

1. Fwrd에서 웹후크를 추가하세요. Fwrd를 열고 ‘+’를 탭한 다음 ‘웹후크’를 고르세요. HTTPS 주소 전체를 ‘설정’ 항목에 붙여 넣고, ‘테스트 메시지 보내기’를 탭해서 엔드포인트가 항목들을 받게 한 다음 저장하세요.

2. ‘메시지’ 자동화를 만드세요. iOS 27에서는 단축어 앱을 열고 ‘보관함’, ‘자동화’, ‘+’를 차례로 탭하세요. ‘단축어 설명’이 보이면 ‘편집’을 탭하세요. 그다음 ‘자동화’, ‘메시지’를 탭하세요. iOS 26에서는 ‘자동화’ 탭을 열고 ‘+’를 탭한 다음 ‘메시지’를 고르세요.

3. 보낼 문자를 고르세요. ‘메시지 포함 내용’을 선택하고(iOS 27에서는 ‘보낸 사람’을 ‘메시지’로 바꾸면 ‘메시지 다음을 포함’이 돼요) 문자에 들어 있는 단어를 입력하세요. 예를 들면 code예요. 공백 하나를 입력하면 공백이 들어 있는 문자를 모두 보내요.

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

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

6. 이제 끝났어요. 내 단어가 들어 있는 새 문자가 iPhone이 잠겨 있어도 알아서 엔드포인트로 가요.

JSON은 어떤 모습인가요?

Fwrd는 각 문자를 Content-Type: application/json인 POST로 웹후크에 보내요. 기본 본문에는 메시지가 받은 그대로 두 번 들어 있어요. Mattermost와 Rocket.Chat이 text를 읽기 때문이에요.

{
  "content": "Your code is 482913",
  "text": "Your code is 482913"
}

타임스탬프는 없어요. Fwrd 설정에서 ‘보낸 사람 포함’을 켜고 단축어의 Fwrd 동작에서 ‘보낸 사람’을 고르면 본문에 sender 항목도 더해져요. 같은 문자에 대한 모든 시도는 같은 Idempotency-Key 헤더를 달고 가므로 중복을 버릴 수 있어요. 15초 안에 오는 2xx 응답은 모두 전달된 것으로 세고, 리디렉션은 거부해요. 엔드포인트 쪽은 웹후크 안내에 전부 있어요.

방법별로 비교하면

Fwrd는 그 번거로운 부분을 대신해요.

• 계정이 필요 없어요. Fwrd에는 로그인도 Fwrd 서버도 없어요. 문자는 내 iPhone에서 내 URL로 바로 가요.
• 필터. 웹후크마다 내가 고른 단어가 들어 있는 문자, 인증 코드처럼 보이는 문자, 정해진 시간대의 문자만 남길 수 있어요.
• 재시도와 비밀 정보를 대신 처리해요. 시간이 초과되거나, 429 또는 5xx를 받거나, 연결이 끊기면 Fwrd가 최대 두 번 다시 보내요. URL은 단축어 안이 아니라 iPhone의 키체인에 보관해요.
• 보낼 곳 8개. 같은 동작으로 이메일, 다른 전화 또는 iMessage, WhatsApp, Discord, Slack, Microsoft Teams, Telegram도 다뤄요.

iPhone을 SMS 게이트웨이로 쓸 수 없는 이유

iPhone은 내 서버의 SMS 게이트웨이가 될 수 없어요. 서버가 iPhone을 거쳐 문자를 보내게 해 주는 API가 iOS에는 없어서, Fwrd는 받기 전용이에요. 문자는 iPhone으로 들어와 내 엔드포인트로 나가요.

• API로 보내기. API로 SMS를 보내는 게이트웨이 앱은 Android에서 돌아가요. textbee.dev는 FAQ에서 현재 Android 기기에서만 작동한다고 밝혀요(2026년 10월 16일 기준).
• 규칙이 필요해요. 자동화는 내가 고른 단어가 들어 있는 문자나 연락처에 있는 사람이 보낸 문자에 반응해요. 공백 하나는 공백이 들어 있는 문자를 모두 잡아요.
• 휴대폰이 켜져 있고 온라인이어야 해요. 문자를 받는 iPhone은 문자가 올 때 켜져 있고 Wi-Fi나 셀룰러 데이터가 연결되어 있어야 해요. 재시작한 뒤에는 한 번 잠금을 해제할 때까지 전달이 기다려요.
• 글자만 전달돼요. 사진은 오지 않고, 답장은 iPhone에서 보내요.