RSS Feed Importer
Automatically import content from an RSS feed and convert it into audio.
This guide explains how to use our RSS Feed Importer. This allows you to automatically import content from an RSS feed into BeyondWords and convert it into audio. You can then automatically embed audio versions into their source pages.
You can use a single RSS feed for a whole website or a single RSS feed for each section of a website. RSS integration is faster than integrating with our API as it doesn't require any development on your side, other than structuring the RSS feed.
The BeyondWords RSS Feed Importer can be adapted to accommodate any RSS structure. However, we suggest including specific RSS elements in the
<item> structure to ensure the best outcome.Please include the following elements in each RSS feed
<item>:<author>This is the author of the article. This element will be stored as metadata.
<guid>This is the globally unique identifier. The JavaScript player can use this to match audio assets in your BeyondWords project with articles in your RSS feed. This allows the audio version to be automatically embedded alongside the text version.
<title><description><link>This is the article URL. The Player code can use this to match match audio assets in your BeyondWords project with articles in your RSS feed. This allows the audio version to be automatically embedded alongside the text version.
<pubDate>This is the publish date. If pubDate is updated — for example, when you edit the source article — BeyondWords will automatically reprocess the audio.
<enclosure>This refers to multimedia content such as images. These elements will not be processed into audio.
<content>Plain text is sufficient, but we recommend that the
<title> and <content> elements use HTML. This is because HTML provides additional context that enables better conversion into speech synthesis markup language (SSML) and therefore better conversion into audio. We also recommend using HTML for the <description> element.This content should ideally be in a CDATA section and include HTML:
<content><![CDATA[<p>The first paragraph text</p><p>Second paragraph text.</p>]]></content>
Or escape the contained HTML:
<content><p><p>The first paragraph text.</p><p>Second paragraph text.</p><p></content>
An
<item> that uses CDATA for the <title>, <description>, and <content> elements should look like this:<item>
<author>author</author>
<guid>id</guid>
<title><![CDATA[This is the article title]]></title>
<description><![CDATA[This is the article description]]></description>
<link>article_url</link>
<pubDate>Thu, 01 Oct 2020 16:50:02 +0200</pubDate>
<enclosure url="image.jpg" length="0" type="image/jpg" />
<content><![CDATA[<p>This is paragraph one</p><p>This is paragraph 2</p><p>etc</p><div class="related_articles"></div>]]></content>
</item>
- 1.
- 2.
- 3.Go to the 'Content' section then select 'RSS Feed Importer' under 'Connect your CMS' (already created audio? You will need to navigate to 'Settings (Integration)' instead)
- 4.If you want, change the default voices for titles and body content, making sure to save your changes (please note that this will also change the default voices for the TTS Editor)
- 5.Copy and paste your RSS feed URL into the corresponding field, then select 'Test' — you should get a 'Success' message
- 6.Make sure the toggle underneath is switched to 'Enabled'
- 7.Select 'Save changes'
Optional:
- Enable 'Pending review' in 'Settings (General) if you would like to review your audio before it is embedded.
- Add custom text-to-speech rules. You can add aliases in 'Settings (Aliases)' or request more complex rules from our text-to-speech team.
BeyondWords will now import content from your RSS feed and convert it into audio, using characters. Processing usually takes a few minutes — you can check the status of your audio in the 'Content (Audios)' section of your project dashboard.
Last modified 3mo ago