Getting Started

Automated Integration using Cocoapods

To start using Helpshift v2.4.1 in your project, add the following line to your Podfile.

pod 'HelpshiftMacOS', '2.4.1'

And run pod install or pod update to refresh your cocoapods dependencies.

You can now move on to Initializing Helpshift in your App.

Integration

Get the latest SDK zip

Download the latest zip for the Helpshift macOS SDK.

Download SDK v2.4.1

The zip file contains

Add the latest SDK release to your project

• Unzip the downloaded file and add HelpshiftOSX.framework into your Xcode project.
• In your target's General setting tab, make sure HelpshiftOSX.framework is shown under Embedded Binaries. If its not present, click the + button below and select the framework.
• Add the HelpshiftConfig.plist and HelpshiftConfigDark.plist files into your project.

Helpshift is now ready to help you have conversations with your users! Head over to Initializing Helpshift in your App.

Requirements

• Xcode 10 and above.

Supported macOS versions

Helpshift SDK supports following versions of macOS :

• 10.14
• 10.13
• 10.12
• 10.11
• 10.10

Start using Helpshift

Helpshift is now integrated in your app and ready to collect meaningful data about your users.

Initializing Helpshift in your app

Helpshift uniquely identifies each registered App using a combination of 3 tokens:

You can find these tokens by navigating to Settings>SDK (for Developers) in your agent dashboard. Select your App and the correct platform from the dropdowns and copy the 3 tokens to be passed when initializing Helpshift. show me

Initialize Helpshift by calling the HelpshiftCore's install function:

1. Initialize the HelpshiftCore with the Helpshift Support service.
2. Call the HelpshiftCore's install function.

Currently helpshift only supports HelpshiftSupport as the available service on macOS.

#import <HelpshiftOSX/HelpshiftOSX.h>

...

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification
{
    ...

    [HelpshiftCore initializeWithProvider:[HelpshiftSupport sharedInstance]];
    [HelpshiftCore installForApiKey:@"YOUR_API_KEY"
                     domainName:@"YOUR_HELPSHIFT_DOMAIN"
                          appID:@"YOUR_APP_ID"];
    ...
}

Support APIs

If you want to add support sections inside your app with Helpshift, you can use the HelpshiftSupport APIs.

For example:

[HelpshiftSupport showConversationWithOptions:nil];