I. Installation Guide
📝 WordPress User? We have a dedicated
WordPress Installation Guide with detailed instructions for WordPress sites, including theme files, plugins, and page builders.
LiveChat provides two methods for your visitors to communicate with customer service online: Embedded Chat Widget and Standalone Chat Link.
You can choose the most suitable method based on your website's needs.
Method 1: Embedded Chat Widget (Recommended)
The embedded method displays a floating chat button in the bottom-right corner of your website. Visitors click the button to open a chat window without leaving your website.
Step 1: Get Your Account ID
Log in to the dashboard management system and find your Account ID in the "Account Management" section.
Example: company_id=XU22 (Your Account ID is a string identifier)
Step 2: Add Code to Your Website
Add the following code before the </body> tag on each page of your website:
💡 Performance Optimization Tip: This code will load the chat component after the page content is fully loaded, ensuring it doesn't affect page load speed.
🌐 Official Domain: The official domain is poplivechat.com. Replace the domain in the code below with https://poplivechat.com when deploying to production.
<!-- LiveChat Chat Widget - Place before closing </body> tag -->
<!-- This code will load after page content is fully loaded for better performance -->
<script>
// Defer loading of LiveChat widget until page is fully loaded
(function() {
function loadLiveChatWidget() {
// Load CSS dynamically
var cssLink = document.createElement('link');
cssLink.rel = 'stylesheet';
cssLink.href = 'https://poplivechat.com/css/chat-widget.css';
cssLink.media = 'all';
document.head.appendChild(cssLink);
// Load JS dynamically
var jsScript = document.createElement('script');
jsScript.src = 'https://poplivechat.com/js/chat-widget.js';
jsScript.async = true;
jsScript.onload = function() {
// Initialize chat widget after script loads
// Replace YOUR_COMPANY_ID with your actual account ID
window.LiveChatWidget.init({
companyId: 'YOUR_COMPANY_ID',
buttonText: '💬 Chat Now',
buttonPosition: 'bottom-right',
primaryColor: '#667eea'
});
};
document.body.appendChild(jsScript);
}
// Wait for full page load before loading chat widget
if (window.addEventListener) {
window.addEventListener('load', loadLiveChatWidget, false);
} else if (window.attachEvent) {
window.attachEvent('onload', loadLiveChatWidget);
} else {
window.onload = loadLiveChatWidget;
}
})();
</script>
Step 3: Customize Styles (Optional)
You can customize the chat button and window styles to match your website design. Modify the following parameters in the initialization code:
window.LiveChatWidget.init({
companyId: 'YOUR_COMPANY_ID', // Your account ID (required)
buttonText: '💬 Chat Now', // Button text
buttonPosition: 'bottom-right', // Button position: bottom-right, bottom-left
primaryColor: '#667eea' // Theme color
});
Step 4: Complete
Save the file and refresh the webpage. You should see the chat button in the bottom-right corner. Click it to test if the chat functionality works properly.
💡 Performance & Best Practices:
- Delayed Loading: The chat widget loads after page content, ensuring fast page load times
- HTTPS Recommended: Ensure your website supports HTTPS for secure connections
- CDN Support: If your website uses a CDN, deploy CSS and JS files to your CDN for faster delivery
- No Impact: Embedded widget does not affect other website functionality
- Async Loading: CSS and JS are loaded asynchronously, preventing render blocking
Method 2: Standalone Chat Link
The standalone link method redirects to a dedicated chat page, suitable for scenarios requiring a full-screen chat experience or when you cannot modify website code.
Step 1: Get Your Chat Link
Log in to the dashboard management system and find your exclusive chat link in the "Company Management" section.
Link format: https://poplivechat.com/chat/chat.php?company_id=YOUR_COMPANY_ID
🌐 Official Domain: The official domain is poplivechat.com. Use this domain for production deployment.
Step 2: Add to Your Website
You can add the link in the following ways:
- Navigation Menu: Add an "Online Support" or "Chat Now" menu item in your website's navigation bar, linking to the chat page
- Button/Banner: Add a button or banner in a prominent position on your webpage that redirects to the chat page when clicked
- Contact Page: Add the chat link to your "Contact Us" page
Example code:
<a href="https://poplivechat.com/chat/chat.php?company_id=YOUR_COMPANY_ID"
target="_blank"
class="chat-link">
Chat Now
</a>
Step 3: Test the Link
Click the link to test and confirm that it opens the chat page correctly and allows communication with customer service.
💡 Tips:
- We recommend using
target="_blank" to open the link in a new window, so visitors don't leave your website
- You can customize the link text, style, and position to match your website's design
- The link method is suitable for mobile websites or responsive designs
Comparison of Both Methods
| Feature |
Embedded Widget |
Standalone Link |
| Visitor Experience |
No need to leave the website, smooth experience |
Redirects to a new page, good experience |
| Installation Difficulty |
Requires adding code |
Only requires adding a link |
| Customization Level |
Can customize style and position |
Fixed page style |
| Use Cases |
PC websites, full-featured experience |
Mobile websites, quick and easy integration |
📝 Important Notes:
- Regardless of which method you use, ensure the WebSocket server (port 8282) is running properly
- If your website uses CDN services like Cloudflare, you may need additional WebSocket support configuration
- Official domain: poplivechat.com - Use this domain for production deployment
- If you have any questions, please contact technical support: contact@items7.com
II. Usage Guide
2.1 Visitor Guide
How to Start Chatting
- Embedded Method: Click the chat button in the bottom-right corner of the website to open the chat window
- Link Method: Click links such as "Chat Now" or "Online Support" to open the chat page
Sending Messages
- Type your question or message in the input box
- Click the "Send" button or press Enter to send
- Support for sending images (click the 📷 icon to select and upload an image)
- Image size limit: Maximum 5MB
- Supported formats: JPG, PNG, GIF, WebP
Waiting for Staff Response
- After sending a message, please wait patiently for the staff member to reply
- When staff are online, they usually respond to your messages quickly
- If staff are temporarily offline, your messages will be saved and staff will see them when they come online
2.2 Staff Guide
Logging into the Staff System
- Access the staff login page:
https://poplivechat.com/chat/staff.php (Official domain: poplivechat.com)
- Log in using the username and password provided by the administrator
- After successful login, you will see the conversation list on the left
Viewing and Replying to Messages
- Conversation List: The left side displays all visitor conversations, with red numbers indicating unread messages
- Select Conversation: Click a conversation item on the left to view the visitor's chat history on the right
- Send Reply: Type your message in the input box at the bottom, then click "Send" or press Enter
- Visitor Information: On the right, you can see detailed visitor information, including IP address, region, browser, etc.
Using Quick Replies
- Click the 💬 button next to the input box to open the quick reply menu
- Select preset common phrases to quickly reply to visitors
- You can click "+ Add Quick Reply" to add company-specific common phrases
- Quick reply content supports up to 2000 characters
Sending Images
- Click the 📷 button next to the input box to select an image to send
- Images will be automatically uploaded and displayed in the chat
- Supports JPG, PNG, GIF, WebP formats, with a maximum size of 5MB
Multi-Staff Collaboration
- When multiple staff members are online simultaneously, conversations will be assigned to one staff member
- The conversation list on the left will show "Staff A is chatting" notifications
- Other staff can view the conversation history but cannot send messages
- If you need to take over a conversation, click the "Transfer to Me" button
- After transferring, the original staff member will no longer be able to send messages
2.3 Admin Dashboard Guide
Admin Login
- Access the admin dashboard:
https://poplivechat.com/admin/ (Official domain: poplivechat.com)
- Log in using the admin account (default: admin / admin123)
- Note: Please change the password promptly after the first login
Company Management
- View Company List: On the "Company Management" page, view all registered companies
- Add Company: Click the "Add Company" button and fill in company information
- Edit Company: Click the "Edit" button to modify company information, account expiration date, etc.
- Quick Reply Management: Set preset quick reply phrases for each company
- Search and Pagination: Support searching by company name and pagination browsing
Staff Management
- View Staff List: On the "Staff Management" page, view all staff members for a specific company
- Add Staff: Add new staff accounts for the specified company
- Edit Staff: Modify staff name, password, and other information
- Delete Staff: Delete unnecessary staff accounts (use with caution)
- Search and Pagination: Support searching by username and pagination browsing
Order Management
- View Orders: On the "Order Management" page, view all purchase orders
- Order Status: View payment status, service period, and other order information
- Renewal Management: Extend the service period for company accounts
- Search and Pagination: Support searching by order number, company name, and pagination browsing
2.4 Frequently Asked Questions
Q: Visitors cannot connect to the chat service?
A: Please check if the WebSocket server is running properly, and ensure port 8282 is open and not blocked by the firewall.
Q: Staff cannot receive visitor messages?
A: Please confirm that the staff member is logged in correctly and the conversation is not occupied by another staff member. Check the browser console for any error messages.
Q: Image upload failed?
A: Please check if the image size exceeds 5MB and if the format is supported. Also confirm that the server has write permissions.
Q: How to modify the chat window style?
A: For the embedded method, you can customize the style by modifying the CSS file, or contact technical support for assistance.
Q: Does it support multiple languages?
A: The system currently mainly supports English interface, but visitors can communicate with staff in any language.
Q: How long are chat records saved?
A: Chat records are saved in the database. The retention period depends on your service plan. We recommend regularly backing up important conversations.
Q: What are the pricing rules?
A: LiveChat offers a 3-month completely free trial for all new users (no credit card required). During this period, you get unlimited visitors and all features. After 3 months, paid plans are required to continue using the service. For detailed pricing, please visit the Purchase Page.
2.5 Pricing Rules
Free Trial Period
- 3 Months Completely Free: All new registered users automatically receive a 3-month free trial period
- Unlimited Usage: No visitor limits during the free period, all features available
- No Payment Required: No need to bind a payment method during the free period, completely free experience
After Free Trial Period
- Paid Plans Required: After the 3-month free trial ends, you must purchase a paid plan to continue using the service
- Plan Options: Choose from Basic ($29.99/month), Professional ($79.99/month), or Enterprise ($199.99/month) plans
- Billing Periods: Select monthly or annual billing (annual plans include discounts)
- Automatic Extension: Your account will be automatically extended upon successful payment
Payment Information
- Secure Payment: All payments are processed securely through PayPal
- Flexible Plans: Choose the plan that best fits your business needs
- Discounts Available: Annual plans and longer subscription periods include discounts
- Detailed Pricing: For specific pricing details, please visit the Purchase Page
✅ Simple Pricing Strategy
All new users get 3 months completely free (no credit card required) to try the service with unlimited visitors and all features. After 3 months, simply choose a paid plan that fits your needs to continue enjoying the service.
💬 Need Help?
If you encounter any issues while using the system, you can contact our technical support through the following methods:
- 🌐 Website: poplivechat.com
- 📧 Email: contact@items7.com
- 🕒 Business Hours: Monday to Friday 9:00 AM - 6:00 PM (EST)
2.6 Service Information