users cannot customize notification message's format

[bowenli86]

Details

I want to use the notification webhooks feature, but my webhook expects a specific format, like

{
   "msgtype": "text",
   "body" {
      ....
    }
}

Right now it seems I cannot do any customization

Expected Result

Allow users to customize notification message in the "notification" page

Actual Result

notification message is of fixed format

[humitos]

Hi @bowenli86! Thanks for opening this issue. Unfortunately, I don't think we will implement this. Sounds like a very user-specific request and you should be able to change the implementation on your end to accept and parse the format that RTD sends.

[bowenli86]

Hi @bowenli86! Thanks for opening this issue. Unfortunately, I don't think we will implement this. Sounds like a very user-specific request and you should be able to change the implementation on your end to accept and parse the format that RTD sends.

Hi @humitos I'm not sure if it's a too user-specific request. The use case is that many chatbot webhooks on messaging platforms require some specific formats for various reasons. The limitation means I cannot send notifications to our chat apps.

[humitos]

I understand. You will need to put something between the RTD and the chatbot to parse RTD's webhook and convert it as the format required by the chatbot.

[ericholscher]

Seems we could pretty easily allow customizable keys on the JSON, but that's definitely a product decision we need to think about.

[devamchakrabarty]

Since the homepage asks us to Think of it as Continuous Documentation, we genuinely hope this feature request can gain some importance.

We want to fit documentation as a step in our product's CI/CD pipeline. To do that, read the docs must at least allow the webhook JSON payload to be customisable. 🥺

The possibilities are literally endless!

[ericholscher]

Interesting example here: https://twitter.com/mariatta/status/1278038611338772480