Installation

Requirements

• WHMCS 8.0 or higher
• PHP 7.4 or higher
• Google Gemini API key (free tier available)
• cURL extension enabled
• HTTPS/SSL enabled

Step 1: Download the Addon

Download the latest release from GitHub or the WHMCS Marketplace:

Step 2: Upload Files

Extract the downloaded ZIP file and upload the contents to your WHMCS modules directory:

/path/to/whmcs/modules/addons/ai_ticket_assistant/

After uploading, your directory structure should look like this:

modules/addons/ai_ticket_assistant/
├── lib/
├── ai_ticket_assistant.php
└── hooks.php

Step 3: Activate the Addon

1. Log in to your WHMCS admin area
2. Navigate to System Settings → Addon Modules
3. Find "AI Ticket Assistant" in the list
4. Click Activate
5. Configure access control as needed
6. Click Save Changes

Step 4: Get a Gemini API Key

You'll need a Google Gemini API key to use the addon. The free tier is available and sufficient for most use cases.

1. Visit Google AI Studio
2. Sign in with your Google account
3. Click "Create API Key"
4. Copy the generated API key

Step 5: Configure the Addon

After activation, click Configure next to the addon to enter your Gemini API key and customize settings.

See the Configuration Guide for detailed information on all available settings.

Verification

To verify the installation is complete:

1. Open any support ticket in the admin area
2. Look for the AI buttons (🪄 and 🪄⚙️) above the reply textarea
3. Click the 🪄 button to generate a quick AI reply