Ana sayfa ve hızlı eylemler
İki inkiveta özelliği, kullanıcı uygulamanın odasını açtığında sohbetin yanında görünür: sohbetten önce gelen ana sayfa ve yazma alanının üstünde duran hızlı eylem çubuğu. İkisi de uygulama geneline bir kez yazılır (sohbete bağlı değildir) ve sen değiştirene dek kalır.
Ana sayfa#
bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/inkiSetHomePage" -H 'Content-Type: application/json' -d '{
"home_page": {
"type": "home_page", "version": 1, "brand_color": "turuncu",
"greeting": {
"title": "Merhaba!",
"text": "Bugün 3 boş saatimiz var.",
"suggestions": [{"value":"s1130","label":"11:30"}, {"value":"s1430","label":"14:30"}]
},
"tiles": [
{"value":"randevu","title":"Randevu al","subtitle":"Boş saatleri gör","icon":"calendar"},
{"value":"hizmetler","title":"Hizmetler","subtitle":"Kesim ₺450’den","icon":"tag","brand_color":"pembe"},
{"value":"yol","title":"Yol tarifi","icon":"location","brand_color":"turkuaz"}
],
"sections": [
{"title":"Kampanyalar","cards":[{"value":"kamp_kasim","title":"Kasım’a özel %20","subtitle":"Boya + bakım","action_label":"İncele"}]}
]
}
}'
| Bölüm | Kurallar |
|---|---|
greeting (zorunlu) | title 1–80, text ≤ 200, suggestions en çok 8 çip (label ≤ 20) |
tiles | En çok 6 karo; title ≤ 40, subtitle ≤ 60, icon, brand_color |
sections | En çok 4 bölüm, her birinde 1–5 kart (title ≤ 80, subtitle ≤ 120, date YYYY-MM-DD, action_label ≤ 30) |
İkon seçenekleri: calendar, tag, clock, location, cart, chat, phone, info, star, gift, ticket, document, heart, user, settings, search.
Kullanıcı bir çipe, karoya ya da karta basınca sana inki_component_action gelir: component_type: "home_page", action: "select", values: {"value": "<basılanın value'su>"}. Diğer bileşenlerdeki gibi 10 sn içinde yanıtla ve ardından ilgili mesajı gönder (ör. randevu → takvim bileşeni).
- Ana sayfa tanımlı değilse oda doğrudan sohbetle açılır.
- Kaldırmak için
{"home_page": null}gönder. - İçeriği güncel tutmak için (ör. "bugün 3 boş saat")
inkiSetHomePage'i gerektiğinde yeniden çağır. Ana sayfa herkese aynıdır; kişiye özel bilgi koyma. - Tam şema: [
home_page](/gelistiriciler/bilesenler#home-page).
Hızlı eylemler#
Yazma alanının üstünde en çok 6 düğme:
bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/inkiSetQuickActions" -H 'Content-Type: application/json' -d '{
"quick_actions": {
"type": "quick_actions", "version": 1,
"actions": [
{"label":"Randevu al","icon":"calendar","brand_color":"turuncu","kind":"komut","value":"/randevu"},
{"label":"Sıra durumu","icon":"clock","kind":"bilesen_eylemi","value":"sira_durumu"},
{"label":"Fiyat sor","icon":"chat","kind":"metin","value":"Merhaba, kesim fiyatını öğrenmek istiyorum."},
{"label":"Hizmetler","icon":"tag","kind":"mini_app","value":"https://randevu.ornek.com/hizmetler"},
{"label":"Yol tarifi","icon":"location","kind":"url","value":"https://maps.ornek.com/salon"}
]
}
}'
kind | value | Basılınca |
|---|---|---|
komut | /ad (^/[a-z0-9_]{1,32}$) | Kullanıcı adına komut mesajı gönderilir |
metin | 1–256 karakter | Kullanıcı adına bu metin gönderilir |
bilesen_eylemi | eylem kimliği (^[a-z0-9_-]{1,64}$) | Sana inki_component_action gelir: action:"submit", values:{"action_id":"<value>"} |
mini_app | https:// adresi | Mini App'in açılır |
url | https:// adresi | Dış bağlantı (kullanıcıya onay sorulur) |
- 1–6 eylem; aynı
kind+valueiki kez olamaz. iconana sayfa karolarıyla aynı kümeden,brand_colorAtölye paletinden.- Kaldırmak için
{"quick_actions": null}. - Şema: [
quick-actions.schema.json](/gelistiriciler/semalar/quick-actions.schema.json).
İpucu: Ana sayfa "vitrin", hızlı eylemler "kısayol"dur. Sık kullanılan 3–4 işi hızlı eylemlere koy; tanıtım ve kampanyaları ana sayfaya.