Telegram

Umumiy ma'lumot

Bronjoy Telegram bilan uch xil usulda integratsiyalashadi:

1. Mijoz Mini App'i — mijozlar Telegram Mini App orqali qabulga yoziladi
2. Xodimlarga bildirishnomalar — xodimlar amal tugmalari bilan yozilish bildirishnomalarini oladi
3. Maxsus botlar — tashkilotlar white-label tajriba uchun o'z Telegram botini ulashi mumkin

Mijozning Telegram jarayoni

Mijozlar Telegram Mini App orqali autentifikatsiyadan o'tishi va Bronjoy bilan ishlashi mumkin.

Autentifikatsiya

POST /api/client/auth/telegram
Content-Type: application/json

{
  "init_data": "query_id=...&user=...&auth_date=...&hash=..."
}

init_data Telegram Mini App API dan keladi. Bronjoy HMAC-SHA256 imzosini tekshiradi va mijoz hisobini yaratadi yoki bog'laydi.

Inline tugmalar orqali qabul amallari

Mijoz Telegram'da yozilish tasdiqlanishini olganda, inline tugmalar to'g'ridan-to'g'ri amallarni bajarish imkonini beradi:

• Qabulni bekor qilish — cancel_appointment:{id} ga callback yuboradi

Bot callbackni qayta ishlaydi va bekor qilishni chat ichida tasdiqlaydi.

Xodimning Telegram jarayoni

Autentifikatsiya

POST /api/org/auth/telegram
Content-Type: application/json

{
  "init_data": "query_id=...&user=...&auth_date=...&hash=..."
}

Telegram hisobini bog'lash/uzish

Mavjud hisobi bor xodimlar o'z Telegram'ini bog'lashi mumkin:

POST /api/org/telegram/link
Authorization: Bearer your-token
Content-Type: application/json

{
  "init_data": "..."
}

Bog'lanishni uzish uchun:

POST /api/org/telegram/unlink
Authorization: Bearer your-token

Xodimlarga bildirishnomalar

Yangi qabul yaratilganda, xodimlar Telegram xabarini oladi, unda:

• Mijoz ismi va xizmat tafsilotlari
• Sana va vaqt
• Inline tugmalar: Tasdiqlash / Rad etish

Xodimlar panelni ochmasdan, to'g'ridan-to'g'ri Telegram'dan qabullarni tasdiqlashi yoki rad etishi mumkin.

Telegram orqali onboarding

Yangi foydalanuvchilar Telegram orqali tashkilot yaratishi yoki unga qo'shilishi mumkin:

POST /api/org/telegram/create-organization
Authorization: Bearer your-token
Content-Type: application/json

{
  "name": "My Salon",
  "category": "beauty"
}

POST /api/org/telegram/join-organization
Authorization: Bearer your-token
Content-Type: application/json

{
  "invite_code": "ABC123"
}

Maxsus Telegram bot (White-Label)

Tashkilotlar brendlangan tajriba uchun o'z Telegram botini ulashi mumkin. Standart Bronjoy boti o'rniga mijozlar tashkilotning boti bilan ishlaydi.

Maxsus botni ulash

Faqat egasi uchun. custom_telegram_bot feature flag'i talab qilinadi.

POST /api/org/telegram-bot/connect
Authorization: Bearer your-owner-token
Content-Type: application/json

{
  "bot_token": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
}

Bronjoy tokenni Telegram API orqali tekshiradi, webhookni sozlaydi va Mini App'ingizga olib boradigan menyu tugmasini o'rnatadi.

Ulanish holatini tekshirish

GET /api/org/telegram-bot
Authorization: Bearer your-owner-token

Bot ma'lumotlari, webhook holati va kutilayotgan xatolarni qaytaradi.

Ulanishni uzish

POST /api/org/telegram-bot/disconnect
Authorization: Bearer your-owner-token

Webhookni olib tashlaydi va maxsus botni uzadi. Uning o'rniga standart Bronjoy boti ishlatiladi.

Eng yaxshi amaliyotlar

• Agar brend o'ziga xosligingiz muhim bo'lsa, maxsus botni ulang — mijozlar sizning bot nomingiz va avataringizni ko'radi
• Xodimlar botini erta sozlang — u yangi yozilishlarga javob berish vaqtini sezilarli darajada qisqartiradi
• Yozilish uchun mijozlarni Telegram'dan foydalanishga undang — bu email/telefon orqali autentifikatsiyaga qaraganda kamroq to'siq yaratadi