Procedures

Automation procedures in the Discord book.

The following documentation is for Discord v1.1.3 (BDK).

Ensure that you have installed or connected the Discord book and created a new playground before using these automation procedures.

to get some (channels) from a guild

FILTER - CAPABLE

Retrieves all channels from a specific guild.

Input Concepts

Concept	Description	Type	Required	Default Value
guild	The Guild object representing the server to get channels from.	discord guild or discord server	Yes	(no default)

Output Concepts

Concept	Description	Type
channels	A list of Channel objects containing information about each channel.	discord channel or discord guild channel

Examples

Get all channels from a specific guild:

get some guilds
use the first guild
get some channels from the guild

Get channels by name:

get the guild's channels whose name is "general"

to get some (guilds)

FILTER - CAPABLE

Retrieves all guilds (servers) that the bot is a member of.

Output Concepts

Concept	Description	Type
guilds	A list of Guild objects representing the servers the bot has access to.	discord guild or discord server

Examples

Get all guilds the bot is in:

get some guilds

Get guilds and use them in further operations:

get some guilds
use the above as the servers
for each server in servers:
    get some channels from the server

Get the guilds with specific names:

get some guilds whose name is "Kognitos Discord Test Secret Server"

to get some (members) from a guild

FILTER - CAPABLE

Retrieves all members from a specific guild.

Input Concepts

Concept	Description	Type	Required	Default Value
guild	The reference to the Guild that the bot is in.	discord guild or discord server	Yes	(no default)

Output Concepts

Concept	Description	Type
members	A list of GuildMember objects containing information about each member.	discord guild member or discord member

Examples

Get all members from a specific guild:

get some guilds
use the second guild as the guild
get some members from the guild

Get members by nick:

get the guild's member whose nick is "Integrations-Test"

to send a (new message) to a channel

Sends a message to a specific channel.

Input Concepts

Concept	Description	Type	Required	Default Value
channel	The Channel object representing where to send the message.	discord channel or discord guild channel	Yes	(no default)
new message	The MessageBody object containing the message content and any embeds.	discord message body	Yes	(no default)

Output Concepts

Concept	Description	Type
new message	A Message object representing the sent message.	discord message

Examples

Get channels and send a message:

get some guilds
use the first guild as the guild
get some channels from the guild
use the first channel as the channel
get '{"content": "Hi Discord Channel!"}' as a json
use the above as the body
send the body to the channel