REST API ve Tokenler

GetMyBot, görsel oluşturucunun yanı sıra programatik olarak da erişilebilir: bot verilerini REST API üzerinden yönetebilirsiniz. İki tür token mevcuttur — belirli bir bota erişim için ve hesap düzeyindeki otomasyon ve entegrasyonlar için kişisel tokenler.

Bot API Tokenleri

Ayarlar → API Tokenleri bölümünde oluşturulur. Her token bir bota bağlıdır ve REST uç noktalarına (tepkiler, kullanıcılar, koleksiyonlar, istatistikler vb.) erişim sağlar. Token oluşturulurken yalnızca bir kez gösterilir — güvenli bir yerde saklayın; liste ad, maske ve oluşturma tarihini gösterir. Gereksiz tokenleri silin.

Kişisel Erişim Tokenleri (PAT)

Kişisel erişim tokenleri (PAT, mbp_ önekiyle başlar) hesap düzeyinde çalışır ve otomasyon ile entegrasyonlar için kullanılır. Kişisel hesap panelinde oluşturulur; Authorization: Bearer mbp_… başlığıyla iletilir. Tokenin erişim kapsamları (scopes) vardır — kaynak:eylem biçiminde izinler (örn. reactions:read, bots:write); * ise tam erişim anlamına gelir. Geçerlilik süresi sınırlandırılır ve tokenler karma hâlinde saklanır. Bu, bir betiğe parola vermeden kısıtlı erişim sağlamanın kullanışlı bir yoludur.

API ile Neler Yapılabilir

API aracılığıyla arayüzdekilerle aynı varlıklara erişilir: botlar ve ayarları, tepkiler (içe/dışa aktarma dahil), aboneler ve etiketler, koleksiyonlar ve kayıtlar, istatistikler ve istek günlüğü, toplu gönderimleri. Bu sayede GetMyBot üzerinde özel panolar, senkronizasyonlar ve otomasyonlar oluşturabilirsiniz.

Kanallar ve WhatsApp

GetMyBot çok kanallıdır (Telegram + WhatsApp + VK) ve bir botun kanalları da REST üzerinden yönetilir. Kanallar ve WhatsApp şablonları ortak scope'lar bots:read / bots:write ile korunur — ayrı bir kanal scope'u yoktur.

  • GET /api/channels/capabilities — kanal yetenek matrisi (oturum uç noktası, PAT scope'u gerektirmez).
  • GET /api/bots/{botID}/channels (bots:read) — botun kanallarını listeler.
  • POST /api/bots/{botID}/channels (bots:write) — WhatsApp veya VK kanalı bağlar.
  • DELETE /api/bots/{botID}/channels/{channelID} (bots:write) — bir kanalı çözer.
  • GET /api/bots/{botID}/channels/{channelID}/templates (bots:read) — kanalın WhatsApp şablon kataloğu.
  • POST /api/bots/{botID}/channels/{channelID}/templates (bots:write) — bir şablon oluşturur ve Meta moderasyonuna gönderir.
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync (bots:write) — kataloğu Meta'dan yeniden senkronize eder.
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — bir şablonu düzenler.
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — bir şablonu siler.
  • POST /api/bots/{botID}/channels/{channelID}/templates/media (bots:write) — medya başlığı örneği yükler (görsel/video/belge).

İstek ve yanıt şemaları, parametreler ve örnekler API Referansı'nda yer alır. Kanalların ve şablonların kullanıcı tarafındaki açıklaması — WhatsApp sayfasında.

Mobil Erişim

Platformun, kendi kimlik doğrulamasına (erişim ve yenileme tokenleri) ve botlar için özet bir panoya sahip mobil uygulaması vardır — aynı arka ucu kullanır.

API Referansı

Genel API için tam etkileşimli referans, API Referansı sayfasında mevcuttur: PAT ile erişilebilen tüm uç noktalar, parametreler, istek ve yanıt şemaları, gerekli kapsamlar ve hazır istek örnekleri (curl, JavaScript, Python) listelenmiştir. Sayfadan doğrudan kendi tokeninizle deneme isteği gönderilebilir.

Güvenlik

  • Tokenler bir kez gösterilir; sır olarak saklayın.
  • Bot ve kimlik bilgisi sırları şifreli olarak saklanır.
  • Değişiklikler denetim günlüğüne kaydedilir.

Sonraki Adımlar