REST API dan token

Selain editor visual, GetMyBot dapat diakses secara programatik: data bot dapat dikelola melalui REST API. Ada dua jenis token — untuk akses ke bot tertentu dan pribadi (untuk otomasi dan integrasi di tingkat akun).

Token API bot

Dibuat di Pengaturan → Token API. Setiap token terikat ke bot dan memungkinkan akses ke endpoint REST-nya (reaksi, pengguna, koleksi, statistik, dll.). Token ditampilkan hanya sekali saat pembuatan — simpan di tempat yang aman; daftar menampilkan nama, mask, dan tanggal pembuatan. Hapus token yang tidak diperlukan.

Token akses pribadi (PAT)

Token akses pribadi (PAT, diawali dengan mbp_) beroperasi di tingkat akun dan digunakan untuk otomasi serta integrasi. Dibuat di panel pribadi; dikirimkan di header Authorization: Bearer mbp_…. Token memiliki cakupan akses (scopes) — sekumpulan izin dalam format resource:aksi (misalnya, reactions:read, bots:write), sementara * berarti akses penuh. Masa berlaku dibatasi, dan token disimpan dalam bentuk hash. Ini adalah cara mudah untuk memberi skrip akses terbatas tanpa memberikan kata sandi.

Yang tersedia melalui API

Melalui API tersedia entitas yang sama seperti di antarmuka: bot dan pengaturannya, reaksi (termasuk impor/ekspor), pelanggan dan label, koleksi dan record, statistik dan jurnal permintaan, siaran. Ini memungkinkan Anda membangun panel kustom, sinkronisasi, dan otomasi di atas GetMyBot.

Saluran dan WhatsApp

GetMyBot bersifat multisaluran (Telegram + WhatsApp + VK), dan saluran sebuah bot juga dikelola melalui REST. Saluran dan template WhatsApp dikontrol oleh scope bersama bots:read / bots:write — tidak ada scope saluran terpisah.

  • GET /api/channels/capabilities — matriks kemampuan saluran (endpoint sesi, tidak memerlukan scope PAT).
  • GET /api/bots/{botID}/channels (bots:read) — daftar saluran sebuah bot.
  • POST /api/bots/{botID}/channels (bots:write) — menghubungkan saluran WhatsApp atau VK.
  • DELETE /api/bots/{botID}/channels/{channelID} (bots:write) — memutuskan saluran.
  • GET /api/bots/{botID}/channels/{channelID}/templates (bots:read) — katalog template WhatsApp saluran.
  • POST /api/bots/{botID}/channels/{channelID}/templates (bots:write) — membuat template dan mengirimkannya ke Meta untuk ditinjau.
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync (bots:write) — menyinkronkan ulang katalog dengan Meta.
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — menyunting template.
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID} (bots:write) — menghapus template.
  • POST /api/bots/{botID}/channels/{channelID}/templates/media (bots:write) — mengunggah contoh media header (gambar/video/dokumen).

Schema permintaan/respons, parameter, dan contoh ada di Referensi API.

Akses mobile

Platform ini memiliki aplikasi mobile dengan autentikasi tersendiri (token akses dan refresh) serta dashboard ringkasan bot — menggunakan backend yang sama.

Referensi API

Referensi interaktif lengkap untuk API publik tersedia di halaman Referensi API: berisi semua endpoint yang dapat diakses dengan PAT, parameter, schema permintaan dan respons, scopes yang diperlukan, serta contoh permintaan siap pakai (curl, JavaScript, Python). Anda dapat langsung menjalankan permintaan uji coba dengan token Anda dari halaman tersebut.

Keamanan

  • Token ditampilkan sekali; simpan seperti rahasia.
  • Rahasia bot dan kredensial disimpan dalam bentuk terenkripsi.
  • Mutasi dicatat dalam jurnal audit.

Selanjutnya