Overview
The WPiko Chatbot Error Messages section allows you to customize and manage the error messages displayed to users when various issues occur during chatbot interactions. Proper error message configuration helps maintain a professional user experience even when problems arise.
Accessing Error Messages Settings
Log in to your WordPress admin panel.
Navigate to the WPiko Chatbot menu in the sidebar.
Click on the “Error Messages” tab.
Understanding Error Types
The plugin handles several types of error scenarios:
- Configuration Errors: Related to API keys and setup issues.
- Connection Errors: Network and API communication problems.
- Assistant Errors: Issues specific to the OpenAI Assistant API.
- Thread Errors: Problems with conversation management.
- General Errors: Other unexpected issues.
Customizing Error Messages
For each error type, you can customize the following messages:
Failed to Create Thread
Default: “We’re having trouble starting a new conversation. Please try again in a moment.”
Use when: Initial conversation setup fails.
Failed to Add Message
Default: “We couldn’t send your message right now. Please try again shortly.”
Use when: Message transmission to API fails.
Failed to Run Assistant
Default: “Our AI assistant is taking a quick break. Please try again.”
Use when: Assistant API fails to process request.
Assistant Run Timeout
Default: “It’s taking longer than expected to process your request. Please try again or simplify your question.”
Use when: Assistant response takes too long.
Failed to Check Run Status
Default: “We’re having trouble checking the status of your request. Please try again.”
Use when: Status check fails.
Assistant Run Failed
Default: “Something went wrong while processing your request. Please try again or ask a different question.”
Use when: Assistant processing fails.
Failed to Retrieve Response
Default: “We couldn’t retrieve the AI’s response. Please try your question again.”
Use when: Response retrieval fails.
API Request Failed
Default: “We’re having trouble connecting to our AI service. Please try again in a moment.”
Use when: General API communication fails.
Best Practices for Error Messages
When customizing error messages, follow these guidelines:
Keep messages clear and concise.
Use friendly, non-technical language.
Provide a suggested action when possible.
Avoid technical details in user-facing messages.
Maintain consistency in tone across all messages.
Error Message Guidelines
Length: Keep messages under 150 characters.
Tone: Maintain a helpful and reassuring tone.
Action: Include a clear next step or suggestion.
Clarity: Avoid technical jargon or complex terms.
Branding: Align message style with your brand voice.
Error Tracking and Monitoring
The error message system:
Logs errors for administrator review.
Tracks error frequency in analytics.
Helps identify common issues.
Provides insights for system improvements.
Updating Error Messages
To modify an error message:
Locate the specific error type.
Enter your custom message in the text field.
Ensure the message includes a suggested action.
Click “Save Error Messages” to apply changes.
Tips for Effective Error Management
Regularly review errors to identify patterns.
Update messages based on user feedback.
Keep backup copies of customized messages.
Monitor error frequencies in analytics.
Maintain consistency across all error messages.
By properly configuring and managing error messages, you can provide a better user experience even when issues occur, maintaining user trust and engagement with your chatbot.
