Kirim notifikasi perubahan dari situs atau aplikasi apa pun ke satu kotak masuk bersama
Integrasi Nudge untuk Menerima Notifikasi
Nudge adalah "kotak masuk notifikasi + pusat langganan" yang terbuka. Situs Anda hanya perlu mengirim satu JSON lewat POST ke sebuah endpoint HTTP setiap kali terjadi sesuatu, lalu pengguna menerima notifikasi di kotak masuk Nudge mereka sendiri, berdampingan dengan notifikasi dari situs lain. Tidak perlu membangun antrean pesan, layanan email, atau push notification.
Integrasinya hanya tiga langkah, sekitar 10 menit, tanpa SDK, dan bisa dipakai dengan bahasa backend apa pun.
Tiga langkah
Dapatkan kredensial
Buat satu "project" untuk situs Anda dan dapatkan token khusus.
Kirim event
Saat terjadi suatu peristiwa, kirim satu JSON lewat POST ke /api/ingest.php.
Pengguna berlangganan
Tambahkan tombol deep link; setelah login, pengguna otomatis berlangganan dan melihat kartu sambutan.
Langkah 1 · Dapatkan project dan token
Setiap penerbit dipetakan ke sebuah "project" dengan slug, display_name, dan token yang unik. Kredensial untuk mengirim event hanya token itu sendiri, jadi simpan hanya di sisi server dan jangan pernah menaruhnya di kode front-end atau repositori publik.
php bin/create_project.php your-app "Your App Name"
# output: slug / name / token / ingest endpoint
Langkah 2 · Kirim event ke ingest
Ketika situs Anda mengalami perubahan yang "layak diketahui pengguna", kirim satu permintaan JSON ke endpoint ingest. Endpoint ini bersifat stateless: Nudge menangani penyimpanan, deduplikasi, pembatasan laju, dan pengiriman ke kotak masuk setiap pelanggan.
https://nudgealert.com/api/ingest.phpPOST · Content-Type: application/jsonPermintaan minimum
curl -X POST https://nudgealert.com/api/ingest.php \
-H "Content-Type: application/json" \
-d '{"token":"YOUR_TOKEN","title":"New free tier available","body":"Groq raised its free RPM to 30."}'
Permintaan dengan semua field
curl -X POST https://nudgealert.com/api/ingest.php \
-H "Content-Type: application/json" \
-d '{
"token": "YOUR_TOKEN",
"topic": "quota-change",
"title": "Groq free quota changed",
"body": "RPM 20 -> 10, effective today.",
"level": "high",
"dedup_key": "groq:rpm:20to10:2026-11-14"
}'
Field permintaan dan respons
| Field | Wajib | Keterangan |
|---|---|---|
token | Ya | Kredensial project, simpan di sisi server |
title | Tidak | Judul notifikasi; nilai bawaannya (no title) |
body | Tidak | Isi notifikasi, mendukung baris baru |
topic | Tidak | Pengelompokan topic (misalnya quota-change); nilai bawaannya default, pengguna dapat berlangganan per topic |
level | Tidak | info / warning / high / critical, nilai bawaan info |
dedup_key | Tidak | Kunci deduplikasi: nilai yang sama di dalam satu project hanya disimpan sekali dan mengembalikan duplicated |
Respons
| Event baru tersimpan | { "ok": true, "id": 12 } |
| Terdeteksi duplikat | { "ok": true, "duplicated": true } |
Kode error
400 | invalid_json | Body permintaan bukan JSON yang valid |
401 | missing_token | token tidak disediakan |
403 | invalid_token | token tidak valid |
429 | rate_limited | Melewati 60 event per menit per project |
500 | db_error | Kegagalan penulisan di sisi server |
Contoh kode
PHP
<?php
$payload = [
"token" => getenv("NUDGE_TOKEN"),
"topic" => "quota-change",
"title" => "Groq free quota changed",
"body" => "RPM 20 -> 10",
"level" => "high",
"dedup_key" => "groq:rpm:20to10:2026-11-14",
];
$ch = curl_init("https://nudgealert.com/api/ingest.php");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_RETURNTRANSFER => true,
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
// $res => ["ok" => true, "id" => 12] or ["ok" => true, "duplicated" => true]
Node.js / fetch
const res = await fetch("https://nudgealert.com/api/ingest.php", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
token: process.env.NUDGE_TOKEN,
topic: "quota-change",
title: "Groq free quota changed",
body: "RPM 20 -> 10",
level: "high",
dedup_key: "groq:rpm:20to10:2026-11-14",
}),
});
const data = await res.json();
// data => { ok: true, id: 12 } or { ok: true, duplicated: true }
Python
import os, json, urllib.request
payload = {
"token": os.environ["NUDGE_TOKEN"],
"topic": "quota-change",
"title": "Groq free quota changed",
"body": "RPM 20 -> 10",
"level": "high",
"dedup_key": "groq:rpm:20to10:2026-11-14",
}
req = urllib.request.Request(
"https://nudgealert.com/api/ingest.php",
data=json.dumps(payload).encode(),
headers={"Content-Type": "application/json"},
method="POST",
)
with urllib.request.urlopen(req) as r:
data = json.load(r) # {"ok": true, "id": 12}
Langkah 3 · Berlangganan sekali klik
Letakkan deep link di tombol "Berlangganan notifikasi". Saat pengguna membuka Nudge dan login dengan email, mereka otomatis berlangganan project terkait dan melihat kartu sambutan yang menjelaskan bahwa notifikasi selanjutnya akan masuk ke kotak masuk ini.
https://nudgealert.com/?sub=<slug>&from=<source>| Parameter | Keterangan |
|---|---|
sub | slug project Anda (wajib), menentukan project mana yang berlangganan secara otomatis |
from | Penanda sumber (opsional), dipakai untuk teks asal pada kartu sambutan; sumber yang dikenal menampilkan nama ramah dan tautan kembali |
Bisa langsung dipakai di tombol / email
<a class="btn" href="https://nudgealert.com/?sub=your-app&from=your-site"
target="_blank" rel="noopener">
Subscribe to quota alerts
</a>
Praktik terbaik
- Kirim hanya saat ada perubahan — Nudge adalah "notifikasi perubahan", bukan polling status. Kirim POST hanya ketika kuota, harga, atau status benar-benar berubah, agar tidak mengganggu.
- Manfaatkan dedup_key — Buat kunci stabil dari "objek + perubahan" (misalnya groq:rpm:20to10), supaya cron yang berjalan berulang tidak membanjiri notifikasi.
- Pilih level yang tepat — info untuk kabar biasa, warning perlu diwaspadai, high penting, critical mendesak, sehingga pengguna langsung melihat prioritasnya.
- Kelompokkan berdasarkan topic — Pisahkan jenis event ke dalam topic yang berbeda, agar pengguna bisa berlangganan hanya topik yang mereka pedulikan.
- Jaga token — Simpan token hanya di environment variable / konfigurasi server; jika bocor, segera hubungi admin untuk mereset.
- Panggil dari sisi server — Selalu kirim dari backend, jangan pernah mengekspos token ke browser atau client.
Pertanyaan umum
Apakah perlu SDK atau akun?
Tidak. Penerbit cukup membutuhkan satu token dan satu HTTP POST; pengguna cukup login ke Nudge dengan email, tanpa kata sandi.
Apakah event dikirim ke semua pengguna?
Hanya dikirim ke pengguna yang berlangganan project Anda (dan topic terkait). Orang lain tidak bisa melihatnya.
Apakah ada batas frekuensi?
Ada, maksimal 60 event per menit per project (429 rate_limited). Untuk event dalam jumlah besar, sebaiknya digabung atau dijadwalkan berlainan.
Bisakah diteruskan ke Webhook saya sendiri?
Bisa. Saat berlangganan, pengguna dapat mengisi webhook penerusan; Nudge akan mendistribusikan event ke WeCom / Slack / Telegram / endpoint kustom.
Apakah pengirimannya real-time?
Event langsung terlihat oleh pengguna setelah tersimpan (kotak masuk). Saluran seperti notifikasi browser atau email bergantung pada konfigurasi sisi pengguna dan fitur yang akan segera hadir.
Siap untuk mengintegrasikan?
Kirim informasi situs Anda kepada admin untuk mendapatkan token, salin salah satu contoh di atas, ubah dua baris, dan notifikasi pertama Anda masuk ke Nudge.
Buka kotak masuk Nudge →