Home
Using JS SDK for SSO

Using JS SDK for SSO

The JS SDK was designed to help customers on your application submit feedback on your featureOS page without having to login. This does not require any external SSO client to integrate.

Before you integrate the SDK, ensure that your application has an SSL certificate (https instead of http). Further, the SDK will not work on incognito browsers.

Add your featureOS page link anywhere that’s easy for your customers to find on your application, such as the header, footer or menu sidebar. Use a clear CTA to encourage customers to submit posts.

Install the SDK

The SDK helps us identify your customers when they navigate from your application to featureOS. Any posts, comments or votes made by your customer will now be tied to their featureOS account, without them having to log in.

Note that we will only identify customer accounts (those present in your “All Customers” page) to prevent malicious access.

Navigate to Organization Settings → Advanced → JS SDK, copy and paste the JS snippet onto your application.

Configure the SDK

Your SDK will look something like this,

<script src="https://feedback.featureOS.co/hellonext.js"></script>
<script>
    hellonext("init", {
      appId: "3972xxxxxxxxxxxxxxxx8831bf",
      domain: "feedback",
      user: {
        email: "[email protected]",
        name: "Swaathi Kakarla",
        custom_fields: {
          "City": "Chennai",
          "Favorite Food": "French Fries"
        }
      }
    })
</script>

How it works?

The SDK passes the following user identification over to featureOS, which will need to be configured for every authenticated user on your application,

  • Email Address

  • Name

  • Custom Attributes

If an email address does not exist on featureOS, we will create an account for that user with the email and name attribute. However, if the account already exists, we do not update the user’s name.

Custom attributes can be used to provide additional information such as the subscribed plan, region and more. You can pass any key-value data. This data will then be across your featureOS account for you to organize and manage feedback easily.

Need more help?

Reach out to our support at [email protected] or submit a request on our support board! 😃

Swathy

Swathy