Memakai API AI untuk Bot WhatsApp dan Telegram

Bot pesan yang bisa menjawab pertanyaan pelanggan, membuatkan caption, atau merangkum percakapan panjang dibangun dari dua bagian: pintu masuk pesan (WhatsApp atau Telegram) dan otak yang menyusun jawaban. Bagian otaknya inilah yang disediakan API AI.

Karena API kami mengikuti format OpenAI, kode yang sudah banyak dicontohkan di internet bisa langsung dipakai. Yang berbeda hanya dua baris: alamat server dan kuncinya.

Bentuk dasarnya

Kalau kamu memakai SDK resmi OpenAI untuk Node.js, cukup ganti alamat dan kunci:

import OpenAI from "openai";

const ai = new OpenAI({
  baseURL: "https://api.nilovr.com/v1",
  apiKey: process.env.NILOVR_API_KEY,
});

const balasan = await ai.chat.completions.create({
  model: "glm-5.3",
  messages: [
    { role: "system", content: "Kamu asisten toko yang menjawab singkat dan ramah." },
    { role: "user", content: pesanDariPelanggan },
  ],
});

console.log(balasan.choices[0].message.content);

Versi Python tidak jauh berbeda:

from openai import OpenAI

ai = OpenAI(base_url="https://api.nilovr.com/v1", api_key=os.environ["NILOVR_API_KEY"])
balasan = ai.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": pesan}],
)

Hal yang sering dilupakan pemula

Simpan riwayat percakapan. Model tidak mengingat pesan sebelumnya. Kalau kamu ingin bot terasa nyambung, kirim beberapa pesan terakhir setiap kali memanggil API. Tapi ingat, semakin panjang riwayat yang dikirim, semakin besar biayanya. Batasi misalnya 6 pesan terakhir.

Batasi panjang jawaban. Setel max_tokens supaya jawaban tidak bertele-tele dan tagihanmu tetap terukur.

Pasang jeda dan coba ulang. Kalau penyedia sedang sibuk, permintaan bisa gagal sesaat. Beri jeda setengah detik lalu coba ulang maksimal dua kali sebelum menampilkan pesan galat ke pengguna.

Pisahkan kunci dari kode. Jangan menempelkan kunci API langsung di dalam kode yang diunggah ke GitHub. Simpan di berkas .env dan pastikan berkas itu masuk daftar abaikan. Kalau kunci sudah terlanjur tersebar, hapus dan buat yang baru.

Saring isi pesan masuk. Pelanggan bisa mengirim apa saja. Batasi panjang pesan, tolak lampiran yang tidak kamu dukung, dan jangan meneruskan data pribadi orang lain ke model.

Memilih model sesuai tugas bot

• Bot tanya jawab ringan, misalnya jam buka atau ongkos kirim: deepseek-v4-pro atau glm-5.3. Murah dan cepat.
• Bot yang merangkum percakapan panjang: kimi-k3.
• Bot yang menangani keluhan rumit dan perlu nada hati-hati: claude-sonnet-5.

Tarif tiap model ada di halaman Model. Karena semua memakai saldo yang sama, kamu bisa mengubah model tanpa mengganti kunci.

Menghitung biaya sebelum menjalankan

Satu hal yang membedakan proyek bot yang sehat dan yang tagihannya meledak: menghitung perkiraan dulu. Caranya kasar saja:

1. Perkirakan jumlah pesan masuk per hari.
2. Kalikan dengan rata-rata panjang pesan ditambah riwayat yang kamu kirim.
3. Bandingkan dengan tarif model pilihanmu per 1 juta token.

Kalau hasilnya masih nyaman, jalankan. Kalau tidak, gunakan model yang lebih murah untuk sapaan awal dan hanya pindah ke model kuat saat pertanyaannya benar-benar berat. Cara ini biasanya memotong biaya cukup banyak tanpa menurunkan mutu jawaban.

Kalau botnya dipakai untuk jualan

Beberapa hal yang membuat pelanggan betah:

• Beri tahu di awal bahwa mereka sedang bicara dengan bot, dan sediakan jalan pintas untuk memanggil manusia.
• Batasi jumlah balasan otomatis berturut-turut supaya tidak terasa berputar-putar.
• Catat pertanyaan yang paling sering gagal dijawab, lalu perbaiki instruksinya.

Kalau kamu ingin bot yang siap pakai tanpa membangun sendiri, NilovrAI juga menyediakan bot di t.me/Nilovr_autobot dan grup bantuan di t.me/+TQBjG7Z9aOwxOWNl.