Notifikasi

Channel

Telegram · Slack · Discord · Webhook · Email

Event

12 toggle per channel

Lingkup

Platform-wide, owner/admin

Alur

1. 01eventdeploy, backup, job, container mati, disk, sertifikat, DNS, error log, server remote, monitor HTTP
2. 02filterchannel dengan toggle event itu aktif
3. 03formatpayload per platform: HTML, attachments, embeds, JSON, email
4. 04kirimfetch dengan timeout 10 detik; gagal hanya dicatat di log

Channel yang didukung

Menambahkan channel

1. Integrasi → Notifikasi → Channel notifikasi baru (owner/admin)

   Isi Nama, pilih Tipe, isi field-nya, dan nyalakan toggle event yang diinginkan. Token/URL/ password disimpan terenkripsi dan tidak ditampilkan lagi — daftar channel hanya menunjukkan petunjuk target (mis. chat id, domain).

2. Kirim tes

   Tombol tes mengirim pesan contoh ke channel itu. Error provider ditampilkan apa adanya — mis. Telegram chat not found (bot belum di grup / chat id salah) atau SMTP 535 Authentication failed.

3. Picu event sungguhan

   Deploy sekali, atau jalankan job yang sengaja gagal (exit 1) untuk memastikan toggle bekerja.

Event

• Deploy dimulai nonaktif secara default (beda dari event lain) — deploy bisa sering terjadi (auto-update, webhook), jadi harus dinyalakan sendiri per channel yang memang ingin tahu. Juga tidak terpicu untuk deployment kind: config (ganti mode swarm/replika/limit sumber daya pada image yang sama) — itu bukan deploy baru yang perlu ditunggu.
• Tautan ke halaman aplikasi disertakan bila WEB_ORIGIN terisi.
• Kegagalan kirim ke satu channel hanya dicatat di log API dan tidak mempengaruhi channel lain maupun proses yang memicunya (deploy tidak pernah gagal karena notifikasi).
• Container mati: maksimal 1 notifikasi per container per 10 menit.
• Server remote tidak terjangkau dan Monitor HTTP gagal aktif secara default, tetapi hanya bekerja bila kamu memakai fiturnya (menambah server remote / menyalakan monitor di sebuah aplikasi), jadi tidak berisik untuk yang tidak memakainya. Keduanya memakai satu toggle untuk pesan gagal dan pesan pulih (dibedakan lewat level dan event di payload webhook: server.down/server.recovered, http.down/http.recovered).
• DNS domain bermasalah: dua kali cek gagal berturut-turut (meredam gangguan DNS sesaat) sebelum notifikasi pertama dikirim, lalu maksimal 1 kali per hari per domain selama status tetap bermasalah. Domain yang tidak bisa dibandingkan sama sekali (tidak ada IP pembanding) tidak pernah mengirim.
• Error aplikasi nonaktif secara default — deteksi dari teks log rawan salah tebak. Maksimal 1 notifikasi per aplikasi per 15 menit, kecuali muncul bentuk error yang belum pernah terlihat sejak API terakhir start, yang tetap langsung dikirim. Bisa dinonaktifkan per aplikasi lewat switch Abaikan error di log di tab Pengaturan aplikasi — lihat Aplikasi.

Payload webhook generik

Channel Webhook mengirim POST dengan Content-Type: application/json. Field umum: title, level (success / failure / info), url, lalu field khusus event:

{
  "title": "Deployment started: shop",
  "level": "info",
  "url": "https://panel.example.com/applications/…",
  "event": "deployment.started",
  "deploymentId": "…",
  "kind": "build",
  "applicationId": "…",
  "application": "shop",
  "project": "Toko",
  "trigger": "webhook",
  "commitSha": "a1b2c3d4e5f6",
  "commitMessage": "fix: checkout bug",
  "triggeredBy": "octocat"
}

{
  "title": "Deployment succeeded: shop",
  "level": "success",
  "url": "https://panel.example.com/applications/…",
  "event": "deployment.success",
  "deploymentId": "…",
  "kind": "deploy",
  "applicationId": "…",
  "application": "shop",
  "imageRef": "localhost:5000/toko/shop:a1b2c3d4e5f6",
  "error": null,
  "finishedAt": "2026-09-22T04:30:00.000Z"
}

{
  "title": "Container down: aoox-app-shop",
  "level": "failure",
  "event": "container.down",
  "container": "aoox-app-shop",
  "exitCode": 137,
  "restarting": true
}

{
  "title": "Application error detected: shop",
  "level": "failure",
  "url": "https://panel.example.com/applications/…",
  "event": "app.error",
  "applicationId": "…",
  "count": 2,
  "fingerprints": ["TypeError: Cannot read <n>", "FATAL: <n>"]
}

Contoh penerima (Node.js)

app.post("/hooks/aoox", express.json(), (req, res) => {
  const { event, level, title } = req.body
  if (event === "deployment.failure") alertOnCall(title)
  res.sendStatus(204)
})

Header & tanda tangan

const sig = req.get("X-Aoox-Signature")
const mine = "sha256=" + createHmac("sha256", SECRET).update(rawBody).digest("hex")
if (!sig || !timingSafeEqual(Buffer.from(sig), Buffer.from(mine))) return res.sendStatus(401)

Jebakan umum

Langkah berikutnya