# API chatbot AI: otak percakapan untuk website dan aplikasimu

> Untuk membuat chatbot AI, server-mu menyimpan riwayat percakapan, menambahkan system prompt, lalu mengirim semuanya ke `/v1/chat/completions`. AIport menyediakan model bahasanya lewat API; tampilan chat dan logika bisnisnya tetap milikmu.

Diperbarui: 2026-11-04 · Versi HTML: https://aiport.id/id/api-chatbot-ai

![Ilustrasi widget chatbot di pojok halaman toko kopi online yang menjawab pertanyaan ongkos kirim](https://aiport.id/images/landing/api-chatbot-ai/widget-chatbot-ai-toko-online.webp)
*Ilustrasi toko fiktif. AIport menyediakan API-nya; widget chat dibuat sendiri.*

## Arsitektur chatbot yang aman

Browser pengguna tidak boleh memanggil AIport secara langsung, karena API key akan terlihat oleh siapa pun. Alurnya: browser mengirim pesan ke server-mu, server menambahkan system prompt dan riwayat, lalu server memanggil AIport dengan API key yang tersimpan di environment variable.

Dengan cara ini kamu juga bisa membatasi siapa yang boleh chat, memotong riwayat yang terlalu panjang, dan mencatat percakapan untuk evaluasi.

![Diagram arsitektur chatbot: browser pengguna, server milikmu yang menyimpan API key, lalu API AIport](https://aiport.id/images/landing/api-chatbot-ai/diagram-arsitektur-chatbot-ai.webp)

## Contoh system prompt customer service

**System prompt**

```
Kamu adalah asisten customer service Toko Kopi Nusantara.
- Jawab dalam bahasa Indonesia yang ramah dan singkat (maks. 3 kalimat).
- Hanya bahas produk, pengiriman, dan pembayaran toko ini.
- Kalau tidak tahu jawabannya, katakan jujur dan arahkan ke WhatsApp admin.
- Jangan pernah menjanjikan diskon atau refund.
```

## Endpoint chat sederhana di server

Contoh Node.js (Express). Frontend mengirim array `messages`, server menambahkan system prompt dan meneruskannya ke AIport.

**Node.js**

```
import express from "express";

const app = express();
app.use(express.json());

const SYSTEM_PROMPT = "Kamu adalah asisten customer service Toko Kopi Nusantara. ...";

app.post("/api/chat", async (req, res) => {
  const history = (req.body.messages ?? []).slice(-10); // batasi riwayat = batasi biaya
  const r = await fetch("https://aiport.id/v1/chat/completions", {
    method: "POST",
    headers: {
      Authorization: "Bearer " + process.env.AIPORT_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "deepseek-v4-flash",
      messages: [{ role: "system", content: SYSTEM_PROMPT }, ...history],
    }),
  });
  const data = await r.json();
  res.json({ reply: data.choices?.[0]?.message?.content ?? "" });
});

app.listen(3000);
```

## Hal yang sering terlupa

- **Riwayat = biaya** — Seluruh riwayat dikirim ulang di setiap pesan dan dihitung sebagai token input. Simpan hanya beberapa pesan terakhir atau ringkas yang lama.
- **Streaming** — Kirim `stream: true` agar jawaban muncul bertahap. Chatbot terasa jauh lebih responsif.
- **Data real-time lewat tool calling** — Untuk cek stok atau status pesanan, definisikan fungsi di `tools`; model memanggilnya dan kamu kembalikan hasilnya.
- **Jalan keluar ke manusia** — Sediakan tombol atau kata kunci untuk dialihkan ke admin saat chatbot tidak bisa membantu.

## Contoh percakapan

![Contoh percakapan pelanggan dan chatbot customer service tentang ongkos kirim](https://aiport.id/images/landing/api-chatbot-ai/contoh-percakapan-chatbot-customer-service.webp)
*Percakapan asli dengan system prompt di atas, tanpa diedit.*

## Pertanyaan yang sering diajukan

### Apakah AIport menyediakan widget chatbot siap pakai?
Tidak. AIport menyediakan API model bahasa. Tampilan chat kamu buat sendiri atau pakai library chat UI yang kamu suka, lalu sambungkan ke server-mu.

### Bagaimana chatbot bisa mengingat percakapan sebelumnya?
Model tidak menyimpan memori. Server-mu yang menyimpan riwayat dan mengirimkannya ulang di field messages setiap kali pengguna mengirim pesan.

### Bisakah chatbot menjawab berdasarkan data toko saya?
Bisa. Masukkan informasi yang relevan ke system prompt, atau pakai tool calling agar model meminta data (stok, status pesanan) dari server-mu saat dibutuhkan.

### Berapa biaya menjalankan chatbot per bulan?
Tergantung jumlah percakapan, panjang riwayat, dan model. Cara menghitungnya ada di halaman API AI murah; harga per token tiap model ada di halaman Pricing.

## Bangun chatbot pertamamu

Ambil API key, tempel contoh kode di atas, dan sesuaikan system prompt-nya. Daftar: https://aiport.id/signup · Dokumentasi: https://aiport.id/docs.md

## Halaman terkait

- [API LLM Indonesia](https://aiport.id/id/api-llm-indonesia)
- [cara integrasi AI ke website](https://aiport.id/id/cara-integrasi-ai-ke-website)
- [API AI murah](https://aiport.id/id/api-ai-murah)
