WhatsApp bot powered by Google Gemini 3 Flash Preview and the Koog AI agent framework.

WhatsApp AI Bot

A production-ready WhatsApp bot powered by Google Gemini 3 Flash Preview and the Koog AI agent framework.

Built with Kotlin and Ktor, it handles real conversations, sends rich media, reacts to messages, and presents interactive button menus — all through the Kapso WhatsApp Cloud API.

🚀 Features

• 🧠 Intelligent Reasoning — Powered by Gemini 3 Flash Preview for context-aware responses and tool execution.
• 📱 Rich Media Support — Understands and sends text, images, videos, audio clips, documents, locations, reactions, and stickers.
• 💾 Per-User Memory — Maintains conversation history independently for each user (up to 20 messages).
• 🛡️ Secure Webhooks — HMAC-SHA256 signature verification and automatic message deduplication.
• ⚡ High Performance — Built on Ktor and Coroutines with optimized thread management.
• 🌍 Multilingual — Automatically responds in the same language the user writes in.

🛠️ What It Does

When a WhatsApp user sends a message to your number, the bot:

1. Receives it via a secure webhook (HMAC-SHA256 verified).
2. Analyzes it with a per-user AI agent that has full conversation memory.
3. Reasons with Gemini 3 Flash Preview and selects the appropriate response action.
4. Responds with a text reply, image, document, emoji reaction, or interactive button menu.

🏗️ Architecture

graph TD
    User([WhatsApp User]) --> Kapso[Kapso API]
    Kapso