Error Messages

Introduction

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

1. Log in to your WordPress admin panel
2. Navigate to the WPiko Chatbot menu in the sidebar
3. 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:

• 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

1. Length: Keep messages under 150 characters
2. Tone: Maintain a helpful and reassuring tone
3. Action: Include a clear next step or suggestion
4. Clarity: Avoid technical jargon or complex terms
5. 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:

1. Locate the specific error type
2. Enter your custom message in the text field
3. Ensure the message includes a suggested action
4. 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.