This page explains how to create a Sendbird application in your dashboard and install the Calls SDK. If you’re ready to integrate Calls to your app, follow the step-by-step instructions below.
A Sendbird application comprises everything required in a Calls service including users, message, and channels. To create an application:
- Go to the Sendbird Dashboard and enter your email and password, and create a new account. You can also sign up with a Google account.
- When prompted by the setup wizard, enter your organization information to manage Sendbird applications.
- Lastly, when your dashboard home appears after completing setup, click Create + at the top-right corner.
Only one Sendbird application can be integrated per app for your service regardless of the platform. All users within your Sendbird application can communicate with each other across all platforms. This means that your iOS, Android, and web client app users can all make and receive calls with one another without any further setup. It should be noted that all data are limited to the scope of a single application, and users in different Sendbird applications can't make and receive calls to each other.
Note: For application administrators, the Sendbird Dashboard provides call logs to keep track of all calls made on the application.
Installing the Calls SDK is simple if you’re familiar with using external libraries or SDK’s in your projects. You can install the Calls SDK with npm or yarn by entering the command below on the command line.
Note: For npm, you can automatically download our Calls SDK with just an
npm installcommand by adding
sendbird-callsdependency to the
package.jsonfile of your project. For yarn, a similar method can be applied to download the Calls SDK.
Import the Calls SDK in
ES6 module as shown below:
Note: If you are using
--esModuleInteropoption to true for default imports or use
import * as SendBirdCall from "sendbird-calls".
Or add the following code in the header to install and initialize the Calls SDK.
The Calls SDK requires access permissions to microphone and camera to communicate with Sendbird server. To grant these permissions, call the
SendBirdCall.useMedia() function. This will allow the user to retrieve a list of available media devices or to retrieve any actual media streams.