hTech AI Ticket Assistant — Installation Guide Print

Thank you for choosing the hTech AI Ticket Assistant.
Follow this guide to install, activate, and configure the module inside WHMCS.

1. System Requirements

Before installing, confirm the following:

• WHMCS Version 8.0 or higher

• PHP 7.4+ or 8.x

• IonCube Loader enabled (if licensing is applied)

• Ability to upload modules via FTP or File Manager

• Cron jobs enabled on the server

2. Upload the Module

1. Download the latest module ZIP from your client area.

2. Extract the ZIP on your computer.

3. Upload the folder:

4. Ensure the folder includes:

5. Set correct permissions:

   • All PHP files: 644

   • All folders: 755

3. Run the Database Installer

WHMCS automatically installs addon tables when activated, but if your host restricts this, you may import manually.

The module creates the following tables:

mod_htech_ai_settings
mod_htech_ai_departments
mod_htech_ai_ticket_flags
mod_htech_ai_usage
mod_htech_ai_queue
mod_htech_ai_logs
mod_htech_ai_call_stats
mod_htech_ai_ticket_insights
mod_htech_ai_recommendations
mod_htech_ai_ticket_memory
mod_htech_ai_ticket_tags
mod_htech_ai_tag_routing
mod_htech_ai_knowledge_suggestions

If manual install is needed:

1. Open phpMyAdmin

2. Select your WHMCS database

3. Import the file:

4. Activate the Module in WHMCS

1. Go to:
   WHMCS → Setup → Addon Modules

2. Find hTech AI Ticket Assistant

3. Click Activate

4. Set Admin Roles allowed to access the module

5. Click Configure

5. Enter Your License Key

If your module requires licensing:

1. Go to:
   Addons → hTech AI Ticket Assistant

2. Open the Settings tab

3. Enter your:

• License Key

• API Key (Hosted or Bring-Your-Own)

• Default Model

• Monthly Limits (for hosted plans)

4. Save changes

6. Configure Per-Department AI Modes

Each Support Department can run in a different mode.

1. Go to the Departments tab inside the module.

2. Select a WHMCS department.

3. Choose the mode:

4. Configure additional options:

• Use Knowledgebase

• Use SOPs

• Max AI Calls per Ticket

• Signoff text

Save changes.

7. Upload Your SOP (Optional but Recommended)

The assistant can follow your internal procedures.

1. Go to the SOP Manager tab

2. Upload or paste your SOP text

3. Save changes

8. AI Delay & Smart Reply Timing (Optional)

If enabled, the assistant waits before replying.

1. Open the Settings tab

2. Enable AI Reply Delay

3. Choose the delay (example: 5 minutes)

4. Note the required cron job:

Adjust the path for your server.

9. Verify Auto-Processing Is Working

Create a test ticket and verify:

• Ticket appears in AI Logs

• Suggested or automatic replies are generated

• Department rules function correctly

• Signoff text is added (if enabled)

10. Using the Dashboard

Inside Addons → hTech AI Ticket Assistant, you will see:

Ticket Activity Overview

Real-time graphs and statistics.

Top Ticket Tags

Chart displaying most-used AI-extracted topics.

Knowledge Engine Suggestions

AI-detected improvements to your KB
(With delete + purge options)

Recent Ticket Insights

Sentiment & escalation indicators
(With delete + purge options)

AI Logs

Searchable audit trail of all AI actions.

11. Purging Data (Optional Maintenance)

The module includes purge tools to keep your database clean:

• Purge Logs

• Purge Suggestions

• Purge Insights

These are available in the Settings tab.

12. Troubleshooting

Module Not Appearing

• Ensure folder name is exactly:
  htech_ai_ticket_assistant

• Clear WHMCS templates cache

No Replies Generated

• API key incorrect or missing

• Department set to “Off”

• Cron not running

• Monthly limit reached

500 Error After Activation

• Missing database tables
  Import install.sql manually

Thanks-Loop Fix

The module detects “thank you” messages and avoids repeating instructions.

13. Support

If you need help:

• Open a ticket in your client area

• Include:

  • WHMCS version

  • PHP version

  • Error logs (if any)

  • Steps to reproduce

We are here to help you get fully connected.