👍
Troubleshooting Step : Check the browser settings, especially under the Performance section. If the Energy Saver option is enabled, it might cause such issues. Disable the Energy Saver option as a troubleshooting step to resolve the problem.
This document defines the standardized error codes and their corresponding messages used across the application. These codes are categorized for clarity and ease of debugging. They help developers and support teams quickly identify the nature of the issue and take appropriate action.
Each error code follows the format:
Java
IH-<ERROR_CATEGORY>-<MODULE_CODE><SEQUENCE_NUMBER>
IH → Prefix for Interaction Hub<ERROR_CATEGORY> → 2-letter category identifier<MODULE_CODE><SEQUENCE_NUMBER> → Module and unique error sequence
Category Code Description GENERAL GE General non-specific errors VALIDATION_ERROR VA Input validation and schema-related issues PERMISSIONS AP Access permission-related failures AUTHENTICATION_AUTHORIZATION AU Authentication and authorization failures NOT_FOUND NF Resource not found SERVICE_ERROR SV API/service-level errors DATABASE_ERROR DB Failures interacting with the database INTERNAL_APPLICATION_ERROR IA Application-level unexpected failures CLIENT_ERROR CL Issues caused due to client-side behavior SERVER_ERROR SY Server-side runtime errors FUNCTIONAL_LOGIC_ERROR FL Errors arising from business rule enforcement EXTERNAL_SERVICE_ERROR EX Errors from 3rd-party or external service integrations CONFIGURATION_ERROR CO Missing or invalid configuration settings
Code Message IH-GE-010001 Your account has been temporarily deactivated due to policy violations. If you believe this is a mistake, please contact our support team.
Code Message IH-AU-020001 Your session has expired due to inactivity. Please log in again to continue. IH-AU-020002 The username or password you entered is incorrect. Please check your credentials and try again. IH-AU-020003 You are not authorized to access this resource. Ensure your account has the necessary permissions or contact an administrator.
Code Message IH-SV-030001 You have exceeded the allowed number of requests. Please wait a few moments before trying again. IH-SV-030002 This API endpoint has been deprecated and is no longer available. Please refer to the latest API documentation.
Code Message IH-AP-040001 Access denied. You do not have the required permissions to perform this action. IH-AP-040002 Your role does not allow you to perform this operation. Please contact your administrator for access. IH-AP-040003 You have exceeded the disposition selection limit. Please select within your allowed limit.
Code Message IH-NF-050001 The requested interaction could not be found. It may have been deleted or does not exist in the system. IH-FL-050002 An error occurred while updating the interaction. Please try again later or contact support if the issue persists. IH-FL-050003 There was an error while creating the interaction. Please ensure all required fields are filled correctly and try again. IH-CL-050004 This interaction is already in the queue. Please click the "Assign to Me" button to assign it and initiate the conversation. IH-CL-050005 This interaction has already been assigned to another agent. IH-DB-050006 We were unable to add the interaction to the queue. Please try again or reach out to support for assistance. IH-NF-050007 Please check the agent identifier and try again. IH-AU-050008 You are not authorized to perform this action. Your client ID does not match the provided user ID. IH-CL-050009 This interaction has been resolved. First assign the interaction IH-CL-050010 This interaction is already resolved and cannot be moved back to the queue. IH-CL-050011 This interaction is still in queue and must be assigned before it can be resolved IH-DB-050012 Failed to resolve the interaction. Please try again or contact support. IH-CL-050013 You need to have atleast one message to mark this chat as queue
Code Message IH-NF-060001 The specified conversation does not exist. Please check the ID or try refreshing your conversations. IH-FL-060002 An error occurred while updating the conversation. Please check your input or try again later. IH-FL-060003 We couldn't create the conversation. Ensure all required details are provided and retry. IH-CL-060004 Missing WhatsApp payload: "whatsapp" field is required for WhatsApp channel. IH-DB-060005 Failed to fetch conversation expiry IH-CL-060006 The agent's phone number does not match the phone number associated with this WhatsApp channel
Code Message IH-NF-070001 No contact found with the provided information. Verify the details and try again. IH-FL-070002 We were unable to update the contact information. Please check the fields and try again. IH-FL-070003 Creating the contact failed. Make sure all required fields are completed correctly.
Code Message IH-NF-080001 The channel you are trying to access was not found. It may have been removed. IH-FL-080002 Failed to update the channel. Please verify your changes and try again. IH-FL-080003 An error occurred while creating the channel. Please ensure all inputs are valid. IH-CL-080004 This channel does not support replying. Please use a different channel for interaction.
Code Message IH-SY-090001 An unexpected server error occurred. Please try again shortly or contact support if the issue persists. IH-SY-090002 The server took too long to respond. Please check your connection or try again later.
Code Message IH-CO-100001 Something went wrong. We are looking into it. Please try again in a few minutes. IH-CO-100002 An unexpected issue occurred. Please try refreshing the page or contact support.
Code Message IH-VA-110001 The request contains invalid data. Please review your input and try again. IH-VA-110002 One or more required fields are missing. Please fill out all necessary information and submit again.
Code Message IH-SV-120001 We're currently experiencing issues connecting to one of our partner services. Please try again shortly. IH-SV-120002 The request to an external service took too long to respond. Please try again in a moment.
Code Message IH-DB-130001 We couldn't connect to our database. Please try again later or report the issue. IH-DB-130002 A database error occurred while processing your request. Please try again.
Code Message IH-IA-140001 The application encountered a critical error and stopped unexpectedly. We're working to fix it. IH-IA-140002 An unexpected error occurred inside the application. Please retry or contact support.
Code Message IH-CL-150001 The client's request failed due to malformed input or connection issues. Please review and retry. IH-CL-150002 The client configuration appears to be incorrect. Verify your setup or contact support for help.
Code Message IH-EX-160001 We're currently experiencing issues connecting to one of our partner services. Please try again shortly. IH-EX-160002 The request to an external service took too long to respond. Please try again in a moment. IH-EX-160101 Your message text appears to be empty or incorrectly formatted. Please enter a valid message. IH-EX-160102 Replies are not supported for template messages. Please send a new message instead. IH-EX-160103 The person you are trying to reply to does not match the original recipient. Please check and try again. IH-EX-160104 The reply message is being sent from a different channel than the original one. Please use the correct channel. IH-EX-160105 You are reacting to a message from a different channel. Please use the right one. IH-EX-160106 We couldn't find the original message you're trying to reply to. It may have been deleted. IH-EX-160107 We couldn't find the message you're trying to react to. It may have been removed. IH-EX-160108 The selected template could not be found. It may have been deleted or is no longer available. IH-EX-160109 The number of values provided does not match the expected number of fields in the template. Please check and try again.
Code Message IH-CO-170001 The system encountered an invalid configuration. Please notify the support team. IH-CO-170002 Required configuration settings are missing. Contact the administrator to resolve this.
Code Message IH-NF-180001 The settings you are trying to access was not found. It may have been removed. IH-FL-180002 Failed to update the settings. Please verify your changes and try again. IH-FL-180003 An error occurred while creating the settings. Please ensure all inputs are valid.
Code Message IH-NF-190001 The scheduled call you are trying to access was not found. It may have been removed. IH-FL-190002 Failed to update the scheduled call. Please verify your inputs and try again. IH-FL-190003 An error occurred while creating the scheduled call. Please ensure all inputs are valid. IH-AU-190004 Access denied — only the owner or a supervisor can update this scheduled call.
Always use the predefined error codes from this documentation
Include meaningful error messages that help users understand what went wrong
Use appropriate HTTP status codes in conjunction with these error codes
Log error codes for debugging and monitoring purposes
Use error codes to quickly identify the category and nature of issues
Reference this documentation to provide accurate guidance to users
Escalate issues based on error categories (e.g., database errors to infrastructure team)
Prefix : Always starts with the cohort code (IH for Interaction Hub)Category : 2-letter code indicating the error typeModule : 2-digit module identifierSequence : 3-digit unique sequence number within the module 
