Frequently Asked Questions
Find quick answers to common questions about NexlifyDesk. Can’t
find what you’re looking for? Contact our support team.
Quick Navigation
Setup & Installation
How do I install NexlifyDesk?
Method 1: WordPress Admin (Recommended)
- Download the NexlifyDesk plugin ZIP file
- Go to your WordPress admin → Plugins → Add New
- Click "Upload Plugin" and select the ZIP file
- Click "Install Now" then "Activate Plugin"
Method 2: FTP Upload
- Extract the ZIP file to get the 'nexlifydesk' folder
- Upload the folder to '/wp-content/plugins/' via FTP
- Go to WordPress admin → Plugins and activate NexlifyDesk
What are the minimum system requirements?
- WordPress: Version 6.2 or higher
- PHP: Version 7.4 or higher (PHP 8.0+ recommended)
- Database: MySQL 5.7+ or MariaDB 10.2+
- Web Server: Apache or Nginx
- SSL Certificate: Required for email piping features
How do I set up the frontend pages for customers?
Step 1: Create Ticket Submission Page
- Go to Pages → Add New in your WordPress admin
- Title the page "Submit Ticket" or "Contact Support"
- Add the shortcode:
Login Required
Please log in to submit a support ticket.
- Publish the page
Step 2: Create Ticket History Page
- Create another new page
- Title it "My Tickets" or "Support History"
- Add the shortcode:
Your Support Tickets
View and track your support requests
- Publish the page
Step 3: Configure Page Links (Optional)
Go to NexlifyDesk → Settings and set these page URLs for proper navigation between forms.
Login Required
Please log in to submit a support ticket.
- Hide default title
Your Support Tickets
View and track your support requests
Submit New Ticket
- Show only 10 recent tickets
Features & Usage
How do I set up support agents and assign permissions?
Basic Agent Setup:
- Go to Users → Add New
- Create user accounts for your support team
- Assign them the "NexlifyDesk Agent" role
- They'll now have access to the ticket management system
Advanced Agent Positions:
- Go to NexlifyDesk → Agent Positions
- Create custom positions (e.g., "Level 1 Support", "Technical Lead")
- Define capabilities for each position:
- View All Tickets: See organization-wide tickets vs. only assigned ones
- Assign Tickets: Assign tickets to other agents
- Manage Categories: Create and organize ticket categories
- View Reports: Access analytics and performance data
- Assign agents to positions via their user profiles
How does the duplicate ticket detection work?
NexlifyDesk uses a sophisticated three-layer detection system:
🎯 1. Exact Subject Matching
Detects identical subjects from the same user within the last 30 days. New messages automatically become replies to the existing conversation.
📋 2. Order Number Recognition
Intelligently recognizes patterns like "Order #12345", "Invoice ID: 67890", "#ABC123" and links all order-related communications to a single ticket.
🧠 3. Content Similarity Analysis
Advanced keyword comparison with configurable similarity threshold (default: 80%). Smart filtering of common words for accurate matching.
Configuration Options:
- Enable/disable detection in NexlifyDesk → Settings
- Adjust sensitivity threshold to match your workflow
- View detection statistics in the Reports dashboard
What are internal notes and how do I use them?
Internal notes are private messages between support team members that are completely invisible to customers.
Key Features:
- Only visible to agents and administrators
- Never sent to customers via email
- Perfect for sharing context, escalation notes, or internal updates
- Maintain complete conversation history for team reference
How to Add Internal Notes:
- Open any ticket in the admin area
- Scroll to the reply section
- Click the "Add Internal Note" tab
- Write your note and click "Add Note"
- Escalation notes when transferring tickets
- Technical details for other team members
- Customer background information
- Resolution attempts and outcomes
How do I configure file uploads and what types are supported?
Default Supported File Types:
Configuration Options:
- Go to NexlifyDesk → Settings
- Find the "File Attachments" section
- Customize:
- Allowed Extensions: Add/remove file types
- Maximum File Size: Set size limits per attachment
- Maximum Files: Limit number of files per ticket
- All uploads are validated and virus-scanned
- Files stored in secure, non-web-accessible directory
- Access controlled through WordPress permissions
- Automatic cleanup of orphaned files
Integration & Email Setup
How do I set up email piping to convert emails into tickets?
Email piping automatically converts incoming emails into support tickets. Setup varies by email provider:
📧 Custom IMAP/POP3 Setup
- Go to NexlifyDesk → Settings → Email Piping
- Select "Custom IMAP/POP3" as your provider
- Enter your mail server details:
- Host (e.g., mail.yourdomain.com)
- Port (993 for IMAP SSL, 995 for POP3 SSL)
- Username (your email address)
- Password
- Configure spam protection settings
- Choose whether to delete emails after processing
☁️ AWS WorkMail Setup
- Ensure your site has SSL enabled (required)
- Select "AWS WorkMail" as your provider
- Enter:
- AWS Region (e.g., us-east-1)
- Organization ID
- Email credentials
- Optionally configure AWS SES for enhanced email sending
🔍 Google Workspace/Gmail Setup
- Set up Google OAuth credentials in Google Cloud Console
- Select "Google Workspace" as your provider
- Complete the OAuth authentication process
- Configure email processing preferences
How does WooCommerce integration work?
NexlifyDesk automatically integrates with WooCommerce to provide better customer support context:
📋 Order History Access
Agents can search for customer orders directly from the admin interface using order numbers, customer emails, or names.
👤 Customer Context
When viewing a ticket, agents can see relevant order information including purchase date, items ordered, and order status.
🔗 Order-based Duplicate Detection
Tickets mentioning the same order number are automatically linked together, preventing scattered conversations about the same purchase.
Accessing Order Information:
- Go to NexlifyDesk → Order History
- Search by order number, customer name, or email
- View complete order details and history
- Link directly to related support tickets
Customization & Appearance
How do I customize email notification templates?
Access Email Templates:
- Go to NexlifyDesk → Email Templates
- Choose from available templates:
- New Ticket: Sent when customers create tickets
- New Reply: Sent when agents or customers reply
- Status Changed: Sent when ticket status updates
- SLA Breach: Sent when response times exceed targets
- Edit content using the visual editor
- Use dynamic placeholders for personalization
🏷️ Available Placeholders
{ticket_id}
{subject}
{user_name}
{user_email}
{status}
{priority}
{category}
{agent_name}
{ticket_url}
{site_name}
{date_created}
{last_reply}
Your ticket #{ticket_id} regarding "{subject}" has been updated.
New Status: {status}
View your ticket: {ticket_url}
Best regards,
{site_name} Support Team
Can I customize the appearance and styling?
Customization Methods:
🎨 CSS Styling Override
Add custom CSS to your theme's style.css or through the WordPress Customizer:
📁 Template System
For advanced customization, copy plugin templates to your theme:
- Create folder:
/your-theme/nexlifydesk/
- Copy template files from plugin's
/templates/
folder - Modify the copied files to match your design
- Changes will be preserved during plugin updates
⚙️ Settings Panel
Use built-in options in NexlifyDesk → Settings:
- Custom colors and branding
- Label text changes
- Form field configurations
- Behavior customizations
Troubleshooting & Support
Email notifications are not being sent. How do I fix this?
Common Causes & Solutions:
1. 📧 Check WordPress Email Configuration
NexlifyDesk uses WordPress's built-in mail system. Test if your site can send emails:
- Try WordPress password reset (forgot password link)
- If that fails, your server's email isn't configured properly
- Contact your hosting provider or install an SMTP plugin
2. ⚙️ Verify Notification Settings
- Go to NexlifyDesk → Settings
- Check "Email Notifications" section
- Ensure notifications are enabled for the events you want
- Verify email addresses are correct
3. 📄 Check Email Templates
- Go to NexlifyDesk → Email Templates
- Ensure templates aren't blank or corrupted
- Reset to defaults if needed
4. 🗂️ Check Spam Folders
Emails might be going to spam. Check spam/junk folders and add your site's email to safe sender lists.
The plugin is not working after activation. What should I check?
Step-by-Step Troubleshooting:
✅ 1. Verify System Requirements
- WordPress 6.2 or higher
- PHP 7.4 or higher
- Sufficient memory limit (256MB recommended)
✅ 2. Check Plugin Conflicts
- Deactivate all other plugins temporarily
- Test if NexlifyDesk works
- Reactivate plugins one by one to identify conflicts
✅ 3. Switch to Default Theme
- Temporarily switch to a default WordPress theme
- Test NexlifyDesk functionality
- If it works, there's a theme conflict
✅ 4. Check Error Logs
- Enable WordPress debug logging
- Check
/wp-content/debug.log
for errors - Contact support with specific error messages
Add to your wp-config.php
:
What happens to my data if I uninstall the plugin?
🛡️ Default: Data is Preserved
By default, NexlifyDesk keeps all your valuable support data when uninstalled:
- All tickets and customer conversations
- Agent responses and internal notes
- File attachments and customer data
- Categories and configuration settings
- Performance analytics and reports
🗑️ Optional: Complete Data Removal
To permanently delete all plugin data during uninstall:
- Go to NexlifyDesk → Settings
- Find "Data Management" section
- Uncheck "Keep all tickets and data when plugin is uninstalled"
- Save settings before uninstalling
Still Need Help?
Can't find the answer you're looking for? Our support team is here to help you get the most out of NexlifyDesk.