feat(#404): implement basic webex functionality to shoutrrr

[surdaft]

Implements a basic version of webex, future plans to add cards as well, but for now this satisfies webex being available.

closes #404 (heh, 404)

[piksel]

This looks really well done. Good job!

My suggestion would be to pass the roomId as a query parameter instead to allow for sending to multiple rooms. It would require the hostname to be a static string (which is generally just ignored by other services that have this problem).

Also, even though it's very simple, add the macro for including auto-generated docs so that the docs align with the other services. It's the scissor-looking thing at the bottom of the other services markdown files.

[surdaft]

Thanks very much! Query param for roomID, fair enough I will take a poke. Do you have an example other service?

Ooh I see, I wondered what that was for. Thanks for the clarification, I will add the scissors when I have a moment. :)

[piksel]

Sure, the telegram service is similar and loops over its targets (chats) when sending:

shoutrrr/pkg/services/telegram/telegram.go

Line 25 in 52149dc

func (service *Service) Send(message string, params *types.Params) error {

It's configured using the key tag (the second arg channels is an alias for backwards compatibility):

shoutrrr/pkg/services/telegram/telegram_config.go

Line 19 in 52149dc

Chats []string `key:"chats,channels" desc:"Chat IDs or Channel names (using @channel-name)"`

Even if you only support a single room for now, using a query variable allows for adding support for multiple ones in the future without breaking compatibility. It also aligns it better with the other services. Thanks for taking the time!

[surdaft]

• I have updated to provide a rooms query parameter, which is comma separated like telegram.
• I also tweaked the docs page to better reference how the discord and telegram docs show the URL structure, it was slightly different. I don't remember where I copied it from. 😅
• Snippers added

[surdaft]

Just a whee nudge 😄

Also quick Q: How long would it be before we can expect watchtower and shepard to update with the new version?