Geliştirici paneli inkiveta.com

Mesaj göndermek

Bütün gönderim yöntemleri Telegram'dakiyle aynıdır. Her istek chat_id ister: o kullanıcıdan gelen update'teki chat.id. Yanıt olarak gönderilen Message nesnesi döner.

Dikkat: Uygulaman bir kullanıcıya ancak kullanıcı onu başlattıktan sonra yazabilir; kullanıcı ayrıca "sen yazmadan yazma" tercihini kapatmış olabilir. 403 alırsan kullanıcıyı listenden silmeden önce Kullanıcıya yazma kuralları'nı oku.

Metin#

bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/sendMessage" -H 'Content-Type: application/json' -d '{
  "chat_id": 4185489292941965,
  "text": "<b>Randevun alındı</b>\nSalı <i>14:30</i> · <a href=\"https://ornek.com/harita\">Yol tarifi</a>",
  "parse_mode": "HTML"
}'
  • En çok 4.096 karakter (UTF-16 birimiyle sayılır, Telegram gibi).
  • parse_mode: HTML, MarkdownV2 ya da eski Markdown. Ya da entities dizisiyle biçimi kendin ver.
  • Desteklenen biçimler: kalın, eğik, altı çizili, üstü çizili, spoiler, satır içi kod, kod bloğu (dil etiketiyle), bağlantı, alıntı ve açılır alıntı.
  • reply_parameters ile bir mesajı yanıtla, disable_notification ile sessiz gönder, protect_content ile iletmeyi/kaydetmeyi engelle, link_preview_options ile bağlantı önizlemesini yönet.

Kullanıcı mesajını iletir#

Kullanıcı botun metin mesajına uzun basıp İlet ile kendi sohbetlerine gönderebilir. Sohbetler uçtan uca şifreli olduğu için ileti, kullanıcının cihazında yeni bir metin mesajı olarak kurulur:

  • Mesajın metni aynen gider. Satır içi klavyedeki **url** düğmeleri alta Düğme adı: https://… satırı olarak eklenir; alıcı bağlantıya dokununca bağlantı açılır (https://inkiveta.com/@botun?startapp=… doğrudan Mini App'inizi açar).
  • web_app, callback_data, login_url ve diğer düğmeler iletilmez: bunlar yalnız bu kullanıcının sizinle olan sohbetinde çalışır.
  • protect_content ile gönderdiğiniz mesajlar, medya mesajları ve akmakta olan taslaklar iletilemez.
  • Bota iletim bildirilmez, update gelmez.

Kullanıcıdan "arkadaşına ilet" istiyorsanız davet bağlantısını bir url düğmesine koyun.

Medya ve dosyalar#

YöntemNe gönderir
sendPhotoFotoğraf (caption ≤ 1.024 karakter)
sendVideo, sendAnimation, sendVideoNoteVideo, sessiz döngü (GIF benzeri), yuvarlak video notu
sendAudio, sendVoiceMüzik dosyası, sesli mesaj
sendDocumentHerhangi bir dosya
sendMediaGroup2–10 fotoğraf/videodan albüm
sendLivePhotoHareketli fotoğraf
sendStickerÇıkartma
sendDiceZar / animasyonlu emoji

Dosyayı üç yolla verebilirsin:

  1. **file_id** — daha önce gönderdiğin ya da aldığın bir dosya (aynı uygulama, aynı ortam). En hızlısı.
  2. **https:// adresi** — inkiveta indirir. Fotoğraf en çok 5 MB, diğerleri 20 MB; URL ile document yalnız PDF/ZIP/GIF, voice yalnız OGG ≤ 1 MB.
  3. Yükleme — multipart/form-data ile. Fotoğraf 10 MB, diğerleri 50 MB.
bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/sendPhoto" \
  -F chat_id=4185489292941965 \
  -F [email protected] \
  -F caption="Yeni salonumuz 🎉"

Konum, mekân, kişi#

bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/sendVenue" -H 'Content-Type: application/json' -d '{
  "chat_id": 4185489292941965, "latitude": 40.9906, "longitude": 29.0290,
  "title": "Ayşe Kuaför", "address": "Moda Cd. 12, Kadıköy"}'
  • sendLocation — nokta ya da canlı konum (live_period). Canlı konumu editMessageLiveLocation ile güncelle, stopMessageLiveLocation ile durdur (en çok 24 saat).
  • sendVenue — adlı mekân.
  • sendContact — kişi kartı.
  • Kullanıcıdan konum ya da telefon istemek için yanıt klavyesi düğmeleri kullanılır; kullanıcı her seferinde onaylar.

Anketler ve bilgi yarışması#

bashcurl -s "https://app.inkiveta.com/bot$BOT_TOKEN/sendPoll" -H 'Content-Type: application/json' -d '{
  "chat_id": 4185489292941965,
  "question": "Hangi gün daha uygun?",
  "options": [{"text":"Cumartesi"},{"text":"Pazar"}],
  "is_anonymous": false
}'
  • Bot API 10.4 biçimi: seçenekler persistent_id taşır, allows_revoting (normal ankette varsayılan açık, yarışmada kapalı), correct_option_ids (çok doğru şık).
  • Soru 1–300 karakter, 1–12 seçenek (her biri ≤ 100), explanation ≤ 200, open_period en çok 2.628.000 sn.
  • type: "quiz" bilgi yarışması yapar. stopPoll anketi kapatır.
  • Anonim olmayan ankette her oy sana poll_answer olarak gelir.

Daha zengin, inkiveta tasarımlı anket ve yarışma için [live_poll](/gelistiriciler/bilesenler#live-poll), [quiz_question](/gelistiriciler/bilesenler#quiz-question) bileşenlerine bak.

Tepkiler#

setMessageReaction ile kullanıcının mesajına emoji tepkisi bırakırsın (ör. 👍 "aldım" demek için). Kullanıcının senin mesajlarına verdiği tepkiler message_reaction update'iyle gelir (yalnız allowed_updates'te istersen).

Yazıyor… göstergesi#

Uzun süren bir iş yapıyorsan sendChatAction ile typing, upload_photo gibi bir gösterge aç; 5 sn ya da ilk mesajına kadar görünür.

Düzenleme ve silme#

YöntemNe yapar
editMessageTextMetni değiştirir
editMessageCaptionMedya açıklamasını değiştirir
editMessageMediaMedyayı değiştirir
editMessageReplyMarkupYalnız düğmeleri değiştirir
deleteMessage, deleteMessagesUygulamanın gönderdiği mesajları siler
forwardMessage(s), copyMessage(s)Mesajı ilet / kopyala (yalnız uygulamanın kendi sohbetleri arasında)
pinChatMessage, unpinChatMessage, unpinAllChatMessagesSohbette mesaj sabitle

Aynı içerikle düzenlersen Telegram'daki gibi 400 Bad Request: message is not modified döner; bunu hata saymayabilirsin.

Sohbet ve kullanıcı bilgisi#

  • getChat — sohbet bilgisi (her zaman private).
  • getUserProfilePhotos, getUserProfileAudios — kullanıcının profil fotoğrafları / müzikleri (kullanıcının görünürlük ayarlarına tabi).
  • getChatMember, getChatMemberCount — Telegram uyumu için; birebir sohbette sen ve kullanıcı.

Konular#

Uygulamanın odasını konulara bölebilirsin (ör. "Siparişler", "Destek", "Kampanyalar"). Önce Atölye'den konuları aç (getMe.has_topics_enabled true olur), sonra:

  • createForumTopic, editForumTopic, deleteForumTopic, unpinAllForumTopicMessages, getForumTopicIconStickers.
  • Mesajı bir konuya göndermek için message_thread_id ver. Kapalı konuya gönderim 400 TOPIC_CLOSED döner.
  • Kullanıcı uygulamanın odasında konuları çip olarak görür.

Çıkartmalar#

Kendi çıkartma paketlerini oluşturabilirsin: uploadStickerFile, createNewStickerSet, addStickerToSet, setStickerPositionInSet, deleteStickerFromSet, replaceStickerInSet, setStickerEmojiList, setStickerKeywords, setStickerSetTitle, setStickerSetThumbnail, deleteStickerSet, getStickerSet.

BiçimKural
StatikWEBP ya da PNG
AnimasyonluTGS, 512×512, ≤ 3 sn, ≤ 64 KB
VideoWEBM (VP9, sessiz), ≤ 3 sn, ≤ 30 fps, ≤ 256 KB — sunucuda animasyonlu WebP'ye çevrilir

Maske çıkartmaları yoktur.