Integrasi WHAPI ke Gemini
Plugin Node.js untuk meneruskan pesan WhatsApp ke Gemini AI (Google) dan mengirimkan balasan AI kembali ke pengguna melalui webhook Whapi.
Prasyarat:
- Node.js sudah terinstal di server.
- Aplikasi Whapi berjalan dan perangkat terhubung.
- API Key Whapi dan Gemini API Key tersedia.
- File plugin whapi-gemini-bot-*.zip sudah diunduh.
Alur Kerja Plugin
- Whapi menerima pesan masuk dari WhatsApp
- Whapi mengirim payload JSON ke endpoint /webhook plugin
- Plugin membaca isi pesan dan nomor pengirim
- Plugin meneruskan pesan ke Gemini API
- Gemini menghasilkan respons
- Plugin mengirimkan respons ke WhatsApp via sendMessage
- Pesan diperbarui secara bertahap via editMessage
Langkah 1: Aktifkan Webhook di Whapi
- Login ke dashboard Whapi
- Masuk ke Perangkat > Kelola Perangkat > Detail Perangkat
- Buka tab Fitur, aktifkan Webhook
- Buka tab Webhook, isi kolom URL Webhook & Media:
http://localhost:5000/webhook
- Klik Simpan
Langkah 2: Konfigurasi dan Jalankan Plugin
Ekstrak file whapi-gemini-bot-*.zip, lalu buka file .env dan isi nilai berikut:
# API WHAPI
WHAPI_KEY=xxxxxx
WHAPI_ENDPOINT=http://localhost:3000/api/
# Gemini (Google)
GEMINI_API_KEY=xxxxxx
WHAPI_GEMINI_ENDPOINT=https://generativelanguage.googleapis.com/v1beta/openai/chat/completions
WHAPI_GEMINI_MODEL=gemini-2.0-flash
Jalankan plugin:
npm install
node whapi-gemini-chatbot.js
Jika berhasil, terminal menampilkan:
[WHAPI] Chatbot Gemini berjalan di port 5000
Error Umum dan Solusinya
| Kondisi | Penyebab | Solusi |
|---|---|---|
| Plugin tidak menerima webhook | URL webhook salah atau plugin belum berjalan | Pastikan plugin aktif di port 5000 dan URL webhook di Whapi sudah benar |
| Gemini tidak merespons | Gemini API Key tidak valid | Periksa API Key di Google AI Studio |
| Pesan tidak sampai ke WhatsApp | WHAPI_KEY atau WHAPI_ENDPOINT salah | Periksa nilai .env |