SDK Configuration

Helpshift provides several config options which can be used to customize behaviour of the SDK.

Install time configurations

enableLogging

Upon setting enableLogging to true, Helpshift SDK logs will be generated in the Xcode console. Turning on logging can help developers resolve common integration issues.

Flag
HelpshiftSdk.ENABLE_LOGGING
Values
true/false
Default
false
using Helpshift;
// other imports

public class MyGameControl : MonoBehaviour
{
    private HelpshiftSdk help;

    void Awake(){
      this.help = HelpshiftSdk.GetInstance();
      Dictionary<string, object> configMap = new Dictionary<string, object>();
      configMap.Add(HelpshiftSdk.ENABLE_LOGGING, true);
      help.Install(platformId, domainName, configMap);
    }
}

enableInAppNotification

If you do not want the in-app notifications support provided by the Helpshift SDK, set this flag to false.

Flag
HelpshiftSdk.ENABLE_INAPP_NOTIFICATION
Values
true/false
Default
true
using Helpshift;
// other imports

public class MyGameControl : MonoBehaviour
{
    private HelpshiftSdk help;

    void Awake(){
      this.help = HelpshiftSdk.GetInstance();
      Dictionary<string, object> configMap = new Dictionary<string, object>();
      configMap.Add(HelpshiftSdk.ENABLE_INAPP_NOTIFICATION, true);
      help.Install(platformId, domainName, configMap);
    }
}

inAppNotificationAppearance

Customization of the appearance of in-app notification using the flag inAppNotificationAppearance. This config represents the appearance of the in-app notification in the SDK. When the agent/bot sends a message and the user is using the app, an in-app banner is shown and the appearance of that banner can be customized using this dictionary

Flag
HelpshiftSdk.INAPP_NOTIFICATION_APPEARANCE
Sub-Options:
bannerBackgroundColor / textColor

bannerBackgroundColor

The bannerBackgroundColor represents the background color of the banner of the in-app notification. The value for this key should be a 6-characters string representing the HEX value of the color.

textColor

The textColor represents the text color of the text shown in the in-app notification. The value for this key should be a 6-characters string representing the HEX value of the color

using Helpshift;
// other imports

public class MyGameControl : MonoBehaviour
{
    private HelpshiftSdk help;

    void Awake(){
      this.help = HelpshiftSdk.GetInstance();
      Dictionary<string, object> configMap = new Dictionary<string, object>();
      Dictionary<string, object> inAppNotificationAppearance = new Dictionary<string, object>();
      inAppNotificationAppearance.Add(HelpshiftSdk.INAPP_NOTIFICATION_BANNER_BACKGROUND_COLOR, "000000");
      inAppNotificationAppearance.Add(HelpshiftSdk.INAPP_NOTIFICATION_BANNER_TEXT_COLOR, "FFFFFF");

      configMap.Add(HelpshiftSdk.INAPP_NOTIFICATION_APPEARANCE, inAppNotificationAppearance);
      help.Install(platformId, domainName, configMap);
    }
}

Full privacy

In the config dictionary of help.ShowConversation(config); API at the time of calling this API, setting the fullPrivacy option to true ensures COPPA compliance by:

  1. Disabling user-initiated screenshots (users will not be able to attach files, including images, using SDK).
  2. Making sure that Personally Identifiable Information (PII) such as name and email are not collected by SDK (using Identity Bot and/or the helpshiftConfig object). This means that if you set userName and userEmail, with fullPrivacy set to true, Helpshift will not use the userName and userEmail values.

Moreover, in scenarios where the user attaches objectionable content, it becomes a huge COPPA compliance concern. This option helps to solve this problem.

For example

using Helpshift;
// other imports

public class MyGameControl : MonoBehaviour
{
    private HelpshiftSdk help;
    void Awake(){
      this.help = HelpshiftSdk.GetInstance();
      // install call here
    }
    void OpenHelpshift(){
      Dictionary<string, object> configMap = new Dictionary<string, object>();
      configMap.Add("fullPrivacy", "true");
      help.ShowConversation(configMap);
    }
}

UI Configurations

This config represents the theming of Helpshift SDK. For more information check design.

Tracking

This config represents the tracking user actions. For more information check tracking.