GPS Tracking

Cara Event GPS Tracking Mengirim Notifikasi Email dan Webhook

5 min read
Jitra Event rule notification settings with webhook delivery available as a channel.

GPS tracking menjadi lebih berguna ketika Anda tidak harus melihat setiap Object di peta sepanjang hari. Event rule memungkinkan Jitra mengevaluasi kondisi yang ditentukan, mencatat saat kondisi tersebut terjadi, lalu memproses hasilnya melalui channel yang dikonfigurasi Organization.

Perbedaan terpentingnya sederhana: Event occurrence adalah catatan operasional. Alert di aplikasi, email, dan webhook merupakan jalur delivery yang menggunakan catatan tersebut. Kegagalan delivery tidak menghapus Event.

Alur Event dalam satu gambaran

Alur umum memiliki empat tahap:

  1. Telemetry diterima Jitra — GPS device yang kompatibel atau Jitra Tracker mengirim lokasi serta telemetry yang tersedia untuk sebuah Object.
  2. Rule aktif mengevaluasi data — Jitra memeriksa Object terpilih, trigger, duration, geofence dependency, sensor condition, schedule, dan cooldown yang berlaku.
  3. Jitra membuat Event occurrence — Ketika kondisi yang dikonfigurasi terpenuhi, occurrence disimpan pada Event History.
  4. Channel yang dikonfigurasi memproses occurrence — Notify Users, Email Notification, dan Webhook Integration berjalan secara independen sesuai konfigurasi serta entitlement.

Pemisahan ini membuat Event tetap berguna sebagai catatan walaupun tidak ada pesan eksternal yang dikirim.

Kondisi apa yang dapat memicu Event GPS tracking?

Event rule yang didukung dapat mewakili kondisi seperti:

  • Object masuk atau keluar geofence;
  • Object berhenti atau bergerak selama durasi yang dikonfigurasi;
  • kecepatan berada di atas atau di bawah batas tertentu;
  • excessive idling atau harsh-driving data ketika telemetry yang dibutuhkan tersedia;
  • GPS signal hilang atau pulih;
  • supported sensor condition sesuai nilai yang dikonfigurasi.

Pilihan yang tersedia bergantung pada Event type dan data yang diterima dari source terpilih. Source yang hanya mengirim lokasi tidak dapat menghasilkan telemetry yang tidak dikirimnya.

Untuk contoh geofence yang praktis, baca Apa Itu Geofence GPS?

Event History dan Event Notifications berbeda

Setiap occurrence yang terdeteksi disimpan pada Event History untuk user yang memiliki akses ke Object terkait. Event History adalah timeline operasional dan tidak mempunyai status read atau unread.

Event Notifications merupakan inbox personal. Isinya hanya notification yang dibuat untuk user eligible ketika Notify Users aktif dan notification preference user mengizinkan delivery. Item ini dapat ditandai sudah dibaca dan ikut menghitung badge unread.

Artinya, rule yang hanya menggunakan email atau webhook tetap dapat membuat Event occurrence tanpa menambahkan item ke notification inbox setiap user.

Cara kerja alert untuk user

Ketika Notify Users aktif, Jitra menentukan user aktif yang dapat mengakses Object lalu mengevaluasi Event alert preference masing-masing user.

Satu personal notification record dapat diterima melalui pengalaman yang didukung di Jitra Web atau Mobile. Bergantung pada permission, subscription, kondisi aplikasi, dan preference, delivery dapat berupa realtime Web alert, browser push, atau Mobile push.

Perubahan preference berlaku untuk occurrence berikutnya. Perubahan tersebut tidak menghapus Event History maupun notification yang sudah dibuat.

Cara kerja notifikasi email

Email delivery dikonfigurasi pada Event rule dan berjalan independen dari Notify Users.

Event manager dapat mengatur recipient, subject, dan body menggunakan variable Event yang didukung. Fungsi preview dan test membantu memvalidasi pesan sebelum rule digunakan pada operasi nyata. Ketika occurrence yang sesuai dibuat, Jitra merender template dan memproses email sebagai delivery attempt terpisah.

Email sesuai ketika recipient perlu menerima pesan operasional yang mudah dibaca tanpa membuka integration lain. Fitur ini bukan email campaign tool: unrestricted HTML, attachment, CC, BCC, SMS, WhatsApp, dan voice call tidak termasuk dalam scope Event delivery saat ini.

Cara kerja Event webhook

Webhook memungkinkan sistem eksternal bereaksi terhadap Event Jitra yang didukung.

Ketika rule yang dikonfigurasi terpicu, Jitra dapat mengirim HTTPS POST berisi versioned Event payload ke destination yang disetujui. Secret dapat dikonfigurasi agar sistem penerima dapat memverifikasi signature. Workflow yang didukung juga menyediakan payload example dan test delivery.

Delivery webhook berdiri terpisah dari Event occurrence dan channel lain. Jika request gagal, Jitra tetap menyimpan occurrence dan mencatat status delivery tanpa membatalkan pemrosesan email maupun user notification.

Provisioning webhook destination belum menggunakan alur yang sepenuhnya self-serve. Setup saat ini mengikuti proses yang didukung bersama administrator Organization atau support Jitra. Pelajari lebih lanjut di halaman Integrasi Jitra.

Mengapa setiap channel berjalan independen?

Situasi operasional yang berbeda membutuhkan destination yang berbeda:

  • Event History memberi authorized user catatan lengkap untuk ditinjau kembali.
  • Notify Users membuat personal notification dan mendukung delivery alert Jitra Web atau Mobile.
  • Email mengirim pesan yang mudah dibaca kepada recipient yang dikonfigurasi.
  • Webhook meneruskan structured Event data ke workflow eksternal.

Organization dapat mengaktifkan channel yang sesuai untuk setiap rule. Event webhook-only tidak harus memenuhi inbox user, sedangkan personal alert tidak membutuhkan webhook eksternal.

Contoh penggunaan

Kendaraan tiba di geofence

Kendaraan pengiriman masuk ke geofence customer. Jitra mencatat occurrence, mengirim alert kepada eligible user, mengirim email ke alamat operasional, atau meneruskan Event ke workflow eksternal sesuai konfigurasi rule.

Event menunjukkan bahwa Object masuk ke geofence. Event tersebut tidak boleh dianggap sebagai proof of delivery kecuali proses bisnis terpisah mengonfirmasi pengiriman.

Kendaraan berhenti terlalu lama

Rule mendeteksi kendaraan berhenti melampaui durasi yang dikonfigurasi. Tim operasi dapat meninjau occurrence dan konteks lokasi yang tersedia, sementara email atau webhook memicu tindak lanjut yang sesuai.

GPS signal hilang

Jitra mencatat ketika kondisi yang didukung menunjukkan GPS signal hilang. Event GPS Signal Recover berikutnya dapat membentuk occurrence terpisah. Power, connectivity, device state, dan instalasi tetap perlu diperiksa sebelum menyimpulkan penyebabnya.

Kondisi sensor

Ketika device, protocol, instalasi, dan sensor yang kompatibel menyediakan data yang dibutuhkan, rule dapat mengevaluasi sensor condition yang dikonfigurasi. Jangan menganggap setiap GPS device yang terhubung menyediakan telemetry field yang sama.

Konfigurasikan alert yang dapat ditindaklanjuti

Jumlah alert yang lebih banyak tidak otomatis menghasilkan visibility yang lebih baik. Sebelum mengaktifkan rule:

  • beri nama kondisi operasional dengan jelas;
  • pilih hanya Object yang membutuhkan rule tersebut;
  • gunakan duration, geofence dependency, dan cooldown untuk mengurangi noise;
  • pilih recipient yang dapat mengambil tindakan;
  • uji delivery email atau webhook sebelum mengandalkannya;
  • dokumentasikan respons yang harus dilakukan setelah Event;
  • tinjau false positive dan sesuaikan rule berdasarkan evidence.

Tujuannya adalah operational signal yang berguna, bukan jumlah notification sebanyak mungkin.

Ketersediaan dan kapasitas

Event occurrence history serta capability in-app atau push notification yang didukung mengikuti plan dan product access Jitra yang aktif. Channel eksternal API, Webhook, dan Email membutuhkan Jitra Pro serta Integration entitlement aktif.

Jitra Pro mencakup kapasitas integrasi awal. Delivery dengan volume lebih tinggi dapat menggunakan opsi Integration+ sesuai pricing dan entitlement catalog yang berlaku. Periksa Harga Jitra untuk detail komersial terbaru.

Pilih channel sesuai tindakan berikutnya

Gunakan personal notification Jitra ketika user perlu meninjau Event di Jitra. Gunakan email ketika human recipient membutuhkan pesan yang mudah dibaca. Gunakan webhook ketika sistem lain membutuhkan structured Event data untuk melanjutkan workflow yang didukung.

Anda dapat memulai dengan menghubungkan satu Object, membuat rule yang fokus, lalu memvalidasi Event History sebelum menambah delivery channel. Mulai gratis, pelajari Fitur Jitra, atau lihat Integrasi Jitra.

Share this article: