In-app Chat
  • iOS : Objective-C
  • Android
  • macOS
  • Windows
  • Web
  • Flutter
  • React Native
  • Introduction
    • Overview
    • Basic concepts
  • Sample app
  • Getting started
  • Client SDKs
    • SDK downloads
    • Release notes
  • Guides
    • Authentication
    • Manage users
    • Room
    • Group
    • Messaging
    • Call invitation (signaling)
    • Manage sessions
  • Offline push notifications
  • Error codes
  • Server APIs
  • API Documents

Error codes

Last updated:2022-03-31 11:59

The newly released In-app Chat 2.0.0 has been upgraded considerably (for detailed changes, see Release notes). If the version of the SDK you are using is earlier than 2.0.0, for its error codes, see Error codes for In-app Chat 1.x.x.

For a better development experience, we recommend you use the latest version of SDK.

Overview

This document provides possible causes and solutions for the network errors or the errors that you may encounter when running the latest version of SDK.

If the errorCode field exists in the result after the method is called, which indicates that an error occurs. And the code will be like this:

- (void)zim:(ZIM *)zim errorInfo:(ZIMError *)errorInfo{
    NSLog(@"errorCode%lu,%@",(unsigned long)errorInfo.code,errorInfo.message);
}

General errors

Return code Possible cause and solutions
0 Request execution successful.
1 Request execution failed.
6000001 The parameter is invalid. Please check the parameter.
6000002 The SDK is not initialized. Please initialize the SDK first before calling methods.
6000003 The AppID is invalid or has expired. Please check the AppID or contact ZEGOCLOUD Technical Support.
6000004 Requests have exceeded the SDK's upper limit.
6000005 Requests have exceeded the backend server's upper limit.
6000006 The Switch server reported an error, because requests have exceeded the backend server's upper limit. Please contact ZEGOCLOUD Technical Support.
6000007 Internal server error. Please contact ZEGOCLOUD Technical Support.
6000008 Internal database error. Please contact ZEGOCLOUD Technical Support.
6000009 Disconnected while sending the request. Please try reconnecting.
6000010 Failed to upload logs. Please contact ZEGOCLOUD Technical Support.

Login errors

Return code Possible cause and solutions
6000101 Login failed, because the Token is invalid or the AppID is incorrect. Please check the Token or AppID.
6000102 Login failed due to an internal error. Please contact ZEGOCLOUD Technical Support.
6000103 Token is invalid. Please call the renewToken method to renew the Token and try again.
6000104 Network error. Please check the network or contact ZEGOCLOUD Technical Support.
6000106 Token has expired. Please call the renewToken method to renew the Token and try again.
6000107 The Token you are using does not match the target Token version. Please use the correct version of the Token.
6000108 The validity period of the Token is too short. This error occurs when the valid period of the Token is shorter than 30s. Please generate a Token with a longer validity period.
6000111 You have already logged in.
6000121 You have not logged in. Please call the login method to log in first.

Message errors

Return code Possible cause and solutions
6000201 Internal error occurs while sending the message. Please upload the log and contact ZEGOCLOUD Technical Support.
6000202 Internal server error. Please upload the log first and contact ZEGOCLOUD Technical Support.
6000203 Failed to send messages due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support.
6000204 The message target (user, group, room) does not exist.
6000211 The rich media content file doesn't exist. Please check it first.
6000212 Failed to send rich media conetent. Please upload the log and contact ZEGOCLOUD Technical Support.
6000213 Unsupported image/audio/video format. Please check the format first. For more details, refer to the Message types.
6000214 File size error. Please check the size first. For more about the size limit, refer to the Message types.
6000215 Audio duration error. Please check the duration first. For more about the duration limit, refer to the Message types.
6000221 Failed to pass the content moderation. Please check the message content.
6000222 Content moderation failed. Please upload the logs first and contact ZEGOCLOUD Technical Support.

Call invitation errors

Return code Possible cause and solutions
6000270 Call invitation failed. Please upload the log and contact ZEGOCLOUD Technical Support.
6000271 Failed to cancel the call invitation. The invitee has already accepted a call invitation.
6000272 Failed to initiate outbound calls, because the number of invitees has exceeded the limit or backend error occurs. Please check the number of invitees (upper limit: 9). Or contact ZEGOCLOUD Technical Support.
6000273 The call invitation was canceled by the initiator.
6000274 The call invitation was accepted or rejected by an uninvited user. Please check whether the responding user is the target user.
6000275 The callID already exists.
6000276 The callID does not exist or has expired while canceling/accepting/rejecting the call invitation. Please check whether the callID exists or has expired.

Room errors

Return code Possible cause and solutions
6000301 Room ID does not exist. Please check the Room ID.
6000302 Operation failed due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support.
6000303 Failed to create room due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support.
6000304 Failed to join the room because the room does not exist. Please check whether the room ID exists.
6000306 Failed to leave the room because the room does not exist. Please check whether the room ID exists or contact ZEGOCLOUD Technical Support.
6000321 The user does not in the room. Please check whether the user is in the room.
6000322 The room corresponding to the roomID does not exist when calling the joinRoom method. Please check whether the room ID exists.
6000323 The room corresponding to the roomID already exists when calling the createRoom method. Please do not create rooms with the same Room ID.
6000324 The number of rooms has exceeded the upper limit (20).
6000325 The number of rooms a user can join at the same time has exceeded the upper limit. By default, a user can join up to 5 rooms at a time.
6000330 Room property error.
6000331 Failed to operate room properties. Please try again.
6000332 Failed to operate some room properties. Please try again.
6000333 Failed to search the room property. Please try again.
6000334 The number of the room property has exceeded the upper limit. A maximum of 10 properties can be set per room.
6000335 The length of the room property (key) has exceeded the limit. The default length of the key is 16.
6000336 The length of the room property (value) has exceeded the limit. The default length of the value is 1024.
6000337 The total length of the room property (value) has exceeded the limit. The limit of the total length was configured by the backend. Please contact ZEGOCLOUD Technical Support to check.

Offline notification errors

Return code Possible cause and solutions
6000401 The ID is invalid. Please check whether the ID exists.

Group errors

Return code Possible cause and solutions
6000501 Operation failed. Please upload the log and contact ZEGOCLOUD Technical Support.
6000502 Operation failed due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support.
6000503 Failed to create the group. Please try again or contact ZEGOCLOUD Technical Support.
6000504 Unfroup failed. Please try again or contact ZEGOCLOUD Technical Support.
6000505 Failed to join the group. Please try again or contact ZEGOCLOUD Technical Support.
6000506 Failed to leave the group. Please try again or contact ZEGOCLOUD Technical Support.
6000507 Failed to remove the member from the group. Please try again or contact ZEGOCLOUD Technical Support.
6000508 Failed to add members to the group. Please try again or contact ZEGOCLOUD Technical Support.
6000509 Failed to change the group owner. Please try again or contact ZEGOCLOUD Technical Support.
6000510 Failed to operate the group information. Please try again or contact ZEGOCLOUD Technical Support.
6000511 Failed to search the group information. Please try again or contact ZEGOCLOUD Technical Support.
6000512 Failed to operate the group property. Please try again or contact ZEGOCLOUD Technical Support.
6000513 Failed to query the group property. Please try again or contact ZEGOCLOUD Technical Support.
6000516 Failed to query the group list. Please try again or contact ZEGOCLOUD Technical Support.
6000517 Failed to query the group member list. Please try again or contact ZEGOCLOUD Technical Support.
6000521 The member does not in the group.
6000522 The member is already in the group.
6000523 The group does not exist. Please check whether the group exists before calling related methods.
6000524 The group already exists.
6000525 The number of group members has exceeded the upper limit.
6000526 The group property does not exist.
6000531 The number of group properties has exceeded the upper limit (10).
6000532 The length of the group property (key) has exceeded the limit. The default length of the key is 16.
6000533 The length of the group property (value) has exceeded the limit. The default length of the value is 1024.
6000541 You don't have permission to call group-related methods.
6000542 Group database error.

Session errors

Return code Possible cause and solutions
6000601 Session failed. Please upload the log and contact ZEGOCLOUD Technical Support.
6000602 Operation failed due to internal error. Please upload the log and contact ZEGOCLOUD Technical Support.
6000603 The session does not exist. Please check the session.