Daftar Isi
Echobell Direct adalah mode peringatan pribadi yang sepenuhnya melewati penyiapan saluran. Anda membuat sebuah Direct Key, mendapatkan URL webhook, lalu mengirim POST berisi title + body untuk menerima notifikasi instan di perangkat Anda. Tanpa pelanggan, tanpa templat, tanpa konfigurasi perutean.
Panduan ini membahas apa itu Direct, cara menyiapkannya, dan kapan memakainya alih-alih Saluran.
Apa itu Echobell Direct?
Setiap Direct Key menghasilkan URL webhook yang unik (/d/{token}). Kirim permintaan ke URL itu dan notifikasinya langsung tiba di perangkat Anda.
Pakai Direct saat Anda butuh:
- Notifikasi pribadi dari skrip, cron job, atau pipeline CI
- Judul dan isi yang berbeda-beda per permintaan alih-alih templat tetap
- Penyiapan cepat tanpa mengonfigurasi saluran penuh
Jika Anda butuh notifikasi bersama, templat yang bisa dipakai ulang, atau pengiriman bersyarat, gunakan Saluran lewat Webhook sebagai gantinya.
Penyiapan dalam 3 langkah
Langkah 1: Buat sebuah Direct Key
Buka Echobell, ketuk Direct di daftar saluran Anda, lalu buat sebuah kunci. Beri nama sesuai layanan yang memakainya (misalnya CI Server, Cron, AI Tasks).
Langkah 2: Salin URL webhook Anda
Setiap kunci punya URL dengan format:
https://hook.echobell.one/d/YOUR_KEY_TOKENPerlakukan URL ini sebagai rahasia — siapa pun yang memilikinya bisa mengirimi Anda notifikasi.
Langkah 3: Kirim notifikasi pertama Anda
curl -X POST https://hook.echobell.one/d/YOUR_KEY_TOKEN \
-H "Content-Type: application/json" \
-d '{
"title": "Deploy failed",
"body": "api-service failed health check",
"notificationType": "time-sensitive",
"externalLink": "https://dashboard.example.com/deploys/123"
}'Rujukan kolom lengkap: Direct API
Tingkat urgensi
Direct mendukung notificationType sehingga Anda bisa menyelaraskan urgensi dengan kejadiannya:
active— pembaruan biasatime-sensitive— peringatan penting yang menembus mode Fokuscalling— insiden kritis (butuh langganan premium aktif; jika tidak, turun menjadi time-sensitive)
Lihat Jenis Notifikasi untuk detail perilakunya secara lengkap.
Menambahkan konteks ke peringatan
Sertakan externalLink di body permintaan untuk melampirkan sebuah URL ke notifikasi — berguna untuk menautkan langsung ke log deploy, dashboard, atau pull request.
Untuk agen AI dan tugas asinkron berdurasi panjang, Direct adalah cara sederhana untuk mendapat kabar saat pekerjaannya selesai alih-alih memeriksanya manual berulang kali. Lihat juga: WebhookMCP + Echobell.
Direct vs Saluran
| Direct | Saluran | |
|---|---|---|
| Audiens | Hanya pribadi | Dibagikan ke rekan tim |
| Templat | Isi per permintaan | Templat tetap yang bisa dipakai ulang |
| Waktu penyiapan | Kurang dari satu menit | Perlu konfigurasi saluran |
| Kondisi | Tidak didukung | Didukung |
Gunakan Saluran saat peringatan perlu menjangkau banyak orang atau ketika Anda ingin format yang konsisten untuk satu layanan. Dokumentasi templat · Apa itu Echobell
Praktik keamanan
- Simpan token Direct di variabel lingkungan atau pengelola rahasia, bukan di dalam kode
- Buat satu kunci per layanan agar bisa dicabut satu per satu
- Rotasi token segera jika sebuah URL berpotensi bocor
- Simpan
callinguntuk insiden yang sesungguhnya — pemakaian berlebihan memicu kelelahan peringatan
FAQ
Apakah Direct hanya untuk pengembang? Tidak. Siapa pun yang punya alat yang bisa mengirim permintaan HTTP dapat memakainya.
Apakah Direct mendukung permintaan GET? Ya, tetapi POST dengan JSON lebih disarankan.
Apa yang terjadi kalau langganan saya habis dan saya memakai calling? Ia otomatis turun menjadi time-sensitive.
Mulailah dari panduan Direct. Ketika alur kerja Anda tumbuh dan butuh kolaborasi atau templat, Saluran adalah langkah lanjutan yang mudah.
Terkait
- Dokumentasi Direct API — rujukan kolom lengkap dan contohnya
- WebhookMCP + Echobell — notifikasi selesainya tugas AI memakai Direct
- Cara menembus Mode Fokus iOS — memilih tingkat urgensi notifikasi yang tepat
- Notifikasi webhook Zapier — alur otomatisasi untuk non-pengembang
- Jenis notifikasi — perilaku Standar, Peka Waktu, dan Panggilan