Integrasi Telegram digunakan untuk mengirimkan notifikasi otomatis ke akun atau grup Telegram yang sudah dikonfigurasi. Melalui integrasi ini, pengguna dapat menerima informasi penting seperti pemberitahuan tugas baru, perubahan status pekerjaan, atau update aktivitas langsung melalui Telegram, sehingga proses monitoring pekerjaan menjadi lebih cepat, praktis, dan mudah diakses kapan saja.

Langkah-langkah Integrasi Telegram

Buka Menu Telegram

1. Masuk ke Dashboard Integrations.
2. Pilih menu Telegram pada panel kiri.
3. Sistem akan menampilkan daftar Telegram Configuration yang tersedia.
4. Klik Add New Configuration untuk membuat konfigurasi baru.

Menambahkan Konfigurasi Telegram Baru

1. Setelah klik Add New Configuration pada menu Telegram, sistem akan menampilkan formulir Configuration Details. Pada bagian ini, isi beberapa field berikut:
   • Name : Masukkan nama koneksi yang ingin digunakan sesuai kebutuhan.
   • Username : Masukkan username akun Telegram yang digunakan sebagai pengirim pesan.
   • Token : Masukkan Telegram Bot Token yang diperoleh dari BotFather di Telegram. Token ini digunakan untuk menghubungkan aplikasi AlurKerja dengan bot Telegram yang sudah dibuat.
2. Klik Test Connection untuk memastikan konfigurasi terhubung ke Telegram.
3. Klik Save Configuration untuk menyimpan konfigurasi baru.

Mengubah atau Menghapus Konfigurasi Telegram

Mengubah Konfigurasi Telegram

1. Pada tabel Telegram Configurations, klik ikon pensil pada konfigurasi yang ingin diubah.
2. Sistem akan menampilkan halaman Configuration Details yang berisi nama, username, token.
3. Lakukan perubahan pada field yang diperlukan.
4. Klik Test Connection untuk memastikan koneksi valid.
5. Klik Save Configuration untuk menyimpan perubahan.

Menghapus Konfigurasi Telegram

Terdapat dua cara untuk menghapus konfigurasi:

1. Dari Daftar Konfigurasi

   
   • Pada tabel Telegram Configurations, klik ikon tempat sampah pada baris konfigurasi yang ingin dihapus.
   • Konfigurasi penghapusan.

2. Dari Halaman Detail Konfigurasi

   
   • Buka konfigurasi yang ingin dihapus.
   • Klik tombol remove di bagian kanan judul Configuration Details.
   • Konfirmasi penghapusan.

Konfigurasi Notifikasi Telegram pada BPMN

Konfigurasi Notifikasi Telegram pada BPMN digunakan untuk menghubungkan Telegram Configuration yang telah dibuat pada menu Integrations ke dalam alur proses BPMN. Dengan konfigurasi ini sistem dapat mengirimkan notifikasi Telegram secara otomatis ketika proses mencapai event, task atau sequence flow tertentu.

1. Buka BPMN Modeler pada aplikasi AlurKerja.
2. Pilih atau buka diagram proses yang akan ditambahkan notifikasi Telegram.
3. Klik elemen BPMN yang ingin diberi notifikasi, seperti Event, Task, atau Sequence Flow.
4. Pada Properties Panel, buka menu Notification Lakukan pengaturan notifikasi Telegram sesuai kebutuhan, meliputi:
   • Platform: Media notifikasi yang digunakan untuk mengirim pesan, contohnya Telegram
   • Select Telegram Configuration: Pilih konfigurasi Telegram yang telah dibuat sebelumnya.
   • Notification Type: Menentukan tujuan pengiriman notifikasi, baik ke Group maupun Account.
   • Message Type: Jenis pesan yang dikirim ke Telegram.
   • Message: Isi pesan notifikasi yang akan dikirim, dapat menggunakan template berbasis variaabel proses.
5. Simpan perubahan pada diagram BPMN
6. Deploy BPMN
7. Saat proses berjalan dan mencapai elemen yang telah dikonfigurasi, sistem akan secara otomatis mengirimkan notifikasi Telegram sesuai pengaturan.