# Services documentation

On this page, you will find documentation related to some of the services registered as receiving nodes on the bus.

# Slack Notifier Service

The Slack Notifier service can be used to be notified on Slack when events are received by the bus. It can also be used specifically to send messages to Slack. You can choose the Slack workspace, channel and content of the message.

# Events

The Slack Notifier Service can process any events, provided that they contain a SlackMessage payload. The payload requirements and an example can be found on this spreadsheet (opens new window).

If the sole purpose of your event is to send a message to Slack, you can name it SendSlackMessage. Those events don't require any bus setup thanks to destinations inherited from the Global venture config, i.e. you can skip the section below.

# Bus setup

  • Add the Slack Notifier service receiving node as a destination.
  • List the events for which you want to be notified on Slack.

# Data Lake

The Data Lake service allows to store any events in the data lake.
If you are sending article events, you can use the Data Lake for Media and Blog Articles service so that they are staged to be immediately queryable. It also triggers specific processes for the CDE (Content Distribution Engine).

# Events

The Data Lake service can receive any events. The Data Lake for Media and Blog Articles service is configured to handle ArticleCreated, ArticleUpdated, ArticleDeleted events only.
Payload requirements and examples for these events can be found on this spreadsheet (opens new window).

# Bus setup

  • Add the Data Lake or Data Lake for Media and Blog Articles receiving node as a destination.
  • Contact the person listed in "Contact details" to ask for an auth token. Indicate if you intend to use the CDE, so that they can create a mapping entry. They will need your node id, which you can find at the top of the Details and Settings page.
  • List the events that you want to store in the data lake.
  • Select the Auth type Api-Token. Enter the name x-api-key and the value that has been provided to you.

# Sailthru Publishing service

The Sailthru Publishing service is made for media and blogs to sync articles to Sailthru content library. It can also be used by any business to subscribe users to the Newsletter.

# Events

The service expects ArticleCreated, ArticleUpdated, ArticleDeleted, NewsletterSubscribed and NewsletterUnsubscribed events.
Payload requirements and examples for these events can be found on this spreadsheet (opens new window).

# Bus setup

  • Add the Sailthru Publishing service receiving node as a destination.
  • Contact the person listed in "Contact details" to ask for an auth token. They will need your node id, which you can find at the top of the Details and Settings page.
  • List the events that you want to route to the service and select the relevant endpoint for each.
  • Select the Auth type Api-Token. Enter the name Authorization. The value should be following the format Bearer x|xxxxxxxxxxxxxxxxxxxxxxxxxxxx.
  • In the Configuration data section, enter the list of cultures* that the service must process as well as the credentials of the Sailthru account to which the articles and users must be synced, following the example below:
{
  "cultures": [
    "en_GB"
  ],
  "sailthru": {
    "api_key": "...",
    "secret": "..."
  }
}

* the culture(s) must match one or more cultures provided in your Article events' payload, and be available for all required fields.
Example:

"title": [
    {
        "culture": "en_GB",
        "value": "Liverpool stars Mane and Salah on track for Africa final showdown"
    }
]

# Syncing service

The Syncing service is made for marketplaces to sync listings and leads between themselves, to sync listings to Sailthru content library or to notify Google about job listings using Google Indexing API (opens new window).

# Events

The service can process ListingCreated, ListingUpdated, ListingDeleted as well as ListingLeadCreated events.
Payload requirements for these events can be found on this spreadsheet (opens new window).

# Bus setup

  • Add the Syncing service receiving node as a destination.
  • Contact the person listed in "Contact details" to request an auth token. Provide him with your node id, which you can find at the top of the Details and Settings page, as well as what operations you would like the service to perform (e.g. sync listings to Sailthru content library).
  • List the events that you want to route to the service.
  • Select the Auth type Api-Token. Enter the name Authorization. The value should be following the format Bearer x|xxxxxxxxxxxxxxxxxxxxxxxxxxxx.
  • In the Configuration data section, enter the list of cultures* that the service must process and if you intend to sync listings to Sailthru content library, also provide the credentials of the Sailthru account following the example below:
{
  "cultures": [
    "en_GB"
  ],
  "sailthru": {
    "api_key": "...",
    "secret": "..."
  }
}

* the culture(s) must match one or more cultures provided in your Article events' payload, and be available for all required fields.
Example:

"title": [
    {
        "culture": "en_GB",
        "value": "Liverpool stars Mane and Salah on track for Africa final showdown"
    }
]