Perbedaan

Ini menunjukkan perbedaan antara versi yang terpilih dengan versi yang sedang aktif.

--- cuan77:c77_kode [2025/12/14 08:02] – krypton
+++ cuan77:c77_kode [2025/12/16 11:17] (sekarang) – fakhrun
@@ Baris 61: / Baris 61: @@
 **Contoh:**
 <code>
-saat_perintah /start lompat .fungsi_start
+saat_perintah /start lompat .cmd_start
 saat_perintah /menu  lompat .cmd_menu
 </code>
@@ Baris 94: / Baris 94: @@
 send_photo chat_id path desc
 </code>
+==== kirim_vidio====
+Mengirim file vidio disertai dengan teks keterangan (caption).
+  * **PENTING:** File gambar hanya dibaca dari dalam folder **bot_config**.
+  * **Argumen 1:** ''target_id''
+  * **Argumen 2:** ''path_file'' (String, lokasi file gambar relatif terhadap bot_config).
+  * **Argumen 3:** ''caption'' (String, teks keterangan).
+  * **Contoh:**
+<code>
+path = "tutorial.mp4" ; File harus ada di folder bot_config/tutorial.mp4
+desc = "Ini adalah menu kami"
+kirim_vidio chat_id path desc
+</code>
 ==== print ====
@@ Baris 139: / Baris 155: @@
 tulis_file "log.txt" data ; Akan tersimpan di bot_config/log.txt
 </code>
+==== baris_keyboard ====
+Menambahkan baris inline keyboard pada bot.
+  * **Argumen :** ''label_button'' (String).
+  * **Contoh:**
+<code>
+baris_keyboard "/halo" "/start" "/sawer" ; Ini bakal jadi baris 1
+baris_keyboard "/co gratis" "/cetak uang" ; Ini bakal jadi baris 2
+</code>
 ===== 4. Kontrol Alur (Flow Control) =====
@@ Baris 174: / Baris 202: @@
   * **Sintaks:** ''stop''
-===== 5. Variabel Sistem (Reserved Variables) =====
+===== 5. Variabel Built-in =====
 Variabel ini disediakan otomatis oleh sistem saat perintah dijalankan. Anda tidak perlu mendeklarasikannya secara manual.
@@ Baris 181: / Baris 209: @@
 | **sender_name** | String | Nama tampilan (//display name//) pengirim pesan. |
 | **chat_id** | Int/String | ID unik pengguna atau grup tempat pesan dikirim. |
+| **user_id** | Int | ID unik pengguna. |
+| **raw_text** | String | Raw text pesan yang di kirim oleh user. |
 | **agrs** | String | Argumen tambahan yang diketik user setelah perintah utama. |
@@ Baris 193: / Baris 223: @@
     msg = "Anda mengetik: " + agrs
     send chat_id msg
+    stop
+</code>
+===== 6. Contoh Best Practice (Sistem Tiket) =====
+Berikut adalah contoh implementasi kode yang bersih dan terstruktur untuk sistem "Support Ticket" sederhana. Perhatikan penggunaan komentar header, penamaan variabel yang jelas, dan pemisahan logika.
+<code>
+; ==================================================
+; APLIKASI HELPDESK MINI
+; Deskripsi: Menerima keluhan user dan menyimpannya
+; ==================================================
+; --- BAGIAN 1: KONFIGURASI HANDLER ---
+saat_perintah /tiket   lompat .handler_buat_tiket
+saat_perintah /cek_db  lompat .handler_baca_database
+saat_perintah /reset   lompat .handler_reset_data
+; --- BAGIAN 2: LOGIKA PROGRAM ---
+.handler_buat_tiket
+    ; 1. Persiapan Data
+    ; Menggabungkan nama pengirim dengan isi pesan (agrs)
+    log_entry = "Pengirim: " + sender_name
+    log_entry = log_entry + " | Keluhan: "
+    log_entry = log_entry + agrs
+    ; 2. Simpan ke File (Persistent Storage)
+    ; Data akan tersimpan di folder bot_config
+    tulis_file "database_tiket.txt" log_entry
+    ; 3. Feedback ke User
+    reply = "Halo " + sender_name
+    reply = reply + ", tiket Anda berhasil kami simpan."
+    send chat_id reply
+    ; 4. Log Internal
+    print "Tiket baru telah dibuat."
+    stop
+.handler_baca_database
+    ; Membaca seluruh isi file keluhan
+    isi_db = baca_file "bot_config/database_tiket.txt"
+    header = "=== DATA TIKET MASUK ==="
+    send chat_id header
+    send chat_id isi_db
+    stop
+.handler_reset_data
+    ; Mengosongkan file dengan menimpa string default
+    default_msg = "[DATABASE KOSONG]"
+    tulis_file "database_tiket.txt" default_msg
+    send chat_id "Database telah di-reset oleh Admin."
     stop
 </code>