Integrations

WhatsApp Integrations

Integrasi ke WhatsApp

Integrasi WhatsApp digunakan untuk mengirimkan notifikasi otomatis ke nomor atau grup WhatsApp yang sudah dikonfigurasi. Melalui integrasi ini, pengguna dapat menerima informasi penting seperti pemberitahuan tugas baru, perubahan status pekerjaan, atau update aktivitas langsung melalui WhatsApp.

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

Langkah-langkah Integrasi WhatsApp

Membuka Menu WhatsApp

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

Menambahkan Konfigurasi WhatsApp Baru

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

    Tambahkan Konfigurasi WhatsApp
  2. Sistem akan menampilkan halaman New WhatsApp Configuration.

    Halaman Konfigurasi WhatsApp Baru
  3. Isi field berikut:

    • WhatsApp Name: Masukkan nama konfigurasi WhatsApp yang akan digunakan.
    • Description: Masukkan deskripsi singkat untuk menjelaskan tujuan konfigurasi WhatsApp. Field ini bersifat opsional.
  4. Pada bagian Configuration Details, pilih environment yang ingin dikonfigurasi:

    Opsi Environment Configuration
    • Test Environment: Digunakan untuk membuat atau menguji konfigurasi WhatsApp pada environment test. Konfigurasi pada environment ini tidak akan memengaruhi live users.
    • Live Environment: Digunakan untuk membuat konfigurasi WhatsApp yang akan digunakan pada environment live.
    • Catatan: Konfigurasi WhatsApp yang digunakan pada BPMN akan mengikuti environment saat BPMN dijalankan. BPMN pada Test Environment akan menggunakan konfigurasi WhatsApp test, sedangkan BPMN pada Live Environment akan menggunakan konfigurasi WhatsApp live.
  5. Setelah memilih environment, isi detail konfigurasi API berikut:

    • Type: Pilih jenis koneksi WhatsApp yang akan digunakan.
    • API Key: Masukkan WhatsApp API Key yang digunakan untuk autentikasi koneksi WhatsApp.
    • Number Key: Masukkan Number Key yang sesuai dengan nomor WhatsApp yang akan digunakan.
  6. Klik tombol Test untuk memastikan koneksi WhatsApp valid.

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

Mengubah Konfigurasi WhatsApp

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

    Tombol Edit Konfigurasi WhatsApp
  2. Sistem akan menampilkan halaman Edit WhatsApp Configuration.

    Halaman Edit Konfigurasi WhatsApp
  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 WhatsApp

Konfigurasi WhatsApp dapat dihapus melalui dua cara:

  1. Menghapus dari Daftar Konfigurasi

    Tombol Delete Konfigurasi WhatsApp
    • Pada halaman WhatsApp Configurations, klik ikon tempat sampah pada baris konfigurasi yang ingin dihapus.
    • Konfirmasi penghapusan untuk menghapus konfigurasi WhatsApp.
  2. Menghapus dari Halaman Edit Konfigurasi

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

Konfigurasi WhatsApp pada BPMN

Konfigurasi WhatsApp pada BPMN digunakan untuk menghubungkan WhatsApp Configuration yang sudah dibuat pada menu Integrations ke dalam alur proses BPMN. Dengan konfigurasi ini, sistem dapat mengirim pesan WhatsApp secara otomatis melalui Send Task sesuai konfigurasi WhatsApp yang dipilih.

  1. Buka BPMN Editor pada AlurKerja.

  2. Tambahkan elemen Send Task pada diagram proses.

    Konfigurasi WhatsApp Service Task,
  3. Klik Send Task yang akan dikonfigurasi.

  4. Di panel Properties, klik tab Notifications

    Konfigurasi API Request OnPremise,
  5. Konfigurasi WhatsApp yang akan dikirim:

    Konfigurasi API Request OnPremise,
    • Platform : Digunakan untuk menentukan media notifikasi yang digunakan.
    • Select WhatsApp Configuration : Digunakan untuk memilih konfigurasi WhatsApp yang telah dibuat sebelumnya pada menu Integrations.
    • Send Using : Menentukan metode pengiriman pesan.
    • Phone Number : Nomor WhatsApp penerima pesan.
    • Message Type : Menentukan jenis pesan yang akan dikirim.
    • Message : Isi pesan WhatsApp yang akan dikirim
  6. Setelah selesai, klik Save dan Deploy BPMN.

  7. Pilih environment deploy sesuai kebutuhan:

Opsi Environment Deploy,