Pull Content with the Program Content RSS Feed

/*image outlines*/

With the Program Content RSS Feed you can pull the content from your program into platforms that are Atom-style RSS feed compatible, such as Feedly, Sharepoint, Salesforce, Jive, and more.

Note that the Program Content RSS Feed is not a standalone way to consume content. It is meant to be ingested via other tools which can handle RSS feeds. Refer to Important Details below for some limitations of the Program Content RSS Feed.

To embed content in webpages, refer to the Content Amplifier. The Content Amplifier is more customizable and has fewer restrictions than the Program Content RSS Feed.

To publish content to multiple programs within your organization, review the Cross Program Content Manager integration with your Engagement Manager.

Important Details

  • If you do not specify a channel ID in the RSS Feed URL, then the feed will default to My Feed. This means that when no channel ID is specified, you will only see content come through that was published to My Feed. See Step 5 below for more details.
  • The Content RSS Feed will not pull through video posts. For more detail, refer to the How to Handle Video Posts with Cross-Program RSS Feeds section below.
  • The Content RSS Feed will not pull through targeted content, ie content that has been published to targeted channels. The feed can only pull through "All Users" content.

Set Up a Program Content RSS Feed

  1. Obtain an API token from SocialChorus. Email support@socialchorus.com to request a token.
    • Example API token: AbCdE1f2g34H56iJ78kLM91N23oP45QR6s7T8uVWXyz
  2. Note the program ID for your program. You can find the program ID in the URL of your Studio URL:
    • URL Format:
      https://studio.socialchorus.com/programs/<program_id>/b2#content
    • URL Example:
      https://studio.socialchorus.com/programs/1234/b2#content
  3. Create the Program Content RSS Feed by filling in the program ID and API token in the following URL:
    • URL Format:
      https://studio.socialchorus.com/api/v1/programs/<program_id>/feed_items.xml?token=<api_token>
    • URL Example:
      https://studio.socialchorus.com/api/v1/programs/1234/feed_items.xml?token=AbCdE1f2g34H56iJ78kLM91N23oP45QR6s7T8uVWXyz
  4. You now have a URL that will pull content from My Feed. You can skip directly to step 7 or continue with optional steps 5-6.
  5. Optional: to pull content from a different channel than My Feed, specify a channel using the channel ID.
    • Only specify "public" channels (i.e. a channel targeted to "All Users"). If you specify a targeted channel, no content will come through.
    • Find the channel ID by visiting the employee experience. Open the specific channel via the Discover tab. The channel ID is at the end of the URL.
      • URL Format:
        https://onfirstup.com/[org name]/[program name]/channels/<channel_id>
      • URL Example:
        https://advocate.socialchorus.com/socialchorus/community/channels/9924
    • Create the Program Content RSS Feed with a specific channel ID by filling in the program ID, API token, and channel ID in the following URL:
      • URL Format:
        https://studio.socialchorus.com/api/v1/programs/<program_id>/feed_items.xml?token=<api_token>&channel_id=<channel_id>
      • Example URL:
        https://studio.socialchorus.com/api/v1/programs/1234/feed_items.xml?token=AbCdE1f2g34H56iJ78kLM91N23oP45QR6s7T8uVWXyz&channel_id=9924
  6. Optional: specify the type (source or program).
    • URL Format:
      https://studio.socialchorus.com/api/v1/programs/<program_id>/feed_items.xml?token=<api_token>&channel_id=<channel_id>&type=<source or program>
    • URL Example:
      https://studio.socialchorus.com/api/v1/programs/1234/feed_items.xml?token=AbCdE1f2g34H56iJ78kLM91N23oP45QR6s7T8uVWXyz&channel_id=9924&type=source 
  7. You now have a URL that will pull content from My Feed (or other channel if you specified a different channel). This URL can be added to any platform or tool that can pull in Atom-style RSS feeds.
    • For more information about setting up an incoming RSS Feed in a SocialChorus program, refer to Feeds Overview.

Parameter Definitions

The format of a Program Content RSS Feed with all parameters included:

https://studio.socialchorus.com/api/v1/programs/<program_id>/feed_items.xml?token=<api_token>&channel_id=<channel_id>&type=<source or program>

The URL fields and parameters defined:

  • program_id (required): ID of the SocialChorus program to pull content from. This ID appears in the Studio URL of the program such as studio.socialchorus.com/programs/<program_id>
  • api_token (required): Program access token to provide both authentication and authorization. Can be generated at studio.socialchorus.com/programs/<program_id>#setup/api-tokens
  • channel_id (optional): By default, the feed will pull from My Feed. Optionally, a different single content channel can be specified using the channel ID. 
  • type (optional): this parameter controls the behavior of the content (link back to the program, or link directly to the original source):
    • type=program - all posts in the feed link back to the program they originated from. This type of feed should be used when integrating a program's feed into an external system, like Sharepoint or an Intranet. 
    • type=source - posts link back to their original source. In the case of shareable content, posts link back to external sites, e.g. nytimes.com. For internal content, the feed includes the HTML content of the posts, which can be displayed in-app. This is good for internal, program-to-program integration where we don't want to direct users to the original program.

Output Examples

You can plug a Program Content RSS Feed from your program into another program, so that content from Program A appears in Program B. Please note, video cards cannot be passed through RSS Feeds.

To create a cross-program RSS Feed, follow the instructions above to create a Program Content RSS Feed for Program A, then plug the RSS Feed into Program B as outlined in Create a New Feed.

Alternatively, plug the Program Content RSS Feed into another website that takes RSS Feed input, such as Feedly:

How to Handle Video Posts with Cross-Program RSS Feeds

RSS Feeds are not compatible with Video cards. If using an RSS Feed to pull content from a SocialChorus program into another website or across programs, the video posts will not come through.

If you have an RSS Feed that pulls content from a SocialChorus program into another SocialChorus program, your videos will only publish across all linked programs if the video is embedded in an Article Card or published as a Link Card. This applies to using an RSS Feed to pull SocialChorus program content into a company website, or if your Organization contains multiple programs and your programs are currently configured to use cross-program RSS Feeds to publish content across multiple programs.

Comments

0 comments

Article is closed for comments.