Send your first message
This page demonstrates how to install the Chat SDK in your app so that you can send your first message in just a few simple steps. In addition, try building your app on top of our sample app to jumpstart your build.
Note: To learn about how to build a chat app using React Native and Hooks, see our React Native chat tutorial.
The following table lists browsers and their versions we support.
10 or higher
13 or higher
16 or higher
11 or higher
7 or higher
12.1 or higher
7 or higher
4.4 (Kitkat) or higher
Note: Sendbird server supports Transport Layer Security (TLS) from version 1.0 up to 1.3. For example, in the server regions where TLS 1.3 isn’t available, lower versions, sequentially from 1.2 to 1.0, will be supported for secure data transmission.
Before you start
Before installing Sendbird Chat SDK, you need to create a Sendbird application on the Sendbird Dashboard, which comprises everything required in a chat service including users, messages, and channels. You will need the
App ID of your Sendbird application when initializing the Chat SDK.
Note: Each Sendbird application can be integrated with a single client app. Within the same application, users can communicate with each other across all platforms, whether they are on mobile devices or on the web.
UIKit is a Sendbird Chat SDK add-on with user interfaces that enable an easy and fast integration of standard chat features into new or existing client apps.
If you would like a sample app with embedded UIs, see UIKit Quickstart for React.
Access control list
Sendbird provides various access control options when using the Chat SDK. By default, the following attributes are turned on to avoid unexpected errors when creating sample apps and sending your first message:
- Allow retrieving user list
- Allow updating user metadata
- Allow creating open channels
- Allow creating group channels
However, this may grant access to unwanted data or operations, leading to potential security concerns. To manage your access control settings, you can turn on or off each option in Settings > Application > Security > Access control list on Sendbird Dashboard.
To send a message in a client app, you should build and configure an in-app chat using Sendbird Chat SDK. Sendbird Chat SDK can be installed through either a web sample project or React Native project.
Step 1 Install Sendbird Chat SDK
Installing Sendbird Chat SDK is simple if you’re familiar with using external libraries or SDK’s in your projects. You can install the Chat SDK with npm using the following command.
lib/ directory), and then include the Chat SDK file to your working file.
Step 2 Initialize Sendbird Chat SDK
App ID, which can be found on the Sendbird Dashboard.
With local caching, a new optional parameter has been added to the
SendBird() method, which is
localCacheEnabled determines whether the client app will use the local storage through Sendbird Chat SDK or not. Because this is optional, the default value will be false. If you want to build a client app with our local caching functionalities, set the
localCacheEnabled to true.
Step 3 Connect to Sendbird server
You will need a user in order to send a message to a channel. You can either create a user on our dashboard or use a unique ID that hasn't been taken by any of your Sendbird application users. In the latter case, a new user will be automatically created in your Sendbird application before being connected.
Note: To learn more about authenticating with an access token, go to Authentication.
Step 4 Create a new open channel
Create an open channel. Open channels are where all users in your Sendbird application can easily participate without an invitation.
The following codes show how to create an open channel.
Note: You can also create a group channel to send a message. To learn more, see Create a channel in the Group channel page.
Step 5 Enter the channel
Enter the open channel to send and receive messages.
Step 6 Send a message to the channel
Finally, send a message to the channel. To learn about the message types you can send, refer to Message overview in Chat Platform API.