AgencyMod API

Gunakan AgencyMod-mu dengan AgencyAI di sistem tiket, website, atau helpdesk milikmu sendiri. Ia menjawab dengan semua yang kamu atur di dashboard: nama, nada, level, instruksi, pengetahuan, dokumentasi, dan apa yang sudah dipelajari dari timmu.

Buka dashboard Pengaturan AI

Mulai

01Buka dashboard, tab AI, dan buat kunci di bawah AgencyMod API. Salin langsung, karena hanya ditampilkan sekali.
02Simpan kunci di servermu. Jangan pernah memasukkannya ke website, aplikasi, atau apa pun yang bisa dibuka orang lain.
03Kirim percakapan tiket ke API dengan header Authorization: Bearer dan kunci kamu.
04Tampilkan jawabannya di tiketmu. Jika needs_team bernilai true, beri tahu timmu.

Contoh

cURL

curl https://bot.agencyscripts.dev/api/v1/chat \
  -H "Authorization: Bearer amk_..." \
  -H "Content-Type: application/json" \
  -d '{"customer":"Alex","messages":[{"role":"user","content":"How do I join the server?"}]}'

JavaScript (Node.js)

const antwort = await fetch("https://bot.agencyscripts.dev/api/v1/chat", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.AGENCYMOD_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    customer: "Alex",
    messages: [
      { role: "user", content: "How do I join the server?" },
    ],
  }),
});
const { answer, needs_team } = await antwort.json();

PHP

$ch = curl_init("https://bot.agencyscripts.dev/api/v1/chat");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("AGENCYMOD_KEY"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "customer" => "Alex",
    "messages" => [["role" => "user", "content" => "How do I join the server?"]],
  ]),
]);
$antwort = json_decode(curl_exec($ch), true);

Permintaan

POST dengan body JSON. Kolom berikut dibaca: POST https://bot.agencyscripts.dev/api/v1/chat

messages: Percakapannya, dari yang paling lama, hingga 20 pesan. role adalah user untuk pelanggan dan assistant untuk jawaban bot sebelumnya, content adalah teksnya. Pesan terakhir harus berasal dari user. Wajib.
customer: Nama pelanggan, supaya bot bisa menyapanya. Opsional.
messages[].name: Di dalam pesan: nama orang yang menulisnya, berguna jika beberapa orang menulis di satu tiket. Opsional.

Respons

JSON

{
  "answer": "...",
  "needs_team": false,
  "bot": { "name": "AgencyMod", "avatar": "https://cdn.discordapp.com/..." },
  "level": "V1",
  "usage": {
    "available_percent": 92.5,
    "credit_percent": 0,
    "requests_today": 14,
    "requests_per_day": 1000,
    "requests_per_minute": 20,
    "premium": true
  },
  "ai_notice": "This answer was generated automatically by an AI (AgencyAI)."
}

answer: Balasan sebagai teks biasa dengan markdown sederhana.
needs_team: true jika manusia harus mengambil alih, misalnya untuk pembayaran, ban, atau masalah yang tidak bisa diselesaikan bot.
bot: Nama dan avatar dari branding kamu, untuk menampilkan jawaban persis seperti di Discord.
level: Level AgencyAI yang menjawab: V1, V1.5 atau V2.
usage: Sisa kuota dalam persen, saldo isi ulangmu, dan batas permintaanmu.
ai_notice: Catatan singkat bahwa jawaban ditulis oleh AI. Tampilkan ke pelangganmu agar mereka selalu tahu bahwa AI yang menjawab.

Cek kuotamu

Permintaan GET ke /api/v1/status dengan header yang sama mengembalikan nama dan avatar bot serta sisa kuotamu, tanpa memakai kuota sama sekali.

cURL

curl https://bot.agencyscripts.dev/api/v1/status \
  -H "Authorization: Bearer amk_..."

Batas dan kuota

01Dengan Premium, API bisa memakai hingga setengah dari kuota AI mingguanmu, jadi selalu ada kuota tersisa untuk Discord. Kuota direset setiap Senin.
02Saat kuota API habis, API lanjut memakai saldo isi ulangmu. Isi ulang ada di dashboard, tab AI, dan tidak pernah kedaluwarsa.
03Tanpa Premium kamu mendapat kuota uji coba kecil di level V1. Dibutuhkan minimal 20 anggota dan AgencyMod di servermu selama 7 hari.
0420 permintaan per menit per kunci, 1.000 permintaan per hari dengan Premium dan 150 tanpa Premium. Hingga 5 kunci per server.

Error

400: messages tidak ada, atau pesan terakhir bukan dari user.
401: Kunci tidak ada, salah, atau sudah dicabut.
402: Kuota sudah habis. Isi ulang atau dapatkan Premium.
403: Server belum memenuhi syarat untuk API tanpa Premium.
429: Terlalu banyak permintaan. Tunggu sebentar lalu coba lagi.
503: AgencyAI tidak menjawab. Coba lagi.

KeamananSiapa pun yang punya kuncimu memakai kuota AI-mu. Jika kunci bocor, cabut di dashboard lalu buat yang baru. API dibuat untuk panggilan dari servermu, browser tidak bisa memanggilnya langsung.

Jawaban yang lebih baikAPI memakai pengetahuan yang sama dengan botmu di Discord. Isi pengetahuan dan tautan dokumentasi di tab AI, dan setujui saran pelatihan dari tiket yang sudah selesai. Setiap entri yang disetujui langsung meningkatkan Discord dan API sekaligus.

Ada yang belum jelas? Buka tiket di help.agencyg.de pada kategori AgencyMod atau tanya di Discord kami. Kebijakan privasi dan syarat layanan