Skip to main content

Integrasi WHAPI dengan Gemini AI melalui Webhook

Pesan WhatsApp kini bisa dijawab otomatis oleh Gemini AI menggunakan webhook dari WHAPI (WhatsApp API Gateway). Dengan satu plugin Node.js sederhana, sistem WhatsApp dapat berinteraksi langsung dengan model AI milik Google secara real-time.

Artikel ini menjelaskan proses instalasi, konfigurasi, dan cara kerja integrasi WHAPI → Gemini.

Fungsi Plugin​

Plugin WHAPI - Chatbot Gemini bertugas sebagai jembatan komunikasi antara WhatsApp dan model AI Gemini.

Proses kerjanya:

  1. WHAPI mengirimkan data pesan masuk ke endpoint /webhook.
  2. Plugin membaca isi pesan dan nomor pengirim.
  3. Pesan diteruskan ke Gemini API untuk menghasilkan respons.
  4. Jawaban dari Gemini dikirim balik ke WhatsApp melalui endpoint sendMessage.
  5. Sistem mendukung pembaruan pesan secara bertahap melalui editMessage.

Hasil akhirnya: chatbot WhatsApp yang menjawab pertanyaan secara alami dan kontekstual.

Manfaat Integrasi​

  • Otomatisasi Percakapan: Pesan WhatsApp langsung dijawab secara otomatis oleh AI tanpa perlu dilakukan secara manual.
  • Respons Natural: Gemini menghasilkan jawaban yang relevan dengan konteks obrolan.
  • Bahasa Fleksibel: Mendukung berbagai bahasa, termasuk Bahasa Indonesia.
  • Kinerja Cepat: Respons AI dikirim dengan latensi rendah berkat arsitektur asinkron.
  • Stabil dan Terukur: Terintegrasi dengan infrastruktur Google Cloud.

Proses Instalasi​

Langkah-langkah berikut digunakan untuk menyiapkan integrasi WHAPI dengan Gemini.

1. Masuk ke Dashboard WHAPI​

Buka halaman login Admin WHAPI, lalu masukkan username dan password.

2. Akses Menu Perangkat​

Setelah berhasil masuk, buka menu Perangkat → Kelola Perangkat.
Menu ini menampilkan daftar perangkat WhatsApp yang telah terhubung ke sistem.

3. Aktifkan Webhook​

Masuk ke halaman detail perangkat, pilih tab Fitur, lalu aktifkan toggle Webhook. Opsi ini memungkinkan pengiriman data pesan ke server plugin melalui HTTP POST.

4. Konfigurasi URL Webhook​

Pindah ke tab Webhook, kemudian isi kolom URL Webhook & Media dengan alamat server plugin.

Contoh:

http://localhost:5000/webhook

Klik tombol Simpan untuk menerapkan perubahan. Setiap pesan masuk kini akan diteruskan ke alamat tersebut dalam format JSON.

5. Menjalankan Plugin Gemini​

Ekstrak arsip whapi-gemini-bot-20250813.zip, lalu buka file .env untuk konfigurasi.

# API WHAPI
WHAPI_KEY=xxxxxx
WHAPI_ENDPOINT=http://localhost:3000/api/

# Gemini
GEMINI_API_KEY=xxxxxx
WHAPI_GEMINI_ENDPOINT=https://generativelanguage.googleapis.com/v1beta/openai/chat/completions
WHAPI_GEMINI_MODEL=gemini-2.0-flash

Setelah konfigurasi selesai, jalankan plugin menggunakan salah satu metode berikut:

npm install
node whapi-gemini-chatbot.js

Jika berhasil, terminal akan menampilkan pesan:

[WHAPI] Chatbot Gemini berjalan di port 5000
Use Case
  • Layanan Pelanggan Otomatis
    Pesan dari pelanggan dijawab otomatis oleh Gemini berdasarkan konteks pertanyaan.
  • Asisten Chat Internal
    Tim operasional dapat berinteraksi langsung dengan Gemini melalui WhatsApp.
  • Chatbot Knowledge Base
    Bot memberikan jawaban berdasarkan dokumentasi internal perusahaan.
  • Penerjemah Multibahasa
    Gemini mendeteksi bahasa pengguna dan membalas dengan bahasa yang sesuai.

Kesimpulan​

Integrasi WHAPI dengan Gemini AI membuka peluang otomatisasi komunikasi yang lebih cerdas di WhatsApp. Dengan satu plugin kecil berbasis NodeJS, seluruh pesan dapat dikelola, diteruskan ke Gemini, dan dijawab kembali secara dinamis.