Nudge
Didukung Nudge · pusat notifikasi terbuka
← Kembali ke kotak masuk

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

1

Dapatkan kredensial

Buat satu "project" untuk situs Anda dan dapatkan token khusus.

2

Kirim event

Saat terjadi suatu peristiwa, kirim satu JSON lewat POST ke /api/ingest.php.

3

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.

Saat ini aksesnya berdasarkan undangan: kirim nama situs, slug (misalnya your-app), dan deskripsi singkat kepada admin Nudge untuk mendapatkan token. Jika Anda meng-host Nudge sendiri, gunakan CLI yang sudah ada di dalam project:
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.

Endpoint pengirimanhttps://nudgealert.com/api/ingest.php
Metode / Content-TypePOST  ·  Content-Type: application/json

Permintaan 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

FieldWajibKeterangan
tokenYaKredensial project, simpan di sisi server
titleTidakJudul notifikasi; nilai bawaannya (no title)
bodyTidakIsi notifikasi, mendukung baris baru
topicTidakPengelompokan topic (misalnya quota-change); nilai bawaannya default, pengguna dapat berlangganan per topic
levelTidakinfo / warning / high / critical, nilai bawaan info
dedup_keyTidakKunci 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

400invalid_jsonBody permintaan bukan JSON yang valid
401missing_tokentoken tidak disediakan
403invalid_tokentoken tidak valid
429rate_limitedMelewati 60 event per menit per project
500db_errorKegagalan penulisan di sisi server

Contoh kode

Ganti YOUR_TOKEN dengan token project Anda. Semua contoh hanya boleh dijalankan di sisi server.

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.

Format deep linkhttps://nudgealert.com/?sub=<slug>&from=<source>
ParameterKeterangan
subslug project Anda (wajib), menentukan project mana yang berlangganan secara otomatis
fromPenanda 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>
Ganti your-app dengan slug Anda dan your-site dengan penanda sumber Anda.

Praktik terbaik

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 →