Sending private messages

Sometimes it's simply not enough to ping someone in a server with a message, and we get that. That's why you can private message people! This tutorial will cover how to make a command that will either message the author of the command or message a specified user!

Note

This tutorial makes use of callbacks. For more information about that, visit Using Callback Functions.

#include <dpp/dpp.h>
 
int main() {
    /* Create the bot */
    dpp::cluster bot("token");
 
    bot.on_log(dpp::utility::cout_logger());
 
    /* The event is fired when someone issues your commands */
    bot.on_slashcommand([&bot](const dpp::slashcommand_t & event) {
        /* Check which command they ran */
        if (event.command.get_command_name() == "pm") {
            dpp::snowflake user;
 
            /* If there was no specified user, we set the "user" variable to the command author (issuing user). */
            if (event.get_parameter("user").index() == 0) {
                user = event.command.get_issuing_user().id;
            } else { /* Otherwise, we set it to the specified user! */
                user = std::get<dpp::snowflake>(event.get_parameter("user"));
            }
 
            /* Send a message to the user set above. */
            bot.direct_message_create(user, dpp::message("Here's a private message!"), [event, user](const dpp::confirmation_callback_t& callback){
                /* If the callback errors, we want to send a message telling the author that something went wrong. */
                if (callback.is_error()) {
                    /* Here, we want the error message to be different if the user we're trying to send a message to is the command author. */
                    if (user == event.command.get_issuing_user().id) {
                        event.reply(dpp::message("I couldn't send you a message.").set_flags(dpp::m_ephemeral));
                    } else {
                        event.reply(dpp::message("I couldn't send a message to that user. Please check that is a valid user!").set_flags(dpp::m_ephemeral));
                    }
 
                    return;
                }
 
                /* We do the same here, so the message is different if it's to the command author or if it's to a specified user. */
                if (user == event.command.get_issuing_user().id) {
                    event.reply(dpp::message("I've sent you a private message.").set_flags(dpp::m_ephemeral));
                } else {
                    event.reply(dpp::message("I've sent a message to that user.").set_flags(dpp::m_ephemeral));
                }
            });
        }
    });
 
    bot.on_ready([&bot](const dpp::ready_t& event) {
        if (dpp::run_once<struct register_bot_commands>()) {
            /* Register the command */
            dpp::slashcommand command("pm", "Send a private message.", bot.me.id);
 
            /* Add the option for a user mention that isn't required */
            command.add_option(dpp::command_option(dpp::co_mentionable, "user", "The user to message", false));
 
            /* Register the command */
            bot.global_command_create(command);
        }
    });
 
    bot.start(dpp::st_wait);
 
    return 0;
}

That's it! Now, you should have something like this: