Basis pengetahuan GetMyBot

Memulai dengan API

Buat token akses, lihat daftar bot, dan buat reaksi pertama dengan contoh perintah curl.

Di halaman ini

API memungkinkan program menjalankan tindakan di GetMyBot, misalnya melihat daftar bot, membuat reaksi, dan mengambil data. Panduan ini ditujukan bagi pengembang integrasi. Jika Anda ingin menyiapkan bot tanpa menulis kode, gunakan pembuat bot visual.

Pertama, buat kunci akses yang disebut token pribadi. Setelah itu, kirim permintaan HTTP ke alamat tindakan yang disebut endpoint. Contoh di bawah menggunakan curl di terminal. Ganti https://domain-anda dengan alamat instalasi GetMyBot Anda.

Langkah 1. Buat token pribadi

Buka bagian token pribadi di akun Anda, lalu buat token baru (PAT). Segera salin nilainya: token hanya ditampilkan sekali dan diawali mbp_. Pilih cakupan akses (scopes) sesuai tindakan yang diperlukan saja. Penjelasannya ada di panduan otorisasi.

Langkah 2. Periksa alamat dan format

Semua endpoint REST berawalan /api, tanpa nomor versi di alamatnya. Data dalam permintaan dan respons berformat JSON. Untuk permintaan yang mengirim data, sertakan Content-Type: application/json. Kirim token melalui header Authorization: Bearer <TOKEN_PRIBADI>. Ganti seluruh <TOKEN_PRIBADI>, termasuk tanda kurung sudutnya, dengan nilai token lengkap yang sudah memiliki awalan mbp_. Jangan tambahkan awalan itu lagi.

Langkah 3. Lihat daftar bot

Uji token dengan meminta daftar bot Anda. Tindakan ini memerlukan cakupan bots:read atau *:

curl -H "Authorization: Bearer <TOKEN_PRIBADI>" https://domain-anda/api/bots

Respons berisi daftar bot dalam format JSON. Jika token salah atau sudah kedaluwarsa, server mengirim 401 dan respons {"error":"..."}. Lihat panduan kesalahan.

Langkah 4. Buat reaksi

Permintaan ini mengubah data dengan membuat reaksi baru. Jalankan hanya pada bot yang memang memerlukan reaksi tersebut. Anda membutuhkan cakupan reactions:write. Ganti BOT_ID dengan ID bot dari langkah 3:

curl -X POST https://domain-anda/api/bots/BOT_ID/reactions \
  -H "Authorization: Bearer <TOKEN_PRIBADI>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Halo","trigger":{"type":"command","value":"/start"}}'

Jika berhasil, respons berisi reaksi yang dibuat beserta id-nya. Untuk rincian data yang dapat dikirim, buka referensi interaktif. Halaman itu menyediakan contoh curl, JavaScript, dan Python untuk setiap endpoint.

Langkah 5. Gunakan referensi API

Setelah token berhasil digunakan, lihat operasi lainnya di referensi interaktif. Di sana tercantum alamat API, cakupan akses yang dibutuhkan, format data, serta tombol Try it untuk mencobanya.

Permintaan pertama ke Managed AI

Buat PAT dengan cakupan managed_ai:invoke. Nilai Idempotency-Key membedakan satu tindakan dari tindakan lain. Saat mengulangi permintaan yang sama, gunakan kunci dan isi permintaan yang sama. Untuk tindakan baru, gunakan kunci baru.

curl -X POST https://domain-anda/api/v1/ai/responses \
  -H "Authorization: Bearer <TOKEN_PRIBADI>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ai-demo-0001" \
  -d '{"profile":"balanced","provider":"auto","input":[{"role":"user","content":[{"type":"input_text","text":"Ringkas percakapan ini"}]}],"max_output_tokens":300}'

Jika integrasi Anda menampilkan fungsi Managed AI atau Meta, periksa /api/public/capabilities terlebih dahulu. Responsnya menunjukkan fungsi mana yang aktif pada instalasi ini. Jika suatu fungsi nonaktif, sembunyikan atau tampilkan keterangan bahwa fungsi belum tersedia.

Langkah berikutnya