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.

Konfigurasi Telegram mendukung dua environment, yaitu Test Environment dan Live Environment. Dengan fitur ini, pengguna dapat membuat dan menguji konfigurasi Telegram terlebih dahulu pada environment test tanpa memengaruhi konfigurasi yang digunakan oleh user di environment live.

Langkah-langkah Integrasi Telegram

Membuka Menu Telegram

1. Masuk ke halaman Studio.
2. Pilih menu Integration pada panel kiri.
3. Klik submenu Telegram.
4. Sistem akan menampilkan halaman Telegram Configurations.

Menambahkan Konfigurasi Telegram Baru

1. Pada halaman Telegram Configurations, klik tombol Add New Telegram Configuration.

   

2. Sistem akan menampilkan halaman New Telegram Configuration.

   

3. Isi field berikut:

   • Connection Name: Masukkan nama koneksi Telegram yang akan digunakan.
   • Description: Masukkan deskripsi singkat untuk menjelaskan tujuan konfigurasi Telegram. Field ini bersifat opsional.

4. Pada bagian Configuration Details, pilih environment yang ingin dikonfigurasi:

   
   • Test Environment: Digunakan untuk membuat atau menguji konfigurasi Telegram pada environment test. Konfigurasi pada environment ini tidak akan memengaruhi live users.
   • Live Environment: Digunakan untuk membuat konfigurasi Telegram yang akan digunakan pada environment live.
   • Catatan: Konfigurasi Telegram yang digunakan pada BPMN akan mengikuti environment saat BPMN dijalankan. BPMN pada Test Environment akan menggunakan konfigurasi Telegram test, sedangkan BPMN pada Live Environment akan menggunakan konfigurasi Telegram live.

5. Setelah memilih environment, isi field berikut:

   • Username: Masukkan username akun atau bot Telegram yang digunakan untuk konfigurasi.
   • Token: Masukkan Telegram Bot Token yang diperoleh dari BotFather di Telegram. Token ini digunakan untuk menghubungkan AlurKerja dengan bot Telegram yang sudah dibuat.

6. Klik tombol Test untuk memastikan konfigurasi Telegram valid.

7. Jika konfigurasi sudah sesuai, klik tombol Save Configuration untuk menyimpan konfigurasi.

Mengubah Konfigurasi Telegram

1. Pada halaman Telegram Configurations, klik ikon pensil pada konfigurasi email yang ingin diubah.

   

2. Sistem akan menampilkan halaman Edit Email Configuration.

   

3. Lakukan perubahan pada field yang diperlukan.

4. Klik tombol Test untuk memastikan koneksi masih valid.

5. Klik tombol Update Configuration untuk menyimpan perubahan.

Menghapus Konfigurasi Telegram

Konfigurasi Telegram dapat dihapus melalui dua cara:

1. Menghapus dari Daftar Konfigurasi

   
   • Pada halaman Telegram Configurations, klik ikon tempat sampah pada baris konfigurasi yang ingin dihapus.
   • Konfirmasi penghapusan untuk menghapus konfigurasi Telegram.

2. Menghapus dari Halaman Edit Konfigurasi

   
   • Buka konfigurasi Telegram yang ingin dihapus.
   • Pada halaman Edit Telegram Configuration, klik tombol Remove di bagian Configuration Details.
   • Konfirmasi penghapusan untuk menghapus konfigurasi Telegram.

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 lalu klik Deploy BPMN.

6. Pilih environment deploy sesuai kebutuhan:

8. Saat proses berjalan dan mencapai elemen yang telah dikonfigurasi, sistem akan secara otomatis mengirimkan notifikasi Telegram sesuai pengaturan.