You will need to install the BeyondWords Player separately.

​
Overview

The RSS Feed Importer allows you to automatically convert articles from your RSS feeds into audio. Once enabled, BeyondWords will regularly check your feeds for new content and generate audio for each new article.

​
Add a new feed

To get started go to Project > Settings > Integrations > RSS Feed Importer.

1

Click + Feed

Click the + Feed button.

2

Select Feed type

Select the type of feed you want to add. You can choose between XML and JSON.

3

Add Feed URL

Enter the URL of your RSS feed.

4

Set request headers (optional)

For paywalled or protected content, you may need to provide authentication headers.

  • Add a Header Name and Header Value to authenticate requests.
  • Click + to add multiple headers if needed.
5

Enable Static IP (optional)

If your website requires IP allowlisting, enable this option to use a static IP for content extraction.

6

Enable page extraction (optional)

If your RSS feed only contains article links and not the full text, BeyondWords can fetch the content from article URLs.

  • Page extractor headers (optional): Use request headers or a static IP to allow BeyondWords to extract content from protected or paywalled articles. If your site requires authentication, add a request header with the required key and value.

​
Map the feed

After adding your feed, you’ll need to map the RSS feed fields to BeyondWords article properties. This ensures the correct information - such as titles, descriptions, and content - is used to generate audio.

1

Required fields

Map these required fields from your feed:

  • Title: Select the field containing the article title
  • Body: Select the field containing the article content
  • Source ID: Select the field containing a unique identifier for each article (usually corresponds to your article ID in your CMS). This ID can be used to easily embed the audio on your articles using the BeyondWords Player.
  • Source URL: Select the field containing the URL for each article. This URL can also be used to easily embed the audio on your articles using the BeyondWords Player.
2

Optional fields

You can also map these optional fields:

  • Summary: Select the field containing a summary of the article. You can leave this empty if you use BeyondWords summarization.
  • Author: Select the field containing the article author’s name
  • Image URL: Select the field containing the URL of the article’s featured image
  • Metadata: Select the field containing additional metadata about the article
  • Publish date: Select the field containing when the article was published

    The publish date is used to check for updates to articles. When BeyondWords detects a change in the publish date, it will update the audio for that article.

3

Save and activate

Click Save changes to complete the setup. Your feed will automatically be enabled and BeyondWords will begin checking for articles.

​
Managing your feed

Once your feed is set up:

  • BeyondWords will automatically check your feed every 10 minutes for new or updated articles
  • You can manually trigger an import by clicking the ⋯ button next to your feed and selecting Run
  • New articles will be processed and converted to audio automatically
  • Updated articles (detected by changes in the publish date) will have their audio updated

​
Embed the Player

You can embed the audio on your website using either the Source ID or Source URL you mapped during setup.

Embed the BeyondWords Player

Once your content is imported and converted to audio, learn how to embed the BeyondWords Player on your website to deliver a seamless audio experience to your audience.

Previous
Ghost
Next