README

Plugin Chatbot Minara

Minara Chatbot Plugin adalah package untuk Laravel yang memudahkan integrasi UI chatbot ke aplikasi web.

• UI widget berbasis Blade + Alpine.js
• Endpoint bawaan untuk menyimpan chat dan mengambil suggested questions
• Default WS mengarah ke endpoint Aranus, tapi bisa dioverride oleh developer lain melalui .env/config

📦 Installation

Install package menggunakan Composer:

composer require aranustech/plugin-chatbot-internship

Laravel akan otomatis mendeteksi package melalui Package Auto Discovery.

Jalankan installer (recommended):

php artisan minara-chatbot:install

Atau publish manual:

php artisan vendor:publish --tag=minara-chatbot-assets
php artisan vendor:publish --tag=minara-chatbot-config
php artisan vendor:publish --tag=minara-chatbot-views
php artisan migrate

🚀 Usage

Tempelkan directive ini di layout yang ingin ditampilkan chatbot:

@yield('content')
@minaraChatbot

Catatan: widget membutuhkan Alpine.js.

⚙️ Configuration

Override WS (agar pakai server kamu sendiri):

MINARA_CHATBOT_WS_URL=wss://your-ws-url

Opsional:

MINARA_CHATBOT_SAVE_URL=/chat-log
MINARA_CHATBOT_SUGGESTED_URL=/widget/suggested
MINARA_CHATBOT_SOURCE=internship
MINARA_CHATBOT_LOGO_URL=/vendor/minara-chatbot/icon-aranus.png

Route bawaan bisa diubah / dimatikan:

MINARA_CHATBOT_SAVE_PATH=chat-log
MINARA_CHATBOT_SUGGESTED_PATH=widget/suggested
MINARA_CHATBOT_ROUTES_PREFIX=
MINARA_CHATBOT_ROUTES_ENABLED=true

💾 Chat History Storage

Package ini menyimpan riwayat percakapan ke database menggunakan tabel:

chat_histories

Struktur tabel:

id
user_message
bot_reply
session_id
created_at
updated_at

🔌 Endpoints (Default)

• POST /chat-log (simpan chat)
• GET /widget/suggested (ambil suggested questions)

Jika project host sudah punya endpoint sendiri, matikan route bawaan dengan:

MINARA_CHATBOT_ROUTES_ENABLED=false

✏️ Editable Setelah Install

Bisa diubah oleh developer yang memakai:

• Config: publish lalu edit config/minara-chatbot.php
  • php artisan vendor:publish --tag=minara-chatbot-config
• View widget: publish lalu edit resources/views/vendor/minara-chatbot/widget.blade.php
  • php artisan vendor:publish --tag=minara-chatbot-views
• Asset (logo/icon): publish lalu edit file di public/vendor/minara-chatbot/
  • php artisan vendor:publish --tag=minara-chatbot-assets

⚙️ Requirements

• PHP 8.1+
• Laravel 10 / 11 / 12
• Composer
• Alpine.js

📁 Package Information

intern project