Foobara::DiscordApi

This Ruby gem provides an easy way to use the Discord API via Foobara commands.

Typical stuff: add gem foobara-discord-api to your Gemfile or .gemspec file. Or even just gem install foobara-discord-api if just playing with it directly.

To run CreateMessage, you'll need a Discord bot/Discord API token and a channel ID.

1. Go to theDiscord developer portal.
2. Discord will ask you to log in or create an account.
3. You need to create a new application.
4. Choose the option "build a bot for your sever...".
5. Enter the app name and press create.
6. in the Token section, you need to press Reset token to generate a new token.
7. Your Discord bot is ready!.

1. In Discord developer portal go to your app.
2. Go to Installation.
3. Under Guild install, add bot to your scopes and select the permissions your bot needs.
4. Save the changes.
5. copy the install link and enter the URL in your browser. Then, select the server you want to add the bot to.
6. Done! Your bot is now added to your server.

1. First, go to the Discord server where your bot has the permissions.
2. Right click on the channel.
3. you will see the Copy channel ID option, check it.
4. Done! You now have everything you need.

Require the gem and run the command with the destination channel ID and the message content:

require "foobara/discord_api"

outcome = Foobara::DiscordApi::CreateMessage.run(
  channel_id: "some-channel-id",
  api_token: "some-api-token",
  content: "Hello, Discord!"
)

if outcome.success?
  message = outcome.result
  puts "Created message #{message.id} in channel #{message.channel_id}"
else
  puts outcome.errors_hash
end

The api_token input can be omitted and defaults to ENV["DISCORD_API_TOKEN"].

Bug reports and pull requests are welcome on Github at https://github.com/foobara/discord-api

To work on an existing issue or submit a PR:

1. Fork the foobara/discord-api repository and clone it to your local machine.
2. Run bundle install to install any dependencies.
3. Run rake to ensure that everything works as expected before making any changes.
4. Implement your changes.
5. Re-run rake to ensure that all tests and RuboCop still pass.
6. Commit, push to GitHub and open a PR for review.

If you need help using or contributing to this gem, find us on Discord at https://discord.gg/dDpdFAeCHB and ask away!

This project is licensed under the MPL-2.0 license. Please see LICENSE.txt for more info.