BUILT FOR REACT NATIVE

React Native
Chat SDK

Build mobile messaging with Tencent RTC’s React Native Chat SDK. Share chat logic across iOS and Android while keeping your own screens and native interactions.

DEVELOPER RESOURCES

React Native Chat SDK Docs & Examples

Keep projects moving

Bring shared files and team discussions into the mobile tools people already use.

REACT NATIVE CHAT CAPABILITIES

Messaging foundations for your product

Direct conversations

  • One-to-one messages
  • Your own interface

Group messaging

  • Shared conversations
  • Membership APIs

Rich messages

  • Text and media
  • Custom application content

Conversation state

  • History and unread counts
  • Your application store

User identity

  • Your own user IDs
  • UserSig authentication

App integration

  • React Native APIs
  • Platform-specific lifecycle

Explore the React Native Chat APIs

Start with the APIs that connect your application.

Connect

One messaging layer, two platforms

Register the upload and network plugins before connecting your users.

Read the Documentation
chat.ts
import TencentCloudChat from '@tencentcloud/chat';
import NetInfo from '@react-native-community/netinfo';
import TIMUploadPlugin from 'tim-upload-plugin';

const chat = TencentCloudChat.create({ SDKAppID });
chat.registerPlugin({ 'chat-network-monitor': NetInfo });
chat.registerPlugin({ 'tim-upload-plugin': TIMUploadPlugin });

CUSTOMIZATION

Your experience. Your way.

Build your own interface around connected conversations.

Build an experience of your own

Connect messaging events to the screens and interactions your product needs.

Read the Documentation

GET STARTED

Your first conversation starts here

  1. 01

    Create your app

    Set up a Chat application and your test users.

    Open Chat Console
  2. 02

    Add the React Native Chat SDK

    Follow the platform guide to connect your project.

    Follow the Integration Guide
  3. 03

    Connect your users

    Sign in two test users and send your first message.

    Connect Your Users
React Native Chat SDK
Terminal
npm install @tencentcloud/chat tim-upload-plugin @react-native-community/netinfo
chat.ts
import TencentCloudChat from '@tencentcloud/chat';
import NetInfo from '@react-native-community/netinfo';
import TIMUploadPlugin from 'tim-upload-plugin';

const chat = TencentCloudChat.create({ SDKAppID });
chat.registerPlugin({ 'chat-network-monitor': NetInfo });
chat.registerPlugin({ 'tim-upload-plugin': TIMUploadPlugin });

React Native Chat SDK FAQs

Does the SDK handle native platform setup?

The messaging layer is shared, but native modules, media permissions, push configuration, and device builds still need platform-specific setup. Follow the React Native SDK guide for the supported package combination.

Does the React Native Chat SDK include a ready-made UI?

The SDK supplies messaging APIs and events. Your application builds the chat screens. The illustrations show possible app experiences.

How do I authenticate users of the React Native Chat SDK?

Generate production UserSig on your backend. Pass it to the client for authentication and keep your application secret on the server.

Are these React Native snippets a complete application?

They show individual integration steps. Follow the full guide for imports, initialization, login, error handling, and target-specific configuration. Test messaging with separate accounts before release.

How is React Native Chat SDK usage priced?

Hosted Chat service usage follows your selected plan. Check the included features and allowances for your application; optional plugins and Call services can have separate requirements.

How do I integrate React Native Chat SDK with React Native?

Install the documented package and native dependencies, then rebuild your native app. Verify permissions, lifecycle and native callbacks rather than assuming a JavaScript-only runtime.

How do I test React Native Chat SDK before releasing my app?

Check login, SDK readiness, send and receive events, and message state after reconnecting.

How do I customize the interface for React Native Chat SDK?

Build your own conversation list, message rendering and composer around documented SDK events.

Find support for your next step

Talk about your application

Discuss your product, expected usage, and integration needs.

Contact Sales

Build your next conversation

Build your app with the React Native Chat SDK.