Error codes

Nexconn Chat UI returns NCError objects from provider operations when a request fails or when an SDK operation reports a non-zero result code. NCError.code is the numeric code, NCError.message is an optional operation message, and NCError.reason is resolved from the SDK error-code table when available.

0

success

The operation completed successfully.

-101

paramError

One or more parameters are invalid.

Check required fields, value ranges, channel IDs, user IDs, and enum values before calling the API.

-102

engineDestroyed

The engine is not initialized or has already been destroyed.

Initialize the engine with EngineProvider.initialize or NCEngine.initialize before calling chat, channel, user, friend, or group APIs.

-103

nativeOperationError

The underlying native SDK returned an operation error.

Check the operation-specific callback, local logs, platform setup, and SDK initialization state. If the issue is persistent, collect the app key, user ID, timestamp, and client logs for support analysis.

-104

resultUnknown

The operation result is unknown.

Retry after checking network and connection state. If the same request keeps returning this code, collect client logs and operation parameters for support analysis.

-4

notConnected

The app has not connected to the service.

Call EngineProvider.connect and wait for a successful connection before using APIs that require an active connection.

-1

unknown

Unknown error.

Inspect NCError.message, check client logs, and retry only when the operation is idempotent.

405

blockedByRecipient

Message sending failed because the sender is in the recipient's blocklist.

Ask the user to verify the relationship state before retrying. The app should not retry automatically.

407

notInRecipientAllowlist

Message sending failed because the recipient only accepts messages from an allowlist.

Ask the user to verify the relationship state before retrying.

1004

authenticationError

Authentication failed.

Check the app key, token, user identity, and token expiration. Request a new token if needed.

20109

unsupportedSystemMessage

System channels do not support sending this message.

Send the message through a supported channel type or change the message type.

20115

messageTooLarge

The message size exceeds the limit.

Reduce text, metadata, or media size before sending again.

20604

sendRateLimit

Message sending rate is too high.

Throttle sends and retry later. Avoid automatic tight retry loops.

22406

notInGroup

The user is not in this group.

Refresh group membership and prevent group actions for users who are no longer members.

22408

mutedInGroup

The user is muted in this group.

Disable message sending UI or show a clear mute state until the mute is removed.

24365

userProfileBatchLimit

The number of managed user profiles in a batch query exceeds the limit.

Split profile lookups into batches of 100 or fewer users.

24366

userNotFound

The user does not exist.

Verify the user ID and update local caches that reference deleted or invalid users.

24369

managedUserProfileDisabled

Managed user profile is not enabled.

Configure profile data in the app layer or enable the managed profile capability for the app.

25405

noPermission

The current user does not have permission to perform the operation.

Check group role, ownership, admin status, and feature permissions before showing the action.

25409

groupIdExists

The group ID already exists.

Choose a different group ID or open the existing group.

25410

groupIdNotFound

The group ID does not exist.

Refresh group data and verify that the group was not dismissed or deleted.

25411

groupMemberLimit

The number of group members exceeds the limit.

Do not invite more users until the group limit is increased or members are removed.

25417

ownerCannotLeaveOrBeKicked

The group owner cannot be kicked out or leave the group.

Transfer ownership before leaving or removing the current owner.

25418

userNotInGroup

The user ID is not in the group.

Refresh members before applying role, kick, or followed-member operations.

25423

emptyGroupName

The group name cannot be empty.

Validate the group name before creating or updating a group.

25460

alreadyFriends

The users are already friends.

Refresh friend state and hide the add-friend action for existing friends.

25466

friendRequestMissing

The friend request does not exist or has expired.

Refresh friend applications before accepting or refusing a request.

25469

notFriends

This operation cannot be performed because the users are not friends.

Refresh friend state and hide friend-only actions.

26020

onlineStatusNotEnabled

Online status subscription is not enabled.

Disable online status UI or enable the corresponding capability for the app.

28300

speechToTextDisabled

Speech-to-text service is not enabled.

This is an underlying Chat SDK service code. Chat UI 26.2.6 does not expose built-in speech-to-text UI or provider APIs; integrate that flow in the app layer if your deployment enables it.

28304

speechToTextFailed

Speech-to-text conversion failed.

This is an underlying Chat SDK service code. Chat UI 26.2.6 does not expose built-in speech-to-text UI or provider APIs; handle retries and fallback UI in the app layer.

50100

groupOperationUnsupported

The injected group operation does not support this action.

Check GroupProvider capability flags before showing the action, or provide a GroupOperations implementation that supports it.

50101

messageEditUnsupported

Message editing is not supported by this UI layer.

Hide edit controls unless your app supplies a supported edit flow.

Notes

This table only lists common codes that are useful when integrating the Flutter UI package. For exhaustive platform SDK codes, use the Nexconn Chat SDK reference that matches your release channel.