Generic webhook

A generic webhook is a simple HTTP access point using POST.

Format

By default, the article is sent as a JSON with the following format:

{
  "title": "The title",
  "text": "Text content (the summary)",
  "html": "HTML content",
  "url": "origin URL of the article",
  "image": "URL of the article illustration",
  "published_at": "article publication date"
}

It is possible to personalize the content sent.

You can specify its type:

  • JSON
  • HTML
  • or Text

And you can specify its format using the Golang templates syntax.

To make it simple, you can access the JSON document properties above but prefix them with a dot and a capital letter between two brackets. For example, the title property can be accessed with the {{.Title}} syntax.

Kinematics

To add a generic webhook, you mustconfigure your outgoing webhook:

Click on the Add button to add an outgoing webhook. The outgoing webhook creation page opens:

  1. Enter an alias
  2. Choose generic as provider
  3. Configure the webhook URL
  4. Click on the checkbox if you want to make it your default service

Once configured, you will see a new entry in the context menu of the article:

You can now send an article to a HTTP endpoint.