AI 에이전트가 SMS 인증 코드를 읽게 하기

AI 에이전트는 iPhone의 문자를 스스로 읽을 수 없어요. 그래서 코드를 건네주는 거예요. 단축어의 ‘메시지’ 자동화가 코드 문자를 Fwrd에 넘기면, Fwrd가 iPhone에서 n8n의 Webhook 노드나 작은 서버처럼 에이전트가 닿을 수 있는 엔드포인트로 게시해요. 그러면 에이전트가 정규식으로 숫자를 뽑아 입력해요. 내가 소유했거나 자동화할 권한이 있는 계정에만 쓰세요.

필요한 것: 코드를 받는 번호가 있는 iOS 26 이상의 iPhone, 단축어 앱(폰에 이미 있어요), Fwrd, 그리고 에이전트가 읽을 수 있는 공개 HTTPS 주소예요. n8n 워크플로, Zapier나 Make 웹후크, 직접 운영하는 서버 같은 것이 해당돼요.

AI 에이전트가 내 iPhone으로 온 SMS 코드를 받으려면?

웹후크를 통해서요. 코드가 iPhone에 도착하면 Fwrd가 JSON으로 내 엔드포인트에 게시하고, 에이전트가 거기서 읽어요.

iOS는 어떤 앱이나 에이전트도 메시지 받은 편지함을 읽지 못하게 해요. 이유는 iPhone SMS API가 있나요?에서 설명해요. 대신 iOS는 내가 직접 설정하는 ‘메시지’ 자동화를 허용해요. 조건에 맞는 문자가 오면 실행되어 다음 동작에 문자를 넘겨 줘요. Fwrd가 그 동작이에요. 계정도 중간의 Fwrd 서버도 없이, iPhone에서 내가 준 주소로 문자를 바로 보내요.

코드가 도착하는 곳은 에이전트에 따라 달라요.

• n8n AI Agent 워크플로. Webhook 노드가 문자를 받고 워크플로가 다음으로 넘겨요. 노드 설정은 iPhone 문자를 n8n으로 전달하기에 있어요.
• 브라우저 에이전트나 직접 만든 LLM 에이전트. 작은 서버가 각 문자를 도착 시각과 함께 저장하고, 에이전트는 코드를 요청한 뒤 가장 최근 코드를 서버에 물어요.
• Zapier나 Make 시나리오. 캐치 훅이나 사용자 지정 웹후크가 실행을 시작해요. 각 도구는 iPhone 문자를 Zapier, Make, n8n으로 보내기에서 다뤄요.

로그인 코드가 아니라 내 문자 전반을 읽는 채팅 어시스턴트라면 ChatGPT, Claude, Gemini가 iPhone 문자를 읽나요?를 보세요.

에이전트가 로그인 코드를 다뤄도 될까요?

내 계정이거나 자동화할 권한이 있는 계정에만, 그리고 서비스가 더 나은 방법을 주지 않을 때만 쓰세요.

• 서비스 자체의 API 토큰을 먼저 쓰세요. 서비스가 API 키, OAuth, 서비스 계정을 제공하면 에이전트에게 그것을 주세요. 에이전트가 로그인 화면을 건드릴 일이 없고, 그것만 따로 폐기할 수 있어요.
• 개인 로그인에는 패스키나 인증 앱을 먼저 쓰세요. SMS 코드는 다른 방법이 없는 로그인에만 남겨 두세요.
• 엔드포인트를 읽을 수 있는 사람은 누구나 코드를 쓸 수 있어요. 주소에 긴 비밀 문자열을 넣고, 쓴 코드는 바로 삭제하고, 엔드포인트의 로그는 비공개로 유지하세요.
• 서비스 약관을 확인하세요. 자동 로그인을 금지하는 서비스도 있고, 코드 공유 자체를 금지하는 은행도 있어요.

코드 문자를 에이전트로 보내는 방법

코드만 남기는 웹후크 보낼 곳을 추가한 다음, 코드 문자를 Fwrd에 넘기는 ‘메시지’ 자동화를 만드세요. 엔드포인트 쪽은 웹후크 가이드에 자세히 나와 있어요.

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

2. 코드만 남기세요. 같은 보낼 곳에서 ‘받을 문자’의 ‘일부 문자만’을 선택하고 ‘코드처럼 보임’을 켜세요. 4~8자리 코드가 들어 있는 문자만 남아요. 조건이 하나라서 무료 플랜에서도 쓸 수 있어요.

3. ‘메시지’ 자동화를 만드세요. iOS 27에서는 단축어 앱을 열고 ‘보관함’ > ‘자동화’ 순서로 탭한 다음 ‘+’를 탭하세요. ‘단축어 설명’이 보이면 ‘편집’을 탭하세요. ‘자동화’를 탭한 다음 ‘메시지’를 탭하고, ‘보낸 사람’을 ‘메시지’로 바꾼 뒤 공백 하나를 입력하세요. 그러면 공백이 들어 있는 문자는 모두 Fwrd의 필터까지 도착해요. iOS 26에서는 ‘자동화’ 탭을 열고 ‘+’를 탭한 다음 ‘메시지’를 선택하고 ‘메시지 포함 내용’에 공백을 입력하세요.

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

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

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

엔드포인트는 무엇을 받을까요?

Content-Type: application/json이 붙은 POST와, 도착한 그대로의 문자예요. 메시지는 content에 들어 있고, 그 필드를 읽는 서비스를 위해 같은 문자가 text에도 들어 있어요. sender 필드는 Fwrd의 ‘설정’에서 ‘보낸 사람 포함’을 켜고 Fwrd의 동작에서 ‘보낸 사람’을 골랐을 때만 추가돼요.

아래 curl 명령은 Fwrd가 보내는 것과 같은 요청을 보내요. 그래서 코드가 오기 전에 에이전트 쪽을 미리 만들 수 있어요.

curl -X POST "https://your-endpoint.example/sms/long-secret" \
  -H "Content-Type: application/json" \
  -d '{"content": "Your code is 123456", "text": "Your code is 123456"}'

코드를 뽑으려면 content에서 처음 나오는 4~8자리 숫자를 찾으세요.

import re

match = re.search(r"\b(\d{4,8})\b", body["content"])
code = match.group(1) if match else None

본문에는 타임스탬프가 없으니 시각은 내 쪽에서 기록하고, 로그인을 시도한 시각보다 오래된 코드는 무시하세요. 같은 문자에 대한 모든 시도에는 같은 Idempotency-Key 헤더가 붙으니 중복은 버릴 수 있어요. n8n과 작은 서버의 동작하는 예제는 GitHub의 fwrd-sms-webhook-examples 저장소에 있어요.

에이전트에 코드를 전하는 방법들

이 설정이 할 수 없는 일

• 이전에 도착한 코드는 읽을 수 없어요. 자동화는 새 문자에만 실행돼요.
• 번호 하나는 한 번에 로그인 하나만 맡을 수 있어요. 에이전트 둘이 같은 번호로 코드를 요청하면 서로의 코드를 읽을 수 있으니, 로그인 단계를 줄 세우세요. CI와 QA 파이프라인은 CI의 SMS 코드에서 그 경우를 다뤄요.
• iPhone은 켜져 있고 온라인이어야 해요. 재시작한 뒤에는 내가 한 번 잠금을 해제할 때까지 전달이 멈추고, 3일 동안 잠금을 해제하지 않은 iPhone은 스스로 재시작해요.
• Fwrd는 로그인 헤더를 보내지 않아요. 비밀 문자열은 주소에 넣으세요. Fwrd는 주소 전체를 iPhone의 키체인에 보관해요. IP 주소와 .local 또는 .internal 이름도 거부해요.
• 한 방향이에요. Fwrd는 에이전트를 위해 iPhone에서 문자를 보낼 수 없어요.