Custom code

Bu hujjat CustomCodeNode'da ishlatilishi mumkin bo'lgan barcha funksiyalar, o'zgaruvchilar va imkoniyatlarni tasvirlaydi.

---

Kirish

CustomCodeNode JavaScript kodini bajarish imkonini beradi. Kod Goja JavaScript engine orqali ishga tushiriladi.

// Oddiy misol
var name = message.first_name;
send_message({
    text: "Salom, " + name + "!"
});

---

Global O'zgaruvchilar

CustomCodeNode'da quyidagi global o'zgaruvchilar mavjud:

chat_id

Turi: number Joriy chat ID raqami.

console.log(chat_id); // 123456789

message

Turi: object Foydalanuvchidan kelgan xabar ma'lumotlari.

Xususiyat	Turi	Tavsif
text	string	Xabar matni
first_name	string	Foydalanuvchi ismi
last_name	string	Foydalanuvchi familiyasi
username	string	Telegram username
contact	object	Kontakt ma'lumotlari (agar yuborilgan bo'lsa)
contact.phone_number	string	Telefon raqami
contact.first_name	string	Kontakt ismi
location	object	Joylashuv ma'lumotlari (agar yuborilgan bo'lsa)
location.latitude	number	Kenglik
location.longitude	number	Uzunlik

// Xabar matni
var text = message.text;

// Foydalanuvchi ismi
var name = message.first_name;

// Kontakt (agar yuborilgan bo'lsa)
if (message.contact) {
    var phone = message.contact.phone_number;
}

// Joylashuv (agar yuborilgan bo'lsa)
if (message.location) {
    var lat = message.location.latitude;
    var lng = message.location.longitude;
}

callback_query

Turi: object Inline button bosilganda kelgan callback ma'lumotlari.

Xususiyat	Turi	Tavsif
data	string	Callback data qiymati
first_name	string	Foydalanuvchi ismi

if (callback_query) {
    var data = callback_query.data;
    console.log("Button bosildi: " + data);
}

context

Turi: object Barcha context ma'lumotlarini o'z ichiga olgan ob'ekt. message va callback_query dan tashqari barcha kalitlar.

// Context'dagi barcha state_* o'zgaruvchilarga kirish
var counter = context.state_counter;
var userName = context.state_name;

// Message ID ga kirish
var msgId = context.message_id_node_123;

---

Context Boshqarish

Context - bu foydalanuvchi sessiyasi davomida saqlanadigan ma'lumotlar.

get_context(key)

Context'dan qiymat olish.

Parametrlar:

Parametr	Turi	Tavsif
key	string	Kalit nomi

Qaytaradi: any - Topilgan qiymat yoki undefined

var name = get_context("state_name");
var count = get_context("state_count") || 0;

set_context(key, value)

Context'ga qiymat saqlash.

Parametrlar:

Parametr	Turi	Tavsif
key	string	Kalit nomi
value	any	Saqlanadigan qiymat

Qaytaradi: boolean - Muvaffaqiyat holati

set_context("state_name", "John");
set_context("state_count", 10);
set_context("state_items", ["item1", "item2"]);

has_context(key)

Context'da kalit mavjudligini tekshirish.

Parametrlar:

Parametr	Turi	Tavsif
key	string	Kalit nomi

Qaytaradi: boolean

if (has_context("state_name")) {
    var name = get_context("state_name");
}

delete_context(key)

Context'dan kalitni o'chirish.

Parametrlar:

Parametr	Turi	Tavsif
key	string	Kalit nomi

Qaytaradi: boolean

delete_context("state_temp");

clear_context()

Barcha foydalanuvchi kalitlarini tozalash. Tizim kalitlari (message, callback_query, message_id_*) o'chirilmaydi.

Qaytaradi: boolean

clear_context();

get_all_context()

Barcha context ma'lumotlarini ob'ekt sifatida olish.

Qaytaradi: object

var allData = get_all_context();
console.log(allData);

---

Telegram Bot API

send_message(options)

Matnli xabar yuborish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
text	string	✅	Xabar matni
parse_mode	string	❌	Format: "HTML", "Markdown". Default: "HTML"
disable_web_page_preview	boolean	❌	Link preview o'chirish
disable_notification	boolean	❌	Ovozni o'chirish
reply_markup	object	❌	Keyboard (pastda batafsil)

Qaytaradi: boolean - Muvaffaqiyat holati

// Oddiy xabar
send_message({ text: "Salom!" });

// Formatlangan xabar
send_message({
    text: "<b>Qalin</b> va <i>yotiq</i> matn",
    parse_mode: "HTML"
});

// Keyboard bilan
send_message({
    text: "Tanlang:",
    reply_markup: {
        type: "inline",
        buttons: [
            [{ text: "Ha", callback_data: "yes" }, { text: "Yo'q", callback_data: "no" }]
        ]
    }
});

send_photo(options)

Rasm yuborish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
photo	string	✅	Rasm URL yoki file_id
caption	string	❌	Rasm ostidagi matn
parse_mode	string	❌	Caption formati
disable_notification	boolean	❌	Ovozni o'chirish
reply_markup	object	❌	Keyboard

Qaytaradi: boolean

send_photo({
    photo: "https://example.com/image.jpg",
    caption: "Chiroyli rasm"
});

send_video(options)

Video yuborish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
video	string	✅	Video URL yoki file_id
caption	string	❌	Video ostidagi matn
parse_mode	string	❌	Caption formati
disable_notification	boolean	❌	Ovozni o'chirish
reply_markup	object	❌	Keyboard

Qaytaradi: boolean

send_video({
    video: "https://example.com/video.mp4",
    caption: "Video"
});

send_audio(options)

Audio yuborish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
audio	string	✅	Audio URL yoki file_id
caption	string	❌	Audio ostidagi matn
parse_mode	string	❌	Caption formati
disable_notification	boolean	❌	Ovozni o'chirish
reply_markup	object	❌	Keyboard

Qaytaradi: boolean

send_audio({
    audio: "https://example.com/audio.mp3",
    caption: "Qo'shiq"
});

send_document(options)

Fayl yuborish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
document	string	✅	Fayl URL yoki file_id
caption	string	❌	Fayl ostidagi matn
parse_mode	string	❌	Caption formati
disable_notification	boolean	❌	Ovozni o'chirish
reply_markup	object	❌	Keyboard

Qaytaradi: boolean

send_document({
    document: "https://example.com/file.pdf",
    caption: "PDF fayl"
});

edit_message_text(options)

Mavjud xabar matnini o'zgartirish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
text	string	✅	Yangi matn
message_id	number	❌*	Xabar ID
node_id	string	❌*	Node ID (context'dan message_id olish uchun)
parse_mode	string	❌	Format
disable_web_page_preview	boolean	❌	Link preview o'chirish
reply_markup	object	❌	Yangi keyboard

*message_id yoki node_id dan biri majburiy

Qaytaradi: boolean

// Message ID bilan
edit_message_text({
    message_id: 123,
    text: "Yangilangan matn"
});

// Node ID bilan (context'dan olinadi)
edit_message_text({
    node_id: "node_welcome",
    text: "Yangilangan matn",
    reply_markup: {
        type: "inline",
        buttons: [[{ text: "OK", callback_data: "ok" }]]
    }
});

edit_inline_button(options)

Xabar keyboard'ini o'zgartirish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
message_id	number	❌*	Xabar ID
node_id	string	❌*	Node ID
reply_markup	object	✅	Yangi keyboard

Qaytaradi: boolean

edit_inline_button({
    reply_markup: {
        type: "inline",
        buttons: [
            [{ text: "✅ Tanlandi", callback_data: "selected" }]
        ]
    }
});

delete_message(options)

Xabarni o'chirish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
message_id	number	❌*	Xabar ID
node_id	string	❌*	Node ID

Yoki to'g'ridan-to'g'ri number:

delete_message(123); // message_id

Qaytaradi: boolean

// Ob'ekt bilan
delete_message({ message_id: 123 });

// Node ID bilan
delete_message({ node_id: "node_temp_message" });

// To'g'ridan-to'g'ri ID bilan
delete_message(123);

log(message)

Serverga log yozish.

Parametrlar:

Parametr	Turi	Tavsif
message	string	Log xabari

log("Bu muhim ma'lumot");

console.log(...args)

Console'ga chiqarish (serverda saqlanadi).

console.log("Debug:", { name: "John", age: 25 });

---

HTTP So'rovlar

Tashqi API'larga so'rovlar yuborish uchun funksiyalar.

http_request(options)

Umumiy HTTP so'rov yuborish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
url	string	✅	So'rov URL
method	string	❌	HTTP metod: GET, POST, PUT, DELETE. Default: GET
headers	object	❌	HTTP sarlavhalar
body	object/string	❌	So'rov tanasi (POST/PUT uchun)
timeout	number	❌	Kutish vaqti (sekundlarda). Default: 30

Qaytaradi: object

{
    success: boolean,  // So'rov muvaffaqiyati (status 200-299)
    status: number,    // HTTP status kodi
    data: any,         // Javob ma'lumotlari (JSON yoki string)
    headers: object,   // Javob sarlavhalari
    error: string      // Xatolik xabari (agar bo'lsa)
}

var response = http_request({
    url: "https://api.example.com/data",
    method: "POST",
    headers: {
        "Authorization": "Bearer token123",
        "Content-Type": "application/json"
    },
    body: {
        name: "John",
        age: 25
    },
    timeout: 10
});

if (response.success) {
    console.log("Ma'lumotlar:", response.data);
} else {
    console.log("Xatolik:", response.error);
}

http_get(url, options?)

GET so'rov (qisqa shakl).

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
url	string	✅	So'rov URL
options	object	❌	Qo'shimcha parametrlar (headers, timeout)

Qaytaradi: object (http_request bilan bir xil)

// Oddiy GET
var response = http_get("https://api.example.com/users");

// Headers bilan
var response = http_get("https://api.example.com/users", {
    headers: { "Authorization": "Bearer token" }
});

http_post(url, body?, options?)

POST so'rov (qisqa shakl).

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
url	string	✅	So'rov URL
body	object	❌	So'rov tanasi
options	object	❌	Qo'shimcha parametrlar

Qaytaradi: object

var response = http_post("https://api.example.com/users", {
    name: "John",
    email: "[email protected]"
});

http_put(url, body?, options?)

PUT so'rov (qisqa shakl).

Parametrlar: http_post bilan bir xil

var response = http_put("https://api.example.com/users/1", {
    name: "John Updated"
});

http_delete(url, options?)

DELETE so'rov (qisqa shakl).

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
url	string	✅	So'rov URL
options	object	❌	Qo'shimcha parametrlar

Qaytaradi: object

var response = http_delete("https://api.example.com/users/1");

---

MongoDB Funksiyalari

Ma'lumotlar bazasi bilan ishlash uchun funksiyalar.

db_find_one(collection, filter?)

Bitta hujjatni topish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
collection	string	✅	Kolleksiya nomi
filter	object	❌	Qidiruv filtri

Qaytaradi: object

{
    success: boolean,
    data: object|null,  // Topilgan hujjat
    error: string       // Xatolik (agar bo'lsa)
}

// Barcha foydalanuvchilardan birinchisini olish
var result = db_find_one("users");

// ID bo'yicha qidirish
var result = db_find_one("users", { _id: "507f1f77bcf86cd799439011" });

// Maydon bo'yicha qidirish
var result = db_find_one("users", { email: "[email protected]" });

if (result.success && result.data) {
    send_message({ text: "Foydalanuvchi: " + result.data.name });
}

db_find(collection, filter?, options?)

Bir nechta hujjatlarni topish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
collection	string	✅	Kolleksiya nomi
filter	object	❌	Qidiruv filtri
options	object	❌	Qo'shimcha parametrlar

Options:

Parametr	Turi	Tavsif
limit	number	Maksimal hujjatlar soni
skip	number	O'tkazib yuborilgan hujjatlar soni (pagination)
sort	object	Saralash: { field: 1 } (o'sish) yoki { field: -1 } (kamayish)

Qaytaradi: object

{
    success: boolean,
    data: array,    // Topilgan hujjatlar ro'yxati
    error: string
}

// Barcha foydalanuvchilar
var result = db_find("users");

// Limit va skip bilan (pagination)
var result = db_find("users", {}, {
    limit: 10,
    skip: 0,
    sort: { created_at: -1 }
});

// Filtr bilan
var result = db_find("orders", { status: "pending" }, { limit: 5 });

if (result.success) {
    for (var i = 0; i < result.data.length; i++) {
        console.log(result.data[i].name);
    }
}

db_insert(collection, document)

Yangi hujjat qo'shish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
collection	string	✅	Kolleksiya nomi
document	object	✅	Saqlanadigan hujjat

Qaytaradi: object

{
    success: boolean,
    insertedId: string,  // Yangi hujjat ID'si
    error: string
}

var result = db_insert("users", {
    name: message.first_name,
    chat_id: chat_id,
    created_at: new Date().toISOString()
});

if (result.success) {
    send_message({ text: "Saqlandi! ID: " + result.insertedId });
}

db_update(collection, filter, update)

Hujjatni yangilash.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
collection	string	✅	Kolleksiya nomi
filter	object	✅	Qidiruv filtri (bo'sh bo'lishi mumkin emas!)
update	object	✅	Yangilanishlar

Update formatlari:

// Oddiy ob'ekt (avtomatik $set qo'shiladi)
{ name: "New Name" }  →  { $set: { name: "New Name" } }

// MongoDB operatorlari bilan
{ $set: { name: "New Name" }, $inc: { count: 1 } }

Qaytaradi: object

{
    success: boolean,
    modifiedCount: number,  // O'zgartirilgan hujjatlar soni
    matchedCount: number,   // Topilgan hujjatlar soni
    error: string
}

// Oddiy yangilash
var result = db_update("users", 
    { chat_id: chat_id },
    { name: "Yangi ism" }
);

// MongoDB operatorlari bilan
var result = db_update("users",
    { chat_id: chat_id },
    { 
        $set: { name: "Yangi ism" },
        $inc: { visit_count: 1 }
    }
);

if (result.success) {
    send_message({ text: "Yangilandi: " + result.modifiedCount + " ta" });
}

db_delete(collection, filter)

Hujjatni o'chirish.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
collection	string	✅	Kolleksiya nomi
filter	object	✅	Qidiruv filtri (bo'sh bo'lishi mumkin emas!)

Qaytaradi: object

{
    success: boolean,
    deletedCount: number,  // O'chirilgan hujjatlar soni
    error: string
}

var result = db_delete("temp_data", { chat_id: chat_id });

if (result.success) {
    send_message({ text: "O'chirildi: " + result.deletedCount + " ta" });
}

db_count(collection, filter?)

Hujjatlar sonini hisoblash.

Parametrlar:

Parametr	Turi	Majburiy	Tavsif
collection	string	✅	Kolleksiya nomi
filter	object	❌	Qidiruv filtri

Qaytaradi: object

{
    success: boolean,
    count: number,
    error: string
}

// Barcha hujjatlar soni
var result = db_count("users");

// Filtr bilan
var result = db_count("orders", { status: "completed" });

if (result.success) {
    send_message({ text: "Jami: " + result.count + " ta" });
}

---

Keyboard Yaratish

reply_markup parametri orqali keyboard yaratish.

Inline Keyboard

send_message({
    text: "Tanlang:",
    reply_markup: {
        type: "inline",
        buttons: [
            // Birinchi qator
            [
                { text: "Button 1", callback_data: "btn1" },
                { text: "Button 2", callback_data: "btn2" }
            ],
            // Ikkinchi qator
            [
                { text: "Link", url: "https://example.com" }
            ]
        ]
    }
});

Button turlari:

Xususiyat	Tavsif
text	Button matni
callback_data	Callback qiymati (bosilganda callback_query'ga keladi)
url	Tashqi havola

Reply Keyboard

send_message({
    text: "Tanlang:",
    reply_markup: {
        type: "reply",
        buttons: [
            [
                { text: "📱 Kontakt", request_contact: true },
                { text: "📍 Joylashuv", request_location: true }
            ],
            [
                { text: "Oddiy button" }
            ]
        ],
        resize_keyboard: true,
        one_time_keyboard: true
    }
});

Reply keyboard xususiyatlari:

Xususiyat	Turi	Tavsif
resize_keyboard	boolean	Keyboard o'lchamini moslashtirish
one_time_keyboard	boolean	Bir marta bosilgandan keyin yashirish
selective	boolean	Faqat tanlangan foydalanuvchilarga ko'rsatish

Button xususiyatlari:

Xususiyat	Turi	Tavsif
text	string	Button matni
request_contact	boolean	Kontakt so'rash
request_location	boolean	Joylashuv so'rash

---

Misollar

1

Foydalanuvchi ro'yxatdan o'tkazish

// Foydalanuvchi ma'lumotlarini saqlash
var result = db_insert("users", {
    chat_id: chat_id,
    name: message.first_name,
    username: message.username,
    registered_at: new Date().toISOString()
});

if (result.success) {
    send_message({
        text: "✅ Ro'yxatdan o'tdingiz!",
        reply_markup: {
            type: "inline",
            buttons: [
                [{ text: "🏠 Bosh menyu", callback_data: "main_menu" }]
            ]
        }
    });
}

2

API'dan ma'lumot olish

// Valyuta kursini olish
var response = http_get("https://cbu.uz/uz/arkhiv-kursov-valyut/json/");

if (response.success) {
    var usd = response.data.find(function(item) {
        return item.Ccy === "USD";
    });
    
    send_message({
        text: "💵 1 USD = " + usd.Rate + " so'm"
    });
} else {
    send_message({ text: "❌ Xatolik: " + response.error });
}

3

Hisoblagich

// Joriy qiymatni olish
var count = get_context("state_counter") || 0;

// Oshirish
count = count + 1;
set_context("state_counter", count);

// Xabar yuborish
send_message({
    text: "Siz " + count + " marta bosdingiz!",
    reply_markup: {
        type: "inline",
        buttons: [
            [{ text: "➕ Yana bosish", callback_data: "increment" }],
            [{ text: "🔄 Reset", callback_data: "reset" }]
        ]
    }
});

4

Buyurtma yaratish

// Mahsulot ma'lumotlarini olish
var product = db_find_one("products", { 
    _id: callback_query.data.split(":")[1] 
});

if (product.success && product.data) {
    // Buyurtma yaratish
    var order = db_insert("orders", {
        chat_id: chat_id,
        product_id: product.data._id,
        product_name: product.data.name,
        price: product.data.price,
        status: "pending",
        created_at: new Date().toISOString()
    });
    
    if (order.success) {
        send_message({
            text: "✅ Buyurtma yaratildi!\n\n" +
                  "📦 Mahsulot: " + product.data.name + "\n" +
                  "💰 Narx: " + product.data.price + " so'm\n" +
                  "🆔 Buyurtma: #" + order.insertedId.slice(-6)
        });
    }
}

5

Pagination bilan ro'yxat

var page = get_context("state_page") || 0;
var perPage = 5;

var result = db_find("products", {}, {
    limit: perPage,
    skip: page * perPage,
    sort: { name: 1 }
});

var total = db_count("products");

if (result.success) {
    var text = "📋 Mahsulotlar (" + (page + 1) + "-sahifa):\n\n";
    
    for (var i = 0; i < result.data.length; i++) {
        text += (i + 1) + ". " + result.data[i].name + " - " + result.data[i].price + " so'm\n";
    }
    
    var buttons = [];
    var navRow = [];
    
    if (page > 0) {
        navRow.push({ text: "⬅️ Oldingi", callback_data: "page_prev" });
    }
    if ((page + 1) * perPage < total.count) {
        navRow.push({ text: "Keyingi ➡️", callback_data: "page_next" });
    }
    
    if (navRow.length > 0) {
        buttons.push(navRow);
    }
    
    send_message({
        text: text,
        reply_markup: {
            type: "inline",
            buttons: buttons
        }
    });
}

---

Xatoliklarni Boshqarish

Barcha funksiyalar xatoliklarni qaytaradi. Har doim success maydonini tekshiring:

var result = db_find_one("users", { chat_id: chat_id });

if (!result.success) {
    log("Xatolik: " + result.error);
    send_message({ text: "❌ Xatolik yuz berdi" });
    return;
}

if (!result.data) {
    send_message({ text: "👤 Foydalanuvchi topilmadi" });
    return;
}

// Muvaffaqiyatli holat
send_message({ text: "Salom, " + result.data.name + "!" });

---

Muhim Eslatmalar

1. Xavfsizlik: db_update va db_delete bo'sh filter bilan ishlamaydi

2. Timeout: HTTP so'rovlar 30 sekunddan keyin timeout bo'ladi

3. Context: Context faqat shu foydalanuvchi sessiyasi davomida saqlanadi

4. MongoDB: _id string sifatida berilsa, avtomatik ObjectID'ga o'zgartiriladi

5. HTML: Default parse_mode "HTML" - <b>, <i>, <code> taglarini ishlatish mumkin