단축어 앱에서 웹후크 보내는 방법

단축어 앱에서 웹후크를 보내려면 ‘URL 콘텐츠 가져오기’ 동작을 추가하고, 웹후크 주소를 붙여 넣고, ‘메소드’를 POST로 바꾼 다음 ‘본문 요청’을 JSON으로 만들면 돼요. 어떤 단축어에서든 쓸 수 있고, 받는 쪽이 키를 요구하면 사용자 지정 헤더도 넣을 수 있어요. 들어오는 문자는 Fwrd의 동작이 요청을 대신 만들어 줘요.

필요한 것: 단축어 앱이 있는 iPhone(기본으로 설치돼 있어요)과 웹후크 주소예요. Discord나 Slack 채널의 웹후크, Zapier, Make, n8n 트리거, 내 서버 모두 괜찮아요. Fwrd를 쓰려면 iOS 26 이상도 필요해요.

‘URL 콘텐츠 가져오기’는 무엇을 하나요?

‘URL 콘텐츠 가져오기’는 웹 주소와 통신하는 Apple의 기본 동작이에요. 요청을 보내고 돌아온 응답을 넘겨줘요. 메소드를 POST로 하면 웹후크를 보내는 동작이 돼요.

Apple 단축어 사용 설명서의 첫 API 요청하기 페이지(2026년 10월 17일 기준)에 따르면 ‘더 보기’를 탭하면 메소드 다섯 가지가 나와요. GET, POST, PUT, PATCH, DELETE예요. POST, PUT, PATCH로 바꾸면 ‘본문 요청’ 항목이 생겨서 JSON, ‘형식’, ‘파일’ 중 하나를 보낼 수 있어요. 웹후크는 대부분 JSON을 담은 POST를 원해요.

단축어로 웹후크를 보내는 방법

1. 단축어를 만드세요. 단축어 앱을 열고 +를 탭해 새 단축어를 만드세요.

2. 동작을 추가하세요. ‘URL 콘텐츠 가져오기’를 검색해서 추가하세요. URL 항목을 탭하고 웹후크 주소를 끝까지 붙여 넣으세요.

3. 메소드를 설정하세요. 동작에서 ‘더 보기’를 탭한 다음 ‘메소드’를 GET에서 POST로 바꾸세요.

4. JSON 본문을 만드세요. ‘본문 요청’을 JSON으로 설정하고 텍스트 항목을 추가하세요. 키는 서비스가 읽는 이름이에요. Discord는 content, Slack은 text를 읽어요. 값에는 보낼 메시지를 입력하거나 앞 단계의 변수를 고르세요.

5. 받는 쪽이 요구하면 헤더를 추가하세요. Matthew Cassinelli의 URL 콘텐츠 가져오기 설명에 나와 있듯이, 이 동작의 옵션에서 ‘헤더’도 넣을 수 있어요. 흔히 쓰는 것은 키가 Authorization이고, 값이 Bearer, 공백, 내 토큰 순서인 헤더예요. Discord와 Slack 웹후크에는 필요 없어요.

6. 실행하세요. 재생 버튼을 탭하세요. 메시지가 채널이나 워크플로에 도착하고, 서버가 돌려준 응답은 동작의 출력으로 돌아와요.

JSON 본문은 어떤 모양인가요?

content라는 텍스트 항목 하나를 두면 단축어는 아래와 같은 본문을 보내요. Discord 웹후크에는 이것만 있으면 돼요.

{
  "content": "Hello from Shortcuts"
}

Discord 웹후크 문서는 content, file, embeds, poll 중 하나를 요구해요. Slack은 Slack의 수신 웹후크 가이드처럼 항목 이름을 text로 하세요. Zapier, Make, n8n은 항목 이름을 마음대로 정할 수 있어요.

들어오는 문자를 웹후크로 보내려면 어떻게 하나요?

같은 동작을 ‘메시지’ 자동화 안에 넣으면 조건에 맞는 문자가 올 때마다 실행돼요. ‘URL 콘텐츠 가져오기’로 본문을 직접 만들거나, 본문을 대신 만들어 주는 Fwrd의 동작을 쓰면 돼요.

자동화를 만드는 방법은 어느 쪽이든 같아요. 단축어에서 ‘메시지’ 자동화를 만들고, iOS 26에서는 ‘메시지 포함 내용’, iOS 27에서는 ‘메시지 다음을 포함’에 문자에 공통으로 들어 있는 단어를 넣고, 묻지 않고 실행되게 하세요. iOS 26에서는 ‘즉시 실행’을 고르고 ‘다음’, ‘새로운 단축어 생성’을 탭하세요. 자동화 가이드에서 iOS 26과 iOS 27 단계를 하나씩 안내해요.

설정 방법은 이래요.

• Fwrd에서. Fwrd에서 ‘웹후크’ 보낼 곳을 추가하고 HTTPS 주소를 붙여 넣으세요. 그런 다음 자동화에 Fwrd의 ‘모든 보낼 곳으로 메시지 전달’을 추가하고(iOS 26에서는 먼저 ‘동작 추가’를 탭하세요) ‘메시지’를 ‘단축어 입력’으로 설정하세요(iOS 26에서는 ‘단축어 입력’을 고른 다음 ‘메시지’). 모든 탭은 iPhone 문자를 웹후크로 전달하기에 있어요.

Fwrd는 content와 text 둘 다에 받은 그대로의 메시지를 담은 JSON을 보내요. 그래서 어느 항목을 읽는 받는 쪽이든 쓸 수 있어요. Fwrd 설정에서 ‘보낸 사람 포함’을 켜고 Fwrd 동작의 ‘보낸 사람’ 항목을 채우면 본문에 sender 항목도 더해져요. 문자마다 Idempotency-Key 헤더가 붙고, 다시 시도해도 같은 값이 유지돼서 서버가 중복을 걸러낼 수 있어요. 서버 쪽 설정은 웹후크 가이드에, 각 도구별 단계는 Zapier, Make, n8n에 있어요.

Fwrd가 문자에 더해 주는 것

문자에서 중요한 점이에요.

• 계정이 필요 없어요. Fwrd에는 로그인도 Fwrd 서버도 없어요. 문자는 iPhone에서 내 URL로 바로 가요.
• 다시 시도해요. 전송이 시간 초과되거나 429 또는 5xx를 받거나 연결이 끊기면 Fwrd가 최대 두 번 다시 시도해요.
• 동작 하나로 보낼 곳 여덟 곳. 이메일, 다른 전화 또는 iMessage, WhatsApp, Discord, Slack, Microsoft Teams, Telegram, 내 웹후크예요. 뒤의 다섯 곳은 Fwrd가 직접 보내고, 앞의 세 곳은 Apple 또는 WhatsApp의 보내기 동작에 문자를 넘겨요.
• iPhone의 기록에서 전달마다 전달 여부를 볼 수 있어요.

각각 할 수 없는 것

• Fwrd는 사용자 지정 헤더를 추가할 수 없어요. 로그인 헤더를 보내지 않으니, 받는 쪽은 Discord, Slack, Zapier, Make, n8n 웹후크처럼 헤더 없이도 요청을 받아야 해요.
• Fwrd에는 공개 HTTPS 주소가 필요해요. IP 주소와 .local, .internal 등으로 끝나는 이름은 받지 않고, 리디렉션도 따라가지 않으니 최종 주소를 붙여 넣으세요. n8n은 테스트 URL이 아니라 프로덕션 URL을 붙여 넣고 워크플로를 게시하세요. n8n Webhook 노드 문서에 따르면 그때부터 프로덕션 URL이 응답해요.
• 단축어는 모든 로그인을 처리하지 못해요. Apple의 API 제한 사항 페이지에 따르면 단축어는 로그인 페이지에서 사용자 이름과 암호를 입력해야 하는 OAuth 2 로그인을 처리하지 못해요.
• 문자를 받으려면 iPhone이 켜져 있어야 해요. 들어오는 문자는 iPhone이 켜져 있고 온라인일 때만 전달되고, 자동화에 맞는 새 문자만 보내요.