# Cách gửi webhook từ Phím tắt cho mỗi tin nhắn SMS

> Gửi webhook từ Phím tắt cho mỗi tin nhắn SMS đến iPhone của bạn. Tác vụ của Fwrd đăng JSON kèm Idempotency-Key ổn định đến endpoint HTTPS của bạn.

Cập nhật lần cuối: 2026-11-02
Trang HTML gốc: https://www.fwrdsms.com/vi/blog/apple-shortcuts-webhook
Published: 2026-10-17

Để gửi webhook từ Phím tắt mỗi khi có tin nhắn SMS đến, hãy thêm địa chỉ HTTPS của bạn vào Fwrd làm nơi nhận kiểu Webhook, rồi chạy tác vụ “Forward Message to All Destinations” của Fwrd từ một mục tự động hóa Tin nhắn. Fwrd đăng từng tin nhắn phù hợp đến địa chỉ của bạn dưới dạng JSON, với nội dung tin nhắn nằm trong `content` và `text`. Bạn không phải xây dựng gì cả, và địa chỉ được lưu trong Chuỗi khóa của iPhone.

**Bạn cần:** iPhone chạy iOS 26 trở lên với ứng dụng Phím tắt (có sẵn trên máy), [Fwrd](https://apps.apple.com/app/apple-store/id6759069713?pt=128544281&ct=vi-blog-shortcuts-webhook&mt=8), và một địa chỉ webhook HTTPS công khai, ví dụ trình kích hoạt của Zapier, Make hoặc n8n, hay máy chủ của riêng bạn.

## Tác vụ của Fwrd làm gì trong một phím tắt?

Tác vụ của Fwrd cho việc này là “Forward Message to All Destinations”. Mục tự động hóa Tin nhắn nhận ra từng tin nhắn mới khớp với từ khóa của bạn và đưa nó cho tác vụ, rồi tác vụ lo việc gửi.

Với nơi nhận kiểu Webhook, mỗi tin nhắn được gửi đi dưới dạng một yêu cầu POST JSON:

- **Phần nội dung** chứa tin nhắn y như khi nó đến, trong `content` và lặp lại trong `text`, nên bên nhận đọc trường nào cũng có tin nhắn.
- **Header `Idempotency-Key`** giữ nguyên ở mọi lần gửi lại của tin nhắn đó, để máy chủ của bạn bỏ qua các bản lặp.
- **Trường `sender`** chỉ được thêm khi bạn bật “Include Who Sent It” trong “Settings” của Fwrd và điền vào trường “Sender” trên tác vụ của Fwrd.

## Làm thế nào để gửi webhook cho mọi tin nhắn?

Thêm webhook vào Fwrd, để Fwrd đưa cho bạn một phím tắt dựng sẵn, rồi bật mục tự động hóa lên. Các bước như sau:

1. **Lấy địa chỉ webhook.** Đó phải là một địa chỉ HTTPS công khai. Fwrd không thêm header xác thực, nên nếu endpoint cần một bí mật, hãy làm đường dẫn là một chuỗi ngẫu nhiên dài.

2. **Thêm webhook vào Fwrd.** Mở Fwrd và làm theo phần thiết lập: chọn Webhook, dán URL của endpoint, rồi chọn những tin nhắn cần chuyển tiếp. Fwrd lưu toàn bộ URL trong Chuỗi khóa của iPhone.

3. **Chọn tin nhắn cần gửi.** Trong “Which Texts”, chọn “Only Some Texts” để giữ lại những tin nhắn có các từ nhất định, tin nhắn giống mã xác minh, hoặc tin nhắn đến vào những giờ nhất định. Để nguyên nếu bạn muốn gửi mọi tin nhắn mà mục tự động hóa đưa sang.

4. **Lấy phím tắt.** Chạm vào “Get Shortcut” và thêm phím tắt dựng sẵn của Fwrd trong Phím tắt. Sau đó Fwrd chạy nó một lần với một tin nhắn mẫu, và Phím tắt xin quyền hai lần: chạm vào “Cho phép”, rồi “Luôn cho phép”.

5. **Bật mục tự động hóa.** Trên iOS 27, hãy bật mục tự động hóa của phím tắt. Trên iOS 26, hãy tạo một mục tự động hóa Tin nhắn chạy phím tắt: chọn “Tin nhắn chứa” với một từ mà các tin nhắn của bạn đều có, rồi chọn “Chạy ngay lập tức”.

6. **Xong.** Từ giờ, mỗi tin nhắn phù hợp tự động được gửi đến webhook của bạn, dù iPhone đang khóa hay không.

Muốn tự làm phím tắt? Hãy tạo một mục tự động hóa Tin nhắn chạy mà không hỏi, thêm “Forward Message to All Destinations” của Fwrd ngay sau điều kiện kích hoạt, và đặt “Message” của nó thành “Đầu vào phím tắt”. [Hướng dẫn tự động hóa](https://www.fwrdsms.com/vi/guides/automation) đi qua từng bước cho iOS 26 và iOS 27, còn [Chuyển tiếp SMS từ iPhone đến webhook](https://www.fwrdsms.com/vi/iphone-sms-to-webhook) có mọi thao tác chạm trong Fwrd.

Watch the setup video on the [setup guide](https://www.fwrdsms.com/vi/guides/webhook).

## Webhook nhận được gì?

Một yêu cầu POST với `Content-Type: application/json` và phần nội dung mặc định gồm đúng hai trường. Một tin nhắn ghi “Your code is 123456” sẽ đến như sau:

```json
{
  "content": "Your code is 123456",
  "text": "Your code is 123456"
}
```

Không có dấu thời gian hay tiêu đề, nên hãy tự thêm giờ ở phía bạn khi cần. Fwrd coi mọi phản hồi 2xx là đã gửi được, từ chối chuyển hướng, và cho mỗi yêu cầu 15 giây. Nếu một lần gửi hết thời gian chờ, nhận lỗi 429 hoặc 5xx, hoặc mất kết nối, Fwrd gửi lại tối đa hai lần, với cùng một `Idempotency-Key` mỗi lần.

[Hướng dẫn webhook](https://www.fwrdsms.com/vi/guides/webhook) nói về phía máy chủ, còn [Zapier, Make hoặc n8n](https://www.fwrdsms.com/vi/iphone-sms-to-zapier-make-n8n) có các bước cho từng công cụ.

## Fwrd đem lại gì cho nhà phát triển?

Những điều quan trọng khi một tin nhắn khởi động việc gì đó ở phía bạn:

- **Một tác vụ, không phải xây dựng gì.** Tác vụ của Fwrd gửi theo định dạng mà endpoint của bạn đọc được, nên phím tắt chỉ cần đưa tin nhắn cho nó.
- **`Idempotency-Key` ổn định.** Các lần gửi lại mang theo khóa mà bạn đã thấy.
- **Bộ lọc trong Fwrd.** Mỗi webhook có thể chỉ giữ lại tin nhắn có các từ nhất định, mã xác minh, hoặc tin nhắn đến vào những giờ nhất định.
- **Lịch sử ngay trên iPhone** cho thấy từng lượt chuyển tiếp và việc nó có được gửi đến nơi hay không.
- **Không cần tài khoản.** Fwrd không có đăng nhập và không có máy chủ Fwrd; mỗi tin nhắn đi thẳng từ iPhone của bạn đến URL của bạn.
- **Tám nơi nhận từ một tác vụ.** Email, một điện thoại khác hoặc iMessage, WhatsApp, Discord, Slack, Microsoft Teams, Telegram và webhook của riêng bạn. Fwrd tự đăng đến năm nơi nhận cuối, còn với ba nơi nhận đầu, Fwrd đưa tin nhắn cho tác vụ gửi của chính Apple hoặc WhatsApp.

## Những gì Fwrd không làm được

- **Fwrd không thêm được header tùy chỉnh.** Fwrd không gửi header xác thực, nên endpoint phải chấp nhận yêu cầu mà không có nó, như webhook của Zapier, Make và n8n. Hãy đặt bí mật vào địa chỉ.
- **Fwrd cần một địa chỉ HTTPS công khai.** Fwrd từ chối địa chỉ IP và các tên kết thúc bằng .local, .internal và tương tự, đồng thời từ chối chuyển hướng, nên hãy dán địa chỉ cuối cùng. Với n8n, hãy dán URL production, không phải Test URL, và xuất bản workflow; [tài liệu Webhook node](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook/) của n8n cho biết đó là lúc URL production bắt đầu phản hồi.
- **Tác vụ của Fwrd dành cho tin nhắn đến.** Nó chạy từ một mục tự động hóa Tin nhắn và gửi đi tin nhắn mà nó được đưa cho. Nó không tải trang web hay gọi các dịch vụ khác.
- **Tin nhắn cần iPhone đang bật.** iPhone phải luôn bật và có kết nối internet, và chỉ những tin nhắn mới khớp với mục tự động hóa mới được gửi.

## Những câu hỏi tiếp theo

### Phím tắt có thể gửi webhook mỗi khi có tin nhắn đến không?

Có. Một mục tự động hóa Tin nhắn trong Phím tắt nhận ra từng tin nhắn phù hợp, và tác vụ của Fwrd đăng nó đến webhook của bạn. Chỉ cần thiết lập một lần, từ đó mỗi tin nhắn phù hợp được gửi đi mà bạn không phải chạm vào iPhone.

### Làm sao để cùng một tin nhắn không chạy hai lần trên máy chủ của tôi?

Đọc header `Idempotency-Key` và bỏ qua khóa mà bạn đã xử lý. Fwrd gửi cùng một khóa ở mọi lần gửi của tin nhắn đó, nên lần gửi lại sau khi hết thời gian chờ trông giống hệt lần đầu.

### Fwrd có dùng được với Zapier, Make hoặc n8n không?

Có. Dán catch hook của Zapier, webhook tùy chỉnh của Make hoặc URL production của Webhook node trong n8n vào nơi nhận Webhook của Fwrd, với workflow n8n đã xuất bản, và mỗi tin nhắn phù hợp sẽ khởi động workflow của bạn. Chạm vào “Send Test Message” một lần để công cụ của bạn nhận được trường `content`.

### Fwrd có giá bao nhiêu?

Fwrd miễn phí 15 lượt chuyển tiếp mỗi tháng, và mỗi tin nhắn chỉ tính một lần, dù được chuyển tiếp đến bao nhiêu nơi nhận. Fwrd Pro bỏ giới hạn này.

## Đọc tiếp

- [iPhone có API SMS không?](https://www.fwrdsms.com/vi/blog/iphone-sms-api)
- [Gửi tin nhắn SMS từ iPhone đến Home Assistant](https://www.fwrdsms.com/vi/blog/iphone-texts-to-home-assistant)