BPMN Telegram Form Support

Daftar isian form yang sudah bisa diisi lewat bot Telegram, isian yang belum didukung, serta aturan pengisian dan validasinya di chat.

Bot Telegram (lihat BPMN Operate With Telegram) mengisi dua macam form langsung dari chat:

Form start process — saat pengguna memilih sebuah proses dari /mulai.
Form user task — saat pengguna memilih Kerjakan pada task dari /tugas atau /grup.

Form tidak ditampilkan sebagai satu halaman, melainkan diubah menjadi percakapan: satu pertanyaan per pesan, diakhiri ringkasan jawaban dan tombol Kirim. Karena chat tidak punya kalender, kotak centang, atau area unggah berkas, hanya sebagian komponen Form Builder yang bisa ditanyakan lewat jalur ini. Halaman ini merinci komponen mana saja.

Dukungan dinilai per form, bukan per isian. Jika ada satu komponen yang belum didukung, seluruh form ditolak sebelum pertanyaan pertama dan bot menyebutkan nama isian penyebabnya. Tidak ada isian yang dilewati diam-diam — supaya proses tidak pernah dimulai atau task tidak pernah diselesaikan dengan data yang tidak lengkap.

Isian yang Sudah Didukung

Komponen Form Builder	Cara mengisi di chat
Input (tipe Input)	Ketik teks jawabannya.
Add On	Sama seperti Input. Teks awalan/akhiran (prefix/suffix) tidak ikut ditampilkan di chat.
Input tipe Number	Ketik angka dengan format Indonesia, mis. `1.000,5`.
Input tipe Textarea	Ketik jawaban, boleh beberapa baris dalam satu pesan.
Dropdown dengan opsi statis	Pilih salah satu tombol pilihan yang muncul di bawah pesan.
Radio Button dengan opsi statis	Pilih salah satu tombol pilihan yang muncul di bawah pesan.

Komponen yang di-disable (read-only) dilewati oleh bot, sama seperti di form web — komponen tersebut tidak membuat form jadi tidak didukung.

Isian yang Belum Didukung

Komponen berikut membuat seluruh form tidak bisa diisi lewat chat. Kolom terakhir adalah alasan yang ditampilkan bot, supaya pembuat proses tahu persis isian mana yang harus diubah.

Komponen Form Builder	Alasan yang ditampilkan bot
Input tipe Email, Password, Date, Time, Date Time	`<nama field> (tipe INPUT_EMAIL)`, `(tipe INPUT_DATE)`, dan seterusnya
Switch	`<nama field> (tipe INPUT_SWITCH)`
Toggle	`<nama field> (tipe INPUT_TOOGLE)`
Checkbox	`<nama field> (tipe INPUT_CHECKBOX)`
Expression Input	`<nama field> (tipe EXPRESSION_INPUT)`
Rich Text	`<nama field> (tipe INPUT_RICH_TEXT)`
File Upload	`<nama field> (tipe INPUT_FILE_UPLOAD)`
Multiple Select (Pilihan Ganda)	`<nama field> (pilihan ganda)`
Dropdown/Radio yang opsinya diambil dari URL atau master data	`<nama field> (opsi dinamis dari API)`
Isian yang tampil/tersembunyi lewat logic/condition	`<nama field> (field bersyarat)`
Isian yang nilainya dihitung otomatis dari isian lain	`<nama field> (field terhitung)`
Isian tanpa name (nama variabel)	`<tipe field> (tanpa nama variabel)`

Bot membalas dengan daftar seluruh isian bermasalah sekaligus, bukan satu per satu:

Form ini belum bisa diisi lewat chat karena memakai isian yang belum didukung:
- tanggal_mulai (tipe INPUT_DATE)
- lampiran (tipe INPUT_FILE_UPLOAD)

Silakan buka aplikasi Alurkerja untuk mengisinya.

Elemen Tampilan (Heading, Teks, Garis, Tombol)

Pada form yang dibuat dengan Form Builder di BPMN Editor, elemen tampilan juga membuat seluruh form tidak bisa diisi lewat chat — bukan hanya komponen input. Ini termasuk Heading (Judul), paragraf, Spacer, Separator, Link, Button, serta elemen embed (HTML/iframe/micro-frontend). Pesannya berbentuk elemen H (tidak didukung), elemen LAYOUT_SEPARATOR (tidak didukung), dan seterusnya.

Yang aman: elemen layout Row, Column, dan Grid selama berisi komponen input — bot menelusuri isinya dan hanya menanyakan komponen input di dalamnya. Grid atau kolom yang kosong justru ditolak (elemen FORM2X2 (tidak didukung)), jadi hapus kolom sisa yang tidak terpakai sebelum mengandalkan proses ini lewat Telegram.

Untuk form yang berasal dari jenis lain (form-js dan Camunda embedded form), teks statis (display text) tidak menggagalkan form — teksnya ditampilkan sebagai catatan di atas pertanyaan berikutnya.

Aturan Pengisian di Chat

Wajib vs opsional. Isian wajib ditandai * dan keterangan (wajib diisi); isian opsional bisa dilewati dengan mengetik /lewati. Mencoba melewati isian wajib akan membuat bot mengulang pertanyaan yang sama.
Angka. Format Indonesia: titik untuk ribuan, koma untuk desimal (1.000,5). Format lain seperti 1000.5 ditolak dan pertanyaannya diulang, bukan ditebak. Batas min/max dari Form Builder ikut diperiksa.
Teks. Batas minLength/maxLength ikut diperiksa, dan satu jawaban maksimal 1.000 karakter.
Pilihan. Jawaban harus salah satu opsi; bot mencocokkan label lebih dulu, lalu nilainya. Mengetik teks bebas di luar daftar akan ditolak dan tombol pilihan ditampilkan lagi.
Ringkasan dan Kirim. Setelah semua pertanyaan terjawab, bot menampilkan ringkasan jawaban (isian yang dilewati ditandai (dilewati)), lalu menunggu tombol Kirim. Selama belum menekan Kirim, pengisian bisa dibatalkan kapan saja dengan /batal.
Nilai yang dikirim. Jawaban teks dikirim sebagai variabel String; angka sebagai Integer, atau Double bila ada desimal. Isian opsional yang dilewati tidak dikirim sama sekali (bukan dikirim sebagai nilai kosong).
Form tanpa isian. Proses yang start form-nya kosong tetap bisa dijalankan: bot langsung menampilkan konfirmasi Kirim tanpa pertanyaan.

Pesan Lain yang Mungkin Muncul

Pesan bot	Artinya
"Form ini belum bisa diisi lewat chat karena jenisnya belum didukung."	Jenis form-nya di luar yang dikenali bot (Form Builder, form-js, Camunda embedded form).
"Form ini tidak bisa dibaca karena responsnya tidak dikenali."	Form gagal dibaca dari sisi Alurkerja — laporkan ke admin, bukan masalah desain form.
Daftar isian tidak didukung, lalu "Pilih nomor lain dari daftar, atau /batal."	Terjadi pada `/mulai`: daftar proses tetap terbuka sehingga proses lain masih bisa dipilih.

Rekomendasi untuk Pembuat Proses

Jika sebuah proses memang ingin dioperasikan lewat Telegram:

Pakai hanya Input (Input/Number/Textarea), Add On, Dropdown statis, dan Radio Button statis pada form start process dan form user task-nya.
Hindari elemen tampilan (Heading, Separator, Spacer, Link, Button) di form tersebut — pindahkan penjelasan ke label isian atau ke deskripsi proses.
Hapus kolom/grid kosong yang tersisa dari penataan layout.
Uji langsung dari chat setelah men-deploy dan mengaktifkan opt-in-nya di tab Operate With Telegram — bot menolak form di awal percakapan, jadi ketidakcocokan langsung terlihat pada percobaan pertama.

Form yang memakai tanggal, unggah berkas, pilihan ganda, atau opsi dinamis tetap bisa dikerjakan seperti biasa lewat aplikasi Alurkerja; yang tidak tersedia hanya jalur pengisiannya lewat chat.