Integrasi Lynk.id ร StarSender #
Kirim notifikasi WhatsApp otomatis setiap kali ada order masuk di Lynk.id.
โฑ๏ธ Setup 5 menit ยท ๐ Instant delivery ยท ๐ก๏ธ Signature verified
๐ Daftar Isi #
1. Apa itu Integrasi Lynk.id? #
Lynk.id adalah platform link-in-bio dan e-commerce populer di Indonesia yang memungkinkan Anda menjual produk digital/fisik lewat link tunggal (seperti Linktree + Tokopedia digabung).
Dengan integrasi Lynk.id ร StarSender, setiap kali ada order masuk di Lynk.id, sistem akan otomatis kirim pesan WhatsApp:
- Ke customer โ notifikasi order dengan detail pembelian
- Ke admin/owner โ notifikasi order baru untuk siap proses
Customer beli ebook Rp 99.000 via link Lynk.id Anda โ otomatis dalam 2-5 detik kemudian:
- Customer dapat WA: “Terima kasih {nama}! Order #123 untuk Ebook sudah diterima…”
- Admin dapat WA: “๐ฆ Order baru! {nama} beli Ebook Rp 99.000…”
2. Manfaat Integrasi #
Instant Delivery #
Pesan sampai ke customer dalam 2-5 detik setelah order. Tidak perlu tunggu cron.
Template Fleksibel #
Custom pesan dengan 12+ variable: nama, produk, harga, ref ID, voucher, dll.
3. Cara Kerja Sistem #
โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ CUSTOMER โ โ LYNK.ID โ โ STARSENDER โ
โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ โโโโโโโโโโฌโโโโโโโโโ
โ โ โ
โ 1. Beli produk โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโถโ โ
โ โ โ
โ โ 2. Order paid โ
โ โ โ
โ โ 3. POST webhook โ
โ โ + signature SHA-256 โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโถโ
โ โ โ
โ โ โ 4. Verify
โ โ โ signature
โ โ โ
โ โ โ 5. Render template
โ โ โ (replace {nama},
โ โ โ {produk}, dll)
โ โ โ
โ โ โ 6. Create Outgoing
โ โ โ + RabbitMQ
โ โ โ
โ 7. Notifikasi WA โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ โ
โ โ 8. Kirim ke admin
โ โ
โโโโโโโโโโโโโโ โ
โ ADMIN โโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโ
Waktu total dari order โ WA sampai: biasanya 2-5 detik (tergantung kecepatan internet device WhatsApp).
4. Persiapan Sebelum Setup #
Sebelum mulai, pastikan Anda sudah punya:
โ Checklist Persiapan #
| 1. Akun StarSender aktif dengan paket add-on Integrasi Lynk.id | Cek di sidebar โ menu Integrasi Lynk.id harus ada |
| 2. Device WhatsApp connected di StarSender | Minimal 1 device dengan status hijau (connected) |
| 3. Akun Lynk.id aktif dengan minimal 1 produk live | Sudah bisa menerima order |
| 4. Akses ke Dashboard Lynk.id | Bisa buka menu Webhook/Integration di setting Lynk |
| 5. Merchant Key dari Lynk.id | Didapat dari dashboard Lynk (langkah di bawah) |
Upgrade paket via menu Billing. Hubungi tim support untuk pilihan paket yang include Integrasi Lynk.id.
5. Setup di StarSender (Sisi Penerima Webhook) #
Di sini kita akan create integrasi baru dan dapat Webhook URL yang nanti di-paste ke Lynk.id.
Buka Menu Integrasi Lynk.id #
- Login ke app.starsender.online
- Di sidebar kiri, cari menu Integrasi Lynk.id (ikon lightning/flash)
- Klik menu tersebut โ halaman list integrasi muncul
Klik “Tambah Integrasi” #
Klik tombol biru Tambah Integrasi di kanan atas. Form Create akan muncul.
Isi Form Integrasi #
Isi semua field berikut:
| Field | Wajib? | Contoh / Penjelasan |
|---|---|---|
| Nama | โ Wajib | Toko Utama atau Produk Digital 2026. Nama internal saja. |
| Device Pengirim | โ Wajib | Pilih device yang akan kirim notifikasi. Harus status connected. |
| Merchant Key | โ Wajib | Copy dari Lynk.id (langkah selanjutnya di section 6). Untuk verify signature. |
| Nomor Admin | Opsional | Nomor WA admin (bisa multi, pisah koma): 628123456789,62811223344. Kosongkan jika tidak mau notifikasi admin. |
| Template Customer | Opsional | Pesan yang dikirim ke customer. Kosongkan jika tidak mau kirim ke customer. |
| Template Admin | Opsional | Pesan yang dikirim ke admin. Kosongkan jika tidak perlu. |
| Status Aktif | Default: Aktif | Toggle untuk pause/resume integrasi tanpa hapus. |
Save & Copy Webhook URL #
Setelah klik Simpan, StarSender akan generate Webhook Token unik dan tampilkan Webhook URL.
Contoh Webhook URL yang di-generate:
Copy URL ini dan simpan. URL ini yang akan di-paste di dashboard Lynk.id. URL ini bersifat rahasia โ jangan di-share ke pihak lain.
Ada tombol Copy di samping URL untuk memudahkan.
6. Setup di Lynk.id (Sisi Pengirim Webhook) #
Sekarang ke dashboard Lynk.id untuk daftarkan Webhook URL dan ambil Merchant Key.
Login ke Lynk.id Dashboard #
- Buka lynk.id
- Login dengan akun Anda
- Klik menu Settings atau Integrasi di dashboard
Cari Menu Webhook / Integration #
Di dashboard Lynk.id, cari menu untuk Webhook Integration. Lokasinya biasanya:
- Settings โ Integrations โ Webhooks, atau
- Account โ Developer โ Webhooks, atau
- Dashboard โ Webhook Settings
Dapatkan Merchant Key #
Di dashboard Lynk.id, Anda akan menemukan Merchant Key atau Secret Key. Biasanya tampil dalam bentuk:
Copy key ini, lalu kembali ke StarSender โ edit integrasi yang tadi dibuat โ paste di field Merchant Key โ Save.
Daftarkan Webhook URL di Lynk.id #
Di menu Webhook Lynk.id:
- Klik Add Webhook / New Webhook
- URL: paste Webhook URL dari StarSender (yang tadi kita copy)
- Event: pilih event yang di-trigger โ biasanya
order.paidatauorder.completed - Method:
POST(default) - Klik Save
7. Template Pesan & Variable #
StarSender support variable template untuk personalisasi pesan. Variable otomatis di-replace dengan data dari webhook Lynk.
๐ Daftar Variable yang Tersedia #
| Variable | Data | Contoh Hasil |
|---|---|---|
{name} |
Nama customer | Budi Santoso |
{email} |
Email customer | budi@example.com |
{phone} |
Nomor WA customer | 628123456789 |
{product_title} |
Nama produk (item pertama) | Ebook Marketing 2026 |
{qty} |
Jumlah (item pertama) | 2 |
{price} |
Harga per item (item pertama) | 99.000 |
{all_items} |
Semua item dalam format list bullet | โข Ebook Marketing (x2) – Rp 198.000 โข Template CV (x1) – Rp 50.000 |
{total_price} |
Total harga sebelum diskon | 248.000 |
{grand_total} |
Total final (setelah diskon) | 228.000 |
{ref_id} |
ID referensi order dari Lynk | LYNK-20260424-ABC123 |
{voucher_code} |
Kode voucher yang dipakai (kalau ada) | DISKON20 |
{created_at} |
Tanggal & waktu order | 2026-04-24 14:30:00 |
๐จ Format Pesan WhatsApp #
Support markdown WhatsApp:
*tebal*โ tebal_miring_โ miring~coret~โcoretโ monospacemonospace
8. Contoh Template Siap Pakai #
๐จ Template Customer โ Notifikasi Sukses Order #
Hasil yang diterima customer:
๐จ Template Admin โ Notifikasi Order Baru #
๐จ Template Customer โ Produk Digital (Kirim Langsung) #
๐จ Template Minimalis โ Untuk Admin (Singkat) #
9. Test Integrasi End-to-End #
Setelah setup selesai, lakukan test untuk memastikan integrasi jalan dengan benar.
๐งช Skenario Test 1: Test Webhook dari Lynk.id #
Kalau Lynk.id punya tombol “Test Webhook” di dashboard:
- Klik tombol tersebut
- Lynk akan kirim sample payload ke URL StarSender
- Cek di StarSender โ menu Integrasi Lynk.id โ lihat kolom Total Hits harus naik +1
- Kalau template customer terisi, nomor test akan dapat WA
๐งช Skenario Test 2: Order Beneran (Recommended) #
- Minta teman/nomor kedua Anda beli produk di Lynk.id Anda (pakai kupon diskon 100% atau produk gratis untuk test)
- Pilih metode bayar โ bayar
- Tunggu 2-5 detik setelah “paid”
- Customer (nomor teman Anda) akan dapat WA notifikasi order
- Admin (nomor Anda) akan dapat WA notifikasi order baru
๐งช Skenario Test 3: Manual via cURL (Advanced) #
Untuk developer yang mau test manual:
10. Monitoring & Log #
Di halaman Integrasi Lynk.id, Anda bisa monitor performa integrasi per item.
๐ Info yang Ditampilkan Per Integrasi #
| Info | Arti |
|---|---|
| Nama | Nama integrasi yang Anda buat |
| Device | Device WA yang dipakai untuk kirim |
| Total Hits | Total webhook yang berhasil diterima |
| Last Hit At | Waktu terakhir webhook diterima |
| Last Error | Error message terakhir (kalau ada) |
| Status | Aktif / Nonaktif |
๐ Cek Log Pengiriman WA #
Untuk cek pesan yang sudah dikirim ke customer/admin:
- Buka menu Outgoing di sidebar
- Filter by Source:
lynk-integration - Anda akan lihat semua pesan yang dikirim via integrasi ini
- Klik pesan untuk lihat detail: status (sent/failed), waktu, isi pesan
11. Troubleshooting #
โ Order masuk di Lynk, tapi WA tidak kirim #
Kemungkinan penyebab & solusi:
- Integrasi nonaktif โ Cek status di StarSender, aktifkan
- Device disconnect โ Reconnect device
- Webhook URL salah di Lynk.id โ Compare URL, harus persis sama
- Merchant Key tidak match โ Signature invalid, pesan tidak kirim. Re-copy Merchant Key dari Lynk.id
- Template kosong โ Kalau template_customer kosong, customer tidak dapat pesan (behavior sengaja)
- Event belum dipilih di Lynk โ Pastikan event
order.paidatauorder.completeddipilih
โ Total Hits tidak naik meskipun ada order #
Artinya: Webhook Lynk tidak sampai ke StarSender.
Solusi:
- Cek Webhook URL di Lynk โ harus identik dengan yang StarSender generate
- Cek apakah Lynk.id subscription plan-nya support webhook (beberapa plan basic tidak support)
- Coba tombol “Test Webhook” di Lynk.id
- Cek firewall/antivirus yang mungkin block koneksi Lynk โ StarSender
โ Last Error: “signature mismatch” #
Artinya: Merchant Key yang Anda paste di StarSender TIDAK SAMA dengan yang Lynk.id pakai untuk signing webhook.
Solusi:
- Login ke Lynk.id dashboard
- Buka Settings โ Webhook / Developer
- Copy Merchant Key / Secret Key yang LIVE (bukan sandbox)
- Edit integrasi di StarSender โ paste ulang โ Save
- Test webhook lagi
โ Pesan terkirim ke admin tapi tidak ke customer #
Kemungkinan penyebab:
- Template Customer kosong โ isi template customer
- Nomor customer di order Lynk tidak valid / kosong โ cek data order di Lynk
- Nomor customer diblokir oleh device pengirim
โ Variable {name} muncul apa adanya di pesan #
Penyebab: Data customer di webhook Lynk tidak lengkap.
Solusi:
- Pastikan form checkout Lynk require field Nama (tidak optional)
- Kalau optional, siapkan fallback text di template: gunakan “Halo Kak!” sebagai alternatif
โ Pesan delay 5-15 menit baru sampai #
Penyebab:
- Device offline saat webhook masuk โ pesan masuk queue “menunggu device terkoneksi”
- RabbitMQ queue padat (banyak blast bersamaan)
- Device lambat response
Solusi: Pastikan device selalu online. Kalau sering offline, tambah backup device.
12. Keamanan: Signature Verification #
StarSender menggunakan SHA-256 HMAC signature untuk memastikan webhook yang diterima benar-benar dari Lynk.id, bukan dari pihak ketiga yang ingin menyalahgunakan.
๐ Cara Kerja Signature #
1. Lynk.id kirim webhook dengan header "X-Signature" Signature = SHA256(amount + ref_id + message_id + merchant_key) 2. StarSender terima webhook, lalu hitung signature sendiri: expected_signature = SHA256(amount_from_payload + ref_id + message_id + YOUR_merchant_key) 3. Compare: - Kalau SAMA โ webhook valid, lanjut proses - Kalau BEDA โ webhook di-reject, log "signature mismatch"
๐ก๏ธ Keamanan Tambahan #
- Webhook Token unik per integrasi โ tidak bisa di-share
- Scoped by user โ 1 webhook token hanya bisa trigger untuk 1 akun StarSender
- Rate limiting โ max 100 hits/menit per integrasi untuk prevent abuse
- HTTPS only โ semua traffic encrypted via TLS
- Webhook URL Anda (mengandung token rahasia)
- Merchant Key dari Lynk.id
- API Token StarSender
13. FAQ Lengkap #
1. Berapa lama setup total?
Jika semua sudah disiapkan (paket aktif, device connected, akun Lynk), setup 5-10 menit. Testing tambah 5 menit. Total max 15 menit.
2. Bisa buat banyak integrasi untuk 1 akun?
Bisa. Misal Anda punya 3 akun Lynk.id untuk 3 bisnis berbeda, bisa buat 3 integrasi terpisah dengan nama, device, dan template masing-masing.
3. Pesan WA kena kuota blast saya?
Ya, setiap pesan yang dikirim via integrasi Lynk menghitung 1 pesan di kuota paket Anda (sama seperti Blast, Follow Up, Campaign).
4. Bagaimana kalau kuota habis?
Pesan akan gagal kirim dengan error “quota exceeded”. Webhook tetap diterima (Total Hits naik), tapi pesan WA tidak kirim. Top-up kuota di menu Billing.
5. Bisa kirim ke grup WA?
Untuk saat ini hanya support kirim ke nomor personal (customer + admin). Kirim ke grup akan tambahan fitur berikutnya.
6. Apakah refund/cancel order memicu pesan lagi?
Tergantung setting di Lynk.id. Kalau event order.refunded di-register ke webhook, StarSender akan kirim pesan sesuai template (Anda bisa bikin integrasi terpisah untuk event refund).
7. Bisa kirim attachment (PDF/file) via Lynk integration?
Saat ini pesan hanya text. Untuk kirim file, sertakan link download di template (pakai Google Drive / Dropbox link). Fitur attachment langsung akan di-release nanti.
8. Bisa delay pengiriman pesan?
Untuk Lynk integration, pesan dikirim INSTANT (target 2-5 detik). Tidak bisa di-delay. Kalau butuh pesan bertahap, pakai fitur Follow Up Otomatis dan trigger via tag/group setelah order.
9. Apakah customer bisa opt-out dari notifikasi?
Tidak otomatis. Kalau customer reply “STOP”, Anda harus manual block nomor tersebut di menu Outgoing / Kontak. Sistem tidak auto-detect STOP keyword untuk fitur Lynk.
10. Bisa trigger Follow Up Otomatis setelah order Lynk?
Bisa! Tambahkan integrasi webhook kedua di Lynk yang pakai API lain untuk add kontak ke group dengan tag tertentu. Kemudian Follow Up Otomatis akan auto-trigger berdasarkan tag tsb.
11. Maximal order per menit yang bisa di-handle?
Max ~100 webhook per menit per integrasi. Lebih dari itu akan rate-limit. Untuk toko dengan traffic tinggi, split ke beberapa integrasi + multi device.
12. Apakah bisa test dengan webhook fake (tanpa Lynk beneran)?
Bisa, tapi Anda harus generate signature SHA-256 yang valid manual. Lihat section 9 (Test) untuk command cURL.
13. Bisa customize tampilan WA (emoji, warna, link preview)?
Emoji bisa ditambahkan langsung di template (copy-paste dari keyboard emoji). Link URL akan otomatis jadi preview di WA. Warna tidak bisa (batasan WA).
14. Apakah data customer Lynk disimpan di StarSender?
Tidak permanen. Data customer (nama, email, phone) hanya diambil saat webhook diterima untuk render template, lalu pesan disimpan di Outgoing log. Data tidak dipakai ulang.
15. Bagaimana kalau Lynk.id update API/payload structure?
Tim StarSender akan monitor dan update integrasi kalau ada perubahan. Kalau tiba-tiba integrasi stop jalan, hubungi support.
๐ Siap Integrasikan Lynk.id Anda? #
Setup 5 menit, customer happy seumur hidup. Tidak perlu chat manual lagi.
Mulai Setup Sekarang โ๐ Tutorial Terkait #
- Tutorial Lengkap Follow Up Otomatis โ kirim pesan bertahap otomatis
- Autoreply WhatsApp โ balas pesan otomatis berdasarkan keyword
- Blast Broadcast โ kirim pesan massal sekaligus
๐ Tutorial ini di-update sesuai perkembangan fitur StarSender & API Lynk.id.
โ Ada pertanyaan yang belum terjawab? Hubungi tim support di menu Bantuan atau WhatsApp support.
ยฉ StarSender โ WhatsApp Gateway Profesional Indonesia