Microapps

Integrate SocialChorus

Deploy the SocialChorus Integration to communicate important announcements from management and share the content, such as articles, links and notes, between employees through different channels. No images or media are displayed.

Users can view the past seven days of content that is posted in recommended channels. Using appropriate selections, users can view all featured content posted in various channels. Users can also view all content posted in their followed channels that have been posted in the past five days. All details relating to the content (such as title, summary, body, and published date) is shown on individual pages. Posted content can be viewed in a test instance with the click of a button.

A user assigned with the Program Manager role in SocialChorus marks channels as recommended or sets an article as featured using the SocialChorus Manage Channel UI. For example, these communication channels might be from senior management, or featured articles of interest to a user group or all users.

Note:

We want your feedback! Please provide feedback for this integration template as you use it. For any issues, our team will also monitor our dedicated forum on a daily basis.

For comprehensive details about our SocialChorus microapps, see Use SocialChorus microapps.

Review prerequisites

You will need these artifacts to add the integration in Citrix Workspace Microapps:

  • Base URL: https://partner.socialchorus.com/
  • Token URL: https://auth.socialchorus.com/oauth/token
  • Client ID: The Client ID is the string representing client registration information unique to the authorization server. Contact your Social Chorus account representative for the Client ID and Client Secret.
  • Client Secret: The client secret is a unique string issued when setting up the target application integration.

This integration requires regular access to your SocialChorus instance, so we recommend creating a dedicated user account. This service account must have full administrator privileges and permissions.

Note:

It is recommended that you always use OAuth 2.0 as your service authentication method where available. OAuth 2.0 ensures that your integration meets the maximum security compliance with your configured microapp.

Enable APIs

SocialChorus APIs are enabled via webservices for a paid account by default. This may require a separate agreement with the vendor. The number of API requests that can be made to specific resources is limited. We recommend reviewing SocialChorus API guidance: SocialChorus API Guidance.

Add the integration to Citrix Workspace Microapps

Add the SocialChorus integration to Citrix Workspace Microapps to connect to your application. The authentication options are preselected. Ensure that these options are selected as you complete the process. This delivers out-of-the-box microapps with pre-configured notifications and actions which are ready to use within your Workspace.

Follow these steps:

  1. From the Microapp Integrations page, select Add New Integration, and Add a new integration from Citrix-provided templates.
  2. Choose the SocialChorus tile.
  3. Enter an Integration name for the integration.
  4. Enter Connector parameters.

    • Enter the instance Base URL: https://partner.socialchorus.com/
    • Select an Icon for the integration from the Icon Library, or leave this as the default icon.

    SocialChorus config 1

  5. Under Service authentication, select OAuth 2.0 from the Authentication method menu and complete the authentication details. The authentication options are preselected. Ensure that these options are selected as you complete the process. Use the OAuth 2.0 security protocol to generate request/authorization tokens for delegated access. It is recommended that you always use OAuth 2.0 as your service authentication method where available. OAuth 2.0 ensures that your integration meets the maximum security compliance with your configured microapp.

    1. Select Client Credentials from the Grant type flow menu.
    2. client_credentials is entered for Grant type value.
    3. Select Authorization header from the Token authorization menu.
    4. Select URL encoded form from the Token content type menu.
    5. Enter the Token URL: https://auth.socialchorus.com/oauth/token
    6. Enter your Client ID. The client ID is the string representing client registration information unique to the authorization server. You collect this and the secret when you configure the OAuth server.
    7. Enter your Client secret. The client secret is a unique string issued when setting up the target application integration.

    SocialChorus config 2

  6. Leave Access token parameters empty.
  7. Enable the Enable request rate limiting toggle. Enter 1000 for Number of requests and 1 minute for Time interval.
  8. In the Request Timeout field, enter 120.
  9. (Optional) Enable Logging toggle to keep 24 hours of logging for support purposes.
  10. Select Save to proceed.

    SocialChorus config 3

The Microapp Integrations page opens with your added integration and its microapps. From here you can add another integration, continue setting up your out-of-the-box microapps, or create a new microapp for this integration.

You are now ready to set and run your first data synchronization. As a large quantity of data can be pulled from your integrated application to the Microapps platform, we recommend you use the Table page to filter entities for your first data synchronization to speed up synchronization. For more information, see Verify needed entities. For complete information about synchronization rules, synchronization that does not meet its schedule and veto rules, see Synchronize data.

For more details of API endpoints and table entities, see SocialChorus connector specifications.

Use SocialChorus microapps

Existing application integrations come with out-of-the-box microapps. Start with these microapps and customize them for your needs. Our SocialChorus integration comes with the two following preconfigured out-of-the-box microapps. Both of these microapps retrieve content for the last 7 days:

Important Communications: Search and view important communications from recommended channels that are posted within the last 7 days.

Notification or Page Use-case workflows
Change In Recommended Channel (Featured) notification All subscribers receive a notification when there is a change in featured content tile, summary, body, or featured label under recommended channels. Notification expires 7 days from the created date.
Change In Recommended Channel (Non-Featured) notification All subscribers receive a notification when there is a change in non-featured content tile, summary, or body under recommended channels. Notification expires 7 days from the created date.
New Recommended Article (Featured) notification All subscribers receive a notification when a new featured article is posted in recommended type channels. Notification expires 7 days from the created date.
New Recommended Article (Non-Featured) notification All subscribers receive a notification when a new non-featured article is posted in recommended type channels. Notification expires 7 days from the created date.
View Content page Provides a complete list of articles posted in recommended channels within the last 7 days.
Content Detail page Provides a form to view articles in detail with a Read In The Blog option to open the article in SocialChorus.

Latest Articles: Search and view content from subscribed channels that has been posted within the last 7 days.

Notification or Page Use-case workflows
View Content page Provides a complete list of articles posted in subscribed channels within the last 7 days.
Content Detail page Provides a form to view articles in detail with a Read In The Blog option to open the article in SocialChorus.

Featured Content: Get recently featured communications from the subscribed channels with this microapp. Users can search, view images, and read content from Citrix Workspace.

Notification or Page Use-case workflows
View Contents page Provides a table with all the featured content where a user can view the content from all subscribed channels. Users can sort the table according to author and channel name.
Content Detail page View all details pertaining to the selected content in this page including title, content summary, published date, and author. User can also read the content in SocialChorus instance by selecting Read In The Blog.
Integrate SocialChorus