Cara Mengirim Webhook dari Pintasan Apple untuk Setiap SMS

Untuk mengirim webhook dari Pintasan setiap kali SMS masuk, tambahkan alamat HTTPS Anda di Fwrd sebagai tujuan Webhook, lalu jalankan tindakan Fwrd “Teruskan Pesan ke Semua Tujuan” dari automasi Pesan. Fwrd memposting setiap SMS yang cocok ke alamat Anda sebagai JSON, dengan isi pesan di content dan text. Tidak ada yang perlu Anda bangun, dan alamatnya tetap tersimpan di Rantai Kunci iPhone.

Yang Anda perlukan: iPhone dengan iOS 26 atau yang lebih baru dan app Pintasan (sudah ada di ponsel Anda), Fwrd, serta alamat webhook HTTPS publik, misalnya pemicu Zapier, Make, atau n8n, atau server Anda sendiri.

Apa yang dilakukan tindakan Fwrd di dalam pintasan?

Tindakan Fwrd untuk ini adalah “Teruskan Pesan ke Semua Tujuan”. Automasi Pesan mendeteksi setiap SMS baru yang cocok dengan kata kunci Anda dan menyerahkannya ke tindakan itu, lalu tindakan itulah yang mengirim.

Untuk tujuan Webhook, setiap SMS dikirim sebagai satu POST JSON:

• Isi permintaan memuat pesan persis seperti saat diterima, di content dan sekali lagi di text, sehingga penerima yang membaca salah satu kolom tetap mendapatkannya.
• Header Idempotency-Key tetap sama pada setiap percobaan untuk SMS itu, jadi server Anda bisa membuang pengulangan.
• Kolom sender ditambahkan hanya jika Anda menyalakan “Sertakan Pengirim” di Pengaturan Fwrd dan mengisi kolom “Pengirim” pada tindakan Fwrd.

Bagaimana cara mengirim webhook untuk setiap SMS?

Tambahkan webhook di Fwrd, biarkan Fwrd memberi Anda pintasan siap pakai, lalu nyalakan automasinya. Berikut langkahnya:

1. Siapkan alamat webhook Anda. Alamatnya harus berupa alamat HTTPS publik. Fwrd tidak menambahkan header login, jadi jika endpoint memerlukan rahasia, buat path berupa string acak yang panjang.

2. Tambahkan webhook di Fwrd. Buka Fwrd dan ikuti penyiapannya: pilih Webhook, tempel URL endpoint, lalu pilih SMS mana yang diteruskan. Fwrd menyimpan seluruh URL di Rantai Kunci iPhone.

3. Pilih SMS yang dikirim. Di “SMS yang Diteruskan”, pilih “Hanya SMS Tertentu” untuk menyimpan SMS dengan kata tertentu, SMS yang terlihat seperti kode verifikasi, atau SMS yang masuk pada jam tertentu. Biarkan apa adanya untuk mengirim setiap SMS yang diserahkan automasi.

4. Dapatkan pintasannya. Ketuk “Dapatkan Pintasan” dan tambahkan pintasan siap pakai dari Fwrd di app Pintasan. Fwrd lalu menjalankannya sekali dengan contoh SMS, dan Pintasan meminta izin dua kali: ketuk “Izinkan”, lalu “Selalu Izinkan”.

5. Nyalakan automasinya. Di iOS 27, nyalakan automasi pintasan itu. Di iOS 26, buat automasi Pesan yang menjalankan pintasan: pilih “Pesan Berisi” dengan kata yang sama di SMS Anda, lalu “Segera Jalankan”.

6. Selesai. Setiap SMS yang cocok kini masuk ke webhook Anda dengan sendirinya, baik iPhone terkunci maupun tidak.

Lebih suka membuat pintasannya sendiri? Buat automasi Pesan yang berjalan tanpa bertanya, tambahkan “Forward Message to All Destinations” dari Fwrd tepat setelah pemicu (di pintasan, kartunya bertuliskan “Teruskan Pesan ke Semua Tujuan”), lalu atur “Pesan” ke “Input Pintasan”. Panduan automasi menguraikan langkah iOS 26 dan iOS 27 satu per satu, dan Meneruskan SMS iPhone ke webhook memuat setiap ketukan di Fwrd.

Apa yang diterima webhook?

Sebuah POST dengan Content-Type: application/json dan isi yang secara default hanya terdiri dari dua kolom. SMS yang berbunyi “Your code is 123456” tiba seperti ini:

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

Tidak ada stempel waktu atau judul, jadi tambahkan waktunya di sisi Anda bila perlu. Fwrd menganggap setiap jawaban 2xx sebagai terkirim, menolak pengalihan, dan memberi setiap permintaan 15 detik. Jika pengiriman kehabisan waktu, mendapat 429 atau 5xx, atau koneksinya terputus, Fwrd mencoba lagi hingga dua kali, dengan Idempotency-Key yang sama setiap kali.

Panduan webhook membahas sisi server, dan Zapier, Make, atau n8n memuat langkah untuk masing-masing.

Apa yang ditambahkan Fwrd untuk developer?

Hal-hal yang penting saat sebuah SMS memulai sesuatu di sisi Anda:

• Satu tindakan, tanpa perlu membangun apa pun. Tindakan Fwrd mengirim dalam format yang dibaca endpoint Anda, jadi pintasan hanya perlu menyerahkan teksnya.
• Idempotency-Key yang stabil. Pengulangan membawa kunci yang sudah Anda lihat.
• Filter di Fwrd. Setiap webhook bisa menyimpan hanya SMS dengan kata tertentu, kode verifikasi, atau SMS yang masuk pada jam tertentu.
• Riwayat di ponsel menampilkan setiap penerusan dan apakah sudah terkirim.
• Tanpa akun. Fwrd tidak punya login dan tidak punya server Fwrd; setiap SMS langsung dari iPhone Anda ke URL Anda.
• Delapan tujuan dari satu tindakan. Email, ponsel lain atau iMessage, WhatsApp, Discord, Slack, Microsoft Teams, Telegram, dan webhook Anda sendiri. Fwrd memposting sendiri ke lima yang terakhir dan menyerahkan SMS ke tindakan kirim milik Apple atau WhatsApp untuk tiga yang pertama.

Yang tidak bisa dilakukan Fwrd

• Fwrd tidak bisa menambahkan header kustom. Fwrd tidak mengirim header login, jadi endpoint harus menerima permintaan tanpa header itu, seperti webhook Zapier, Make, dan n8n. Taruh rahasia di alamatnya.
• Fwrd memerlukan alamat HTTPS publik. Fwrd menolak alamat IP dan nama yang berakhiran .local, .internal, dan sejenisnya, serta menolak pengalihan, jadi tempel alamat akhirnya. Untuk n8n, tempel URL produksi, bukan Test URL, lalu publikasikan alur kerjanya; dokumentasi node Webhook n8n menyebut saat itulah URL produksi mulai menjawab.
• Tindakan Fwrd untuk SMS masuk. Tindakan ini berjalan dari automasi Pesan dan mengirim teks yang diserahkan kepadanya. Tindakan ini tidak mengambil halaman atau memanggil layanan lain.
• SMS memerlukan ponsel yang menyala. iPhone harus menyala dan terhubung ke internet, dan hanya SMS baru yang cocok dengan automasi yang dikirim.