How can we help you?

Using JS SDK for SSO

Swathy R
March 27, 2023

The JS SDK was designed to help customers on your application submit feedback on your Hellonext 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.

  1. Link Hellonext on your application

Add your Hellonext 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.

  1. Install the SDK

The SDK helps us identify your customers when they navigate from your application to Hellonext. Any posts, comments or votes made by your customer will now be tied to their Hellonext 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.

  1. Configure the SDK

Your SDK will look something like this,

<script src="https://feedback.hellonext.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>

The SDK passes the following user identification over to Hellonext, 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 Hellonext, 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 Hellonext account for you to organize and manage feedback easily.