Akses API & MCP

Akses API & MCP

Metricgram menyediakan API publik dan server MCP untuk menghubungkan alat, dashboard, automasi, atau klien AI Anda dengan data dan operasi yang tersedia di akun Anda.

Server MCP tersedia di semua paket berbayar dan selama uji coba gratis 14 hari. Klien AI dapat terhubung dengan OAuth (tempel URL server lalu setujui akses) atau dengan kunci API. REST API memerlukan akses Elite. Jika akun Anda tidak memilikinya, bagian API dapat terlihat terkunci atau menampilkan pesan upgrade.

Di mana menemukannya

Buka Integrasi > MCP atau Integrasi > API di panel manajemen. Dari sana, akun yang memiliki akses dapat membuat token API, meninjau token aktif, mencabut token, dan melihat referensi teknis yang tersedia untuk paketnya.

Cara kerja token

• Token terhubung ke akun pengguna Metricgram Anda, bukan ke satu grup tertentu.
• Token dapat mengakses grup dan resource yang dapat dikelola oleh akun Anda.
• Token mencakup izin untuk area seperti grup, anggota, pesan, automasi, pelanggan, analitik, tiket dukungan, referral, dan MCP.
• Beberapa endpoint hanya membaca data; endpoint lain dapat membuat, memperbarui, memoderasi, atau memicu aksi sesuai izin token.
• Nilai token hanya ditampilkan satu kali saat dibuat. Simpan dengan aman.

Telegram Bot API melalui MCP

Server MCP juga menyediakan Telegram Bot API yang terbatas pada grup Anda, sehingga agen AI dapat bertindak di grup Anda melalui bot Metricgram atau bot kustom Anda.

• Gunakan telegram_api_methods untuk melihat daftar metode yang dapat dipanggil token Anda, dan telegram_bot_api untuk memanggil metode mana pun dengan parameter resmi Bot API.
• Tool bertipe mencakup pekerjaan sehari-hari: send_telegram_message, send_telegram_media, send_telegram_poll, pin_telegram_message, manage_forum_topic, create_telegram_invite_link, dan lainnya.
• Obrolan selalu salah satu grup Anda sendiri. Anda tidak pernah meneruskan chat_id; Metricgram menurunkannya dari group_id.
• Aksi Telegram memakai izin tersendiri: telegram:read, telegram:write, telegram:moderate, dan telegram:admin. Token yang dibuat sebelum izin ini tersedia harus dibuat ulang agar dapat menggunakannya.
• Media harus berupa URL HTTPS publik atau file_id Telegram, dan tombol inline hanya dapat membuka URL atau menyalin teks.
• Tool penulisan menerima idempotency_key opsional, sehingga panggilan yang diulang tidak bertindak dua kali.

Autentikasi dan batas

Request API memakai header Authorization: Bearer mg_.... Batas default adalah 600 request per menit per token, dan formulir token memungkinkan Anda memilih nilai dalam batas minimum dan maksimum yang diizinkan aplikasi.

Jika token dicabut, akun kehilangan akses API, atau paket tidak lagi menyertakan API & MCP, request yang memakai token tersebut akan ditolak.

Praktik baik

• Buat token terpisah untuk setiap alat eksternal.
• Gunakan nama yang jelas agar Anda tahu token dipakai di mana.
• Cabut token yang tidak lagi diperlukan.
• Jangan bagikan token di chat, tangkapan layar, tiket, atau repositori publik.