sendbird-nodejs
Thin wrapper around SendBird's Platform API
Installation
npm install sendbird-nodejs --save
or
yarn add sendbird-nodejs
Usage
See SendBird Documentation for payload and response details.
You must provide your API Token when creating a new instance of SendBird and it will be attached to all requests.
var SendBird = require('sendbird-nodejs');
var sb = new SendBird(/* your sendbird api token here */);The sb instance we just created has an entry for each endpoint in the SendBird Platform API, it is an object with the endpoints methods.
Note that all methods return a Promise as returned by request-promise.
sb.openChannels
sb.openChannels.messages
sb.openChannels.metadata
sb.openChannels.metacounter
sb.groupChannels
sb.groupChannels.messages
sb.groupChannels.metadata
sb.groupChannels.metacounter
Missing endpoints
sb.applications
sb.migration
sb.bots
Example
To create a user you would simply need to have something like this:
const SendBird = require('sendbird-nodejs');
const sb = SendBird('<SOME API TOKEN>');
const payload = {
"user_id": string,
"nickname": string,
"profile_url": string,
"issue_access_token": boolean // (Optional)
};
sb.users.create(payload)
.then(function (response) {
// do something with SendBird response
// {
// "user_id": string,
// "nickname": string,
// "profile_url": string,
// "access_token": string,
// "last_seen_at": long,
// "is_online": boolean
// }
});There are two different types of parameters the Platform API requires
-
url params- you can see them in sendbird docs as{some_param}in theURL -
payload/querystring params- you can see them in the sendbird docs under therequestsection
We will treat the two types differently when calling the API.
url params will be used as arguments for the API method you are calling.
payload/querystring params will always a plain object and the last argument of the API method.
This is how we would send a message to a group channel on behalf of some user using the API: Send Message Docs
const SendBird = require('sendbird-nodejs');
const sb = SendBird('<SOME API TOKEN>');
const channelUrl = 'channel-url-from-sendbird';
const payload = {
"message_type": "MESG", // Text message
"user_id": string, // Sender user_id
"message": string, // Empty string is not allowed.
"data": string, // (Optional) Custom data
"custom_type": string, // (Optional) default: ''
"mark_as_read": boolean // (Optional) default: true
};
sb.groupChannels.messages.send(channelUrl, payload)
.then(function (response) {
// do something with SendBird response
// {
// "message_id": long,
// "type": "MESG",
// "message": string,
// "file": {
// "name": string,
// "url": string,
// "type": string,
// "size": int
// },
// "data": string,
// "channel_url": string,
// "created_at": long,
// "user": {
// "nickname": string,
// "user_id": string,
// "profile_url": string
// },
// "custom_type": string
// }
});In the docs we see the URL is https://api.sendbird.com/v3/{channel_type}/{channel_url}/messages so the channel_type param will be set by using sb.groupChannels and the channel_url is the first argument we of sb.groupChannels.message.send
Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request :D
