Geliştirici paneli inkiveta.com

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ümKurallar
greeting (zorunlu)title 1–80, text ≤ 200, suggestions en çok 8 çip (label ≤ 20)
tilesEn çok 6 karo; title ≤ 40, subtitle ≤ 60, icon, brand_color
sectionsEn ç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"}
    ]
  }
}'
kindvalueBasılınca
komut/ad (^/[a-z0-9_]{1,32}$)Kullanıcı adına komut mesajı gönderilir
metin1–256 karakterKullanıcı adına bu metin gönderilir
bilesen_eylemieylem kimliği (^[a-z0-9_-]{1,64}$)Sana inki_component_action gelir: action:"submit", values:{"action_id":"<value>"}
mini_apphttps:// adresiMini App'in açılır
urlhttps:// adresiDış bağlantı (kullanıcıya onay sorulur)
  • 1–6 eylem; aynı kind + value iki kez olamaz.
  • icon ana sayfa karolarıyla aynı kümeden, brand_color Atö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.