BotApi

All URIs are relative to https://api-APP_ID.sendbird.com

Method	HTTP request	Description
createBot	POST /v3/bots	Create a bot
deleteBotById	DELETE /v3/bots/{bot_userid}	Delete a bot
joinChannels	POST /v3/bots/{bot_userid}/channels	Join channels
leaveChannels	DELETE /v3/bots/{bot_userid}/channels	Leave channels - When leaving all channels
leaveChannelsByUrl	DELETE /v3/bots/{bot_userid}/channels/{channel_url}	Leave channels - When leaving a channel by its channel URL
listBots	GET /v3/bots	List bots
sendBotsMessage	POST /v3/bots/{bot_userid}/send	Send a bot's message
updateBotById	PUT /v3/bots/{bot_userid}	Update a bot
viewBotById	GET /v3/bots/{bot_userid}	View a bot

createBot

CreateBotResponse createBot().apiToken(apiToken).createBotData(createBotData).execute();

Create a bot

Creates a new bot within the application. Creating a bot is similar to creating a normal user, except that a callback URL is specified in order for the bot to receive events.

Note: The bot must join a group channel first to interact with users. In group channels, you can invite a bot through the invite as members action instead.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-create-a-bot

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String apiToken = "{{API_TOKEN}}"; // String | 
        CreateBotData createBotData = new CreateBotData(); // CreateBotData | 
        try {
            CreateBotResponse result = api.createBot()
                .apiToken(apiToken)
                .createBotData(createBotData)
                .execute();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#createBot");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Description	Notes
apiToken	String		[optional]
createBotData	CreateBotData		[optional]

Return type

CreateBotResponse

Authorization

No authorization required

HTTP request headers

Content-Type: application/json
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Successful response	-

deleteBotById

Object deleteBotById(botUserid).apiToken(apiToken).execute();

Delete a bot

Deletes a bot from an application.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-delete-a-bot

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String botUserid = "botUserid_example"; // String | 
        String apiToken = "{{API_TOKEN}}"; // String | 
        try {
            Object result = api.deleteBotById(botUserid)
                .apiToken(apiToken)
                .execute();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#deleteBotById");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Description	Notes
botUserid	String
apiToken	String		[optional]

Return type

Object

Authorization

No authorization required

HTTP request headers

Content-Type: Not defined
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Successful response	-

joinChannels

JoinChannelsResponse joinChannels(botUserid).apiToken(apiToken).joinChannelsData(joinChannelsData).execute();

Join channels

Makes a bot join one or more channels.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-join-channels

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String botUserid = "botUserid_example"; // String | 
        String apiToken = "{{API_TOKEN}}"; // String | 
        JoinChannelsData joinChannelsData = new JoinChannelsData(); // JoinChannelsData | 
        try {
            JoinChannelsResponse result = api.joinChannels(botUserid)
                .apiToken(apiToken)
                .joinChannelsData(joinChannelsData)
                .execute();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#joinChannels");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Notes
botUserid	String
apiToken	String	[optional]
joinChannelsData	JoinChannelsData	[optional]

Return type

JoinChannelsResponse

Authorization

No authorization required

HTTP request headers

Content-Type: application/json
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Successful response	-

leaveChannels

leaveChannels(botUserid).apiToken(apiToken).channelUrl(channelUrl).execute();

Leave channels - When leaving all channels

Leave channels

Makes a bot leave one or more group channels.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-leave-channels

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String botUserid = "botUserid_example"; // String | 
        String apiToken = "{{API_TOKEN}}"; // String | 
        String channelUrl = "channelUrl_example"; // String | 
        try {
            api.leaveChannels(botUserid)
                .apiToken(apiToken)
                .channelUrl(channelUrl)
                .execute();
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#leaveChannels");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Notes
botUserid	String
apiToken	String	[optional]
channelUrl	String	[optional]

Return type

null (empty response body)

Authorization

No authorization required

HTTP request headers

Content-Type: Not defined
Accept: Not defined

HTTP response details

Status code	Description	Response headers
200	Successful response	-

leaveChannelsByUrl

Object leaveChannelsByUrl(botUserid, channelUrl).apiToken(apiToken).execute();

Leave channels - When leaving a channel by its channel URL

Leave channels

Makes a bot leave one or more group channels.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-leave-channels

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String botUserid = "botUserid_example"; // String | 
        String channelUrl = "channelUrl_example"; // String | 
        String apiToken = "{{API_TOKEN}}"; // String | 
        try {
            Object result = api.leaveChannelsByUrl(botUserid, channelUrl)
                .apiToken(apiToken)
                .execute();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#leaveChannelsByUrl");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Notes
botUserid	String
channelUrl	String
apiToken	String	[optional]

Return type

Object

Authorization

No authorization required

HTTP request headers

Content-Type: Not defined
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Successful response	-

listBots

ListBotsResponse listBots().apiToken(apiToken).token(token).limit(limit).execute();

List bots

Retrieves a list of all bots within an application.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-list-bots

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String apiToken = "{{API_TOKEN}}"; // String | 
        String token = "token_example"; // String | 
        Integer limit = 56; // Integer | 
        try {
            ListBotsResponse result = api.listBots()
                .apiToken(apiToken)
                .token(token)
                .limit(limit)
                .execute();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#listBots");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Notes
apiToken	String	[optional]
token	String	[optional]
limit	Integer	[optional]

Return type

ListBotsResponse

Authorization

No authorization required

HTTP request headers

Content-Type: Not defined
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Successful response	-

sendBotsMessage

SendBirdBotsMessageResponse sendBotsMessage(botUserid).apiToken(apiToken).sendBotSMessageData(sendBotSMessageData).execute();

Send a bot's message

Sends a bot's message to a channel.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-send-a-bot-s-message

bot_userid Type: string Description: Specifies the ID of the bot to send a message.

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String botUserid = "botUserid_example"; // String | 
        String apiToken = "{{API_TOKEN}}"; // String | 
        SendBotSMessageData sendBotSMessageData = new SendBotSMessageData(); // SendBotSMessageData | 
        try {
            SendBirdBotsMessageResponse result = api.sendBotsMessage(botUserid)
                .apiToken(apiToken)
                .sendBotSMessageData(sendBotSMessageData)
                .execute();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#sendBotsMessage");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Notes
botUserid	String
apiToken	String	[optional]
sendBotSMessageData	SendBotSMessageData	[optional]

Return type

SendBirdBotsMessageResponse

Authorization

No authorization required

HTTP request headers

Content-Type: application/json
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Successful response	-

updateBotById

UpdateBotByIdResponse updateBotById(botUserid).apiToken(apiToken).updateBotByIdData(updateBotByIdData).execute();

Update a bot

Updates information on a bot.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-update-a-bot

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String botUserid = "botUserid_example"; // String | 
        String apiToken = "{{API_TOKEN}}"; // String | 
        UpdateBotByIdData updateBotByIdData = new UpdateBotByIdData(); // UpdateBotByIdData | 
        try {
            UpdateBotByIdResponse result = api.updateBotById(botUserid)
                .apiToken(apiToken)
                .updateBotByIdData(updateBotByIdData)
                .execute();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#updateBotById");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Notes
botUserid	String
apiToken	String	[optional]
updateBotByIdData	UpdateBotByIdData	[optional]

Return type

UpdateBotByIdResponse

Authorization

No authorization required

HTTP request headers

Content-Type: application/json
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Successful response	-

viewBotById

ViewBotByIdResponse viewBotById(botUserid).apiToken(apiToken).execute();

View a bot

Retrieves information on a bot.

https://sendbird.com/docs/chat/v3/platform-api/guides/bot-interface#2-view-a-bot

Example

// Import classes:
import org.sendbird.client.ApiClient;
import org.sendbird.client.ApiException;
import org.sendbird.client.Configuration;
import org.sendbird.client.model.*;
import org.sendbird.client.api.BotApi;

public class Example {
    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        defaultClient.setBasePath("https://api-APP_ID.sendbird.com");

        BotApi apiInstance = new BotApi(defaultClient);
        String botUserid = "botUserid_example"; // String | 
        String apiToken = "{{API_TOKEN}}"; // String | 
        try {
            ViewBotByIdResponse result = api.viewBotById(botUserid)
                .apiToken(apiToken)
                .execute();
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling BotApi#viewBotById");
            System.err.println("Status code: " + e.getCode());
            System.err.println("Reason: " + e.getResponseBody());
            System.err.println("Response headers: " + e.getResponseHeaders());
            e.printStackTrace();
        }
    }
}

Parameters

Name	Type	Description	Notes
botUserid	String
apiToken	String		[optional]

Return type

ViewBotByIdResponse

Authorization

No authorization required

HTTP request headers

Content-Type: Not defined
Accept: application/json

HTTP response details

Status code	Description	Response headers
200	Successful response	-

FilesExpand file tree

BotApi.md

Latest commit

History

BotApi.md

File metadata and controls

BotApi

createBot

Create a bot

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details

deleteBotById

Delete a bot

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details

joinChannels

Join channels

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details

leaveChannels

Leave channels

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details

leaveChannelsByUrl

Leave channels

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details

listBots

List bots

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details

sendBotsMessage

Send a bot's message

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details

updateBotById

Update a bot

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details

viewBotById

View a bot

Example

Parameters

Return type

Authorization

HTTP request headers

HTTP response details