dpp::interaction Class Reference

An interaction represents a user running a command and arrives via the dpp::cluster::on_interaction_create event. More...

#include <appcommand.h>

Inheritance diagram for dpp::interaction:

Collaboration diagram for dpp::interaction:

Public Member Functions
std::string	build_json (bool with_id=false) const
	Build a json string for this object. More...
interaction &	fill_from_json (nlohmann::json *j)
	Fill object properties from JSON. More...
autocomplete_interaction	get_autocomplete_interaction () const
	Get the autocomplete interaction object. More...
command_interaction	get_command_interaction () const
	Get the command interaction object. More...
std::string	get_command_name () const
	Get the command name for a command interaction. More...
component_interaction	get_component_interaction () const
	Get the component interaction object. More...
double	get_creation_time () const
	Get the creation time of this object according to Discord. More...

Public Attributes
snowflake	application_id
	id of the application this interaction is for More...
cache_policy_t	cache_policy
	Cache policy from cluster. More...
snowflake	channel_id
	Optional: the channel it was sent from. More...
std::variant< command_interaction, component_interaction, autocomplete_interaction >	data
	Optional: the command data payload. More...
snowflake	guild_id
	Optional: the guild it was sent from. More...
std::string	guild_locale
	Guild's locale (language) - for guild interactions only. More...
snowflake	id
	Unique ID of object set by Discord. This value contains a timestamp, worker ID, internal server ID, and an incrementing value. Only the timestamp is relevant to us as useful metadata. More...
std::string	locale
	User's locale (language) More...
guild_member	member
	Optional: guild member data for the invoking user, including permissions. More...
snowflake	message_id
	Originating message id. More...
command_resolved	resolved
	Resolved user/role etc. More...
std::string	token
	a continuation token for responding to the interaction More...
uint8_t	type
	the type of interaction More...
user	usr
	Optional: user object for the invoking user, if invoked in a DM. More...
uint8_t	version
	read-only property, always 1 More...

Detailed Description

An interaction represents a user running a command and arrives via the dpp::cluster::on_interaction_create event.

Member Function Documentation

build_json()

std::string dpp::interaction::build_json

(

bool

with_id = false

)

const

Build a json string for this object.

Parameters

with_id

True if to include the ID in the JSON

Returns

std::string JSON string

fill_from_json()

interaction & dpp::interaction::fill_from_json

(

nlohmann::json *

j

)

Fill object properties from JSON.

Parameters

j	JSON to fill from

Returns

interaction& Reference to self

get_autocomplete_interaction()

autocomplete_interaction dpp::interaction::get_autocomplete_interaction

(

)

const

Get the autocomplete interaction object.

Exceptions

dpp::logic_exception

if the interaction is not for an autocomplete

Returns

autocomplete_interaction object

get_command_interaction()

command_interaction dpp::interaction::get_command_interaction

(

)

const

Get the command interaction object.

Exceptions

dpp::logic_exception

if the interaction is not for a command

Returns

command_interaction object

get_command_name()

std::string dpp::interaction::get_command_name

(

)

const

Get the command name for a command interaction.

Returns

std::string command interaction, or empty string if the interaction is not for a command.

get_component_interaction()

component_interaction dpp::interaction::get_component_interaction

(

)

const

Get the component interaction object.

Exceptions

dpp::logic_exception

if the interaction is not for a component

Returns

component_interaction object

get_creation_time()

double dpp::managed::get_creation_time ( ) const

inherited

Get the creation time of this object according to Discord.

Returns

double creation time inferred from the snowflake ID. The minimum possible value is the first second of 2015.

Member Data Documentation

application_id

snowflake dpp::interaction::application_id

id of the application this interaction is for

cache_policy

cache_policy_t dpp::interaction::cache_policy

Cache policy from cluster.

channel_id

snowflake dpp::interaction::channel_id

Optional: the channel it was sent from.

data

std::variant<command_interaction, component_interaction, autocomplete_interaction> dpp::interaction::data

Optional: the command data payload.

guild_id

snowflake dpp::interaction::guild_id

Optional: the guild it was sent from.

guild_locale

std::string dpp::interaction::guild_locale

Guild's locale (language) - for guild interactions only.

id

snowflake dpp::managed::id

inherited

Unique ID of object set by Discord. This value contains a timestamp, worker ID, internal server ID, and an incrementing value. Only the timestamp is relevant to us as useful metadata.

locale

std::string dpp::interaction::locale

User's locale (language)

member

guild_member dpp::interaction::member

Optional: guild member data for the invoking user, including permissions.

message_id

snowflake dpp::interaction::message_id

Originating message id.

resolved

command_resolved dpp::interaction::resolved

Resolved user/role etc.

token

std::string dpp::interaction::token

a continuation token for responding to the interaction

type

uint8_t dpp::interaction::type

the type of interaction

usr

user dpp::interaction::usr

Optional: user object for the invoking user, if invoked in a DM.

version

uint8_t dpp::interaction::version

read-only property, always 1