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.
403alı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,MarkdownV2ya da eskiMarkdown. Ya daentitiesdizisiyle 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_parametersile bir mesajı yanıtla,disable_notificationile sessiz gönder,protect_contentile iletmeyi/kaydetmeyi engelle,link_preview_optionsile 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 altaDüğ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_urlve diğer düğmeler iletilmez: bunlar yalnız bu kullanıcının sizinle olan sohbetinde çalışır.protect_contentile 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öntem | Ne gönderir |
|---|---|
sendPhoto | Fotoğraf (caption ≤ 1.024 karakter) |
sendVideo, sendAnimation, sendVideoNote | Video, sessiz döngü (GIF benzeri), yuvarlak video notu |
sendAudio, sendVoice | Müzik dosyası, sesli mesaj |
sendDocument | Herhangi bir dosya |
sendMediaGroup | 2–10 fotoğraf/videodan albüm |
sendLivePhoto | Hareketli fotoğraf |
sendSticker | Çıkartma |
sendDice | Zar / animasyonlu emoji |
Dosyayı üç yolla verebilirsin:
- **
file_id** — daha önce gönderdiğin ya da aldığın bir dosya (aynı uygulama, aynı ortam). En hızlısı. - **
https://adresi** — inkiveta indirir. Fotoğraf en çok 5 MB, diğerleri 20 MB; URL iledocumentyalnız PDF/ZIP/GIF,voiceyalnız OGG ≤ 1 MB. - Yükleme —
multipart/form-dataile. 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ı konumueditMessageLiveLocationile güncelle,stopMessageLiveLocationile 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_idtaşı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_perioden çok 2.628.000 sn. type: "quiz"bilgi yarışması yapar.stopPollanketi kapatır.- Anonim olmayan ankette her oy sana
poll_answerolarak 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öntem | Ne yapar |
|---|---|
editMessageText | Metni değiştirir |
editMessageCaption | Medya açıklamasını değiştirir |
editMessageMedia | Medyayı değiştirir |
editMessageReplyMarkup | Yalnız düğmeleri değiştirir |
deleteMessage, deleteMessages | Uygulamanın gönderdiği mesajları siler |
forwardMessage(s), copyMessage(s) | Mesajı ilet / kopyala (yalnız uygulamanın kendi sohbetleri arasında) |
pinChatMessage, unpinChatMessage, unpinAllChatMessages | Sohbette 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 zamanprivate).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_idver. Kapalı konuya gönderim400 TOPIC_CLOSEDdö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çim | Kural |
|---|---|
| Statik | WEBP ya da PNG |
| Animasyonlu | TGS, 512×512, ≤ 3 sn, ≤ 64 KB |
| Video | WEBM (VP9, sessiz), ≤ 3 sn, ≤ 30 fps, ≤ 256 KB — sunucuda animasyonlu WebP'ye çevrilir |
Maske çıkartmaları yoktur.