Outbound Support
With outbound support, you can proactively engage with consumers to solve problems within the app. Read more about the feature here.
All the public APIs in the SDK should be called after initializing the SDK via Init API
The steps to use this feature are the following -
To generate the link for outbound support, on your Helpshift dashboard, go to Settings > Workflows > Outbound Support.
You should see a Create link button. Click on the Create link button and select an action like Chat, Help Center, Single FAQ or FAQ Section and other data like CIFs, Tags, First User Message you want to send as payload to Helpshift SDK.
At last, you will get a URL encoded payload link. Send this link to your end-users embedded in a notification payload using your existing Push notification system.
YOUR_APP_IDENTIFIER: Can be any unique string that identifies your app. For example, like the scheme you would use in deep link URLs for your app like myApp , myAppSupport, etc.
Local API config
You may want to add configuration specific to the current user in your app when they click on the notification.
Setting local API config enables the Helpshift SDK to merge configuration from both, the config embedded in the outbound support link (as mentioned in previous steps) and the local config provided at runtime when the end user clicks on the notification.
This local API config is exactly same as we would expect in other APIs like
HelpshiftLibrary::ShowConversation()
orHelpshiftLibrary::ShowFAQs()
.We will use this configuration for current issue as well as next issue filed in same session.
Sending the generated link to device
Send push notification to the users you want to give proactive support using your app's existing push notification system. Embed the outbound support link in the notification payload.
In your app, handle this notification such that when a user opens the app through the notification, you read the notification payload and pass this proactive link (as a simple string) to Helpshift SDK via
HelpshiftLibrary::HandleProactiveLink()
function.We will read the data from the link you provided and open Helpshift support with the configurations you provided while generating the link from the dashboard.
Example Blueprint
Below is an example blueprint. For demo purposes the example calls Handle Proactive Link
function on a button click. Ideally, this should be handled as a part of a notification click from the user.