✨ Add webhook support to Messages (Fixes #52)

[Log1x]

This adds a ->webhook() method that will send messages in a channel through a webhook to allow for further customization such as username & avatar.

It can be used in two ways:

When passing no argument, Laracord will attempt to create a webhook in the destination channel with the same name as the bot. It will then re-use that webhook when sending webhook messages in that channel in the future:

$this
    ->message()
    ->username('Example')
    ->avatar('https://example.com/avatar.png')
    ->content('Hello world!')
    ->webhook()
    ->send($channel);

The second way would be to pass a webhook URL of which already exists for the destination channel:

$this
    ->message()
    ->username('Example')
    ->avatar('https://example.com/avatar.png')
    ->content('Hello world!')
    ->webhook('https://discord.com/api/webhooks/...')
    ->send($channel);

This will attempt to retrieve the Webhook part from DiscordPHP's WebhookRepository using the URL and then send the message using the webhook.

A future improvement might be to allow sending directly to any webhook URL instead of using DiscordPHP (or the bot).

Change log

Enhancements

• ✨ Add webhook support to Messages (Fixes 🧑‍💻 Request for Channel Webhook Integration #52)
• 🧑‍💻 Add a clearAuthor() method to clear the default Message embed author/icon
• 🧑‍💻 Add an avatar() method that aliases avatarUrl() for improved DX

[marky291]

Is there a way to retrieve the created webhook ID so that it can be saved and reused from a data storage or will this guarantee to persist its created webhook even if restarted?

[Log1x]

at the moment, it names the created webhook the same name as the bot its self to easily identify/re-use it in the future.

[Log1x]

could also have it add the bot's user ID or something to ensure the identifier is unique, but it'd get a little awkward if it were to be used without specifying a username (despite Laracord doing that for you by default).