Create a bot
Creates a new bot within an application. Creating a bot is similar to creating a normal user, except a callback URL should be specified for a bot to receive events.
Note: The bot must first join a group channel to interact with users. In group channels, you can also invite a bot through the invite as members action.
HTTP request
Request body
The following table lists the properties of an HTTP request that this action supports.
Properties
Required | Type | Description |
---|---|---|
bot_userid | string | Specifies the unique ID of a bot. The length is limited to 80 characters. |
bot_nickname | string | Specifies the bot's nickname. The length is limited to 80 characters. |
bot_profile_url | string | Specifies the URL of a bot's profile image. The length is limited to 2,048 characters. |
bot_type | string | Specifies the bot's type to categorize bots. The length is limited to 128 characters. |
bot_callback_url | string | Specifies the server URL of where a bot is located to receive all events, requests, and data forwarded from an application. For security reasons, it is highly recommended that you use an SSL server. The length is limited to 1,024 characters. |
is_privacy_mode | boolean | Determines whether to forward all or specific messages to the bot in channels where the bot is a member. If set to |
Optional | Type | Description |
---|---|---|
enable_mark_as_read | boolean | Determines whether to mark a bot's message as read upon sending it. (Default: |
show_member | boolean | Determines whether to include information about the members of each channel in a callback response. (Default: |
channel_invitation_preference | int | Determines whether a bot automatically joins a channel when invited or joins a channel after manually accepting an invitation using the API. If set to |
Response
If successful, this action returns a bot resource in the response body.
In the case of an error, an error object is returned. A detailed list of error codes is available here.