Skip to main content

Upgrading to 3.0 and above

The Helpshift v3.0 is a major update and has important UI/UX changes. If you have questions or feedback, please Contact Us

Upgrading from 3.x to 3.x+1

Skip 3.0 upgrade steps and navigate below to the new version heading.

What is new in 3.0?

  1. Optimized faster loading and syncing of messages.
  2. Better UI/UX resembling a Helpshift’s agent experience.
  3. Non-disruptive messages provide feedback on user actions.
  4. Fewer DMLs and SOQLs.
  5. Fewer API calls.
  6. Better logging to enable troubleshooting.

FAQs before the upgrade

  1. Will the upgrade affect our current flow? What if the new messenger doesn’t work? What if I find issues in the new admin panel/messenger?
    1. Your existing flows will not be impacted.
    2. There is no loss or change in data during the package upgrade.
    3. The old experience will be available too. If the new messenger or any admin functionality doesn’t work as per your expectations, or you do not like the new experience, you can switch back to the old experience. Please provide feedback to Helpshift Support on reasons to switch back.
  2. What are the recommended pre-upgrade steps?
    1. Sandbox testing - Install the 3.0 package on your sandbox.
      1. Test with your usual workflows and use cases before installing/upgrading on the production org.
      2. Ensure the sandbox is not linked to the Helpshift production domain. If that happens, the link with the Salesforce production environment will break and all the new cases will start flowing into the Salesforce sandbox.
      3. Get in touch with Helpshift Support to create a test domain for linking with the sandbox.
    2. Contact Helpshift Support to try the Beta version of an upcoming package on the sandbox.
      1. Do not directly install on production using the link even if it works fine on the sandbox.
      2. Use an incognito window to install using the link.
    3. Do not add both, the old and the new, messenger components on the same page in production.
      1. It will slow down the case record page on production.
      2. We recommend testing on the sandbox first with both messengers added. That will help you to 1. compare the newer experience with the old messenger. 2. get used to the new experience.

Upgrading the package

  1. Login to your Salesforce org which has the earlier package (eg. 2.19/2.11) installed.
  2. Open a new browser tab and paste the package URL. (Package URL would be available on app exchange post-release.)
  3. Once the page is loaded, a screen similar to the below would be seen
  4. The upgrade page would show the current version and the new version. In the above image, the current version is 2.19.
  5. Choose “Install for Admins only“ and the package will be installed in approximately 5-10 minutes.

After upgrading the package

  1. Things to check after upgrade *** IMP
    1. Verify whether the following picklist values are present in the Helpshift HelpshiftMessage_Typec field. This field can be found on the Helpshift Case Comment object from the object manager. [Add the new ones]
    bot_control_message
    text
    faq
    action_card
    csat_rating
    csat_comment
    resolution_rsp
    confirmation_rejected
    confirmation_accepted
    {" "}2. Check if Helpshift_Standard_Object has the new Apex classes permissions. If not, add them directly. ![](/static/books/salesforce/30-helpshift-standard-object-permission-set.png)``` Helpshift.AdminController Helpshift.AdminControllerTest Helpshift.AdminSettingController Helpshift.AdminSettingControllerTest Helpshift.FieldMappingController Helpshift.FieldMappingControllerTest Helpshift.LoggingService Helpshift.LoggingServiceTest Helpshift.MessengerController Helpshift.MessengerControllerTest Helpshift.StatusMappingController Helpshift.StatusMappingControllerTest Helpshift.TriggerUtility Helpshift.TriggerUtilityTest ```
  2. Helpshift Admin (LWC) tab is automatically included in the Helpshift app
  3. If Helpshift Admin (LWC) tab is not visible , please follow below steps
    1. Click on Setup icon (⚙️)
    2. Search for App Manager in search and click on it
    3. Search for Helpshift classic app and click on edit
    4. Add all the required Helpshift tabs as seen
    5. Click on Save as below
  4. Manually add the new Helpshift Messenger to the case record page. (Steps for this are described in the next section.)
  5. Click on the Helpshift Health Check tab and ensure there are no errors

Steps for adding new messenger

  1. Navigate to any Helpshift case record from the list view
  2. Click on the Gear icon (⚙️) and choose Edit Page
  3. Remove the old messenger component by clicking on the delete icon
  4. From the Components panel, drag the messenger component to the appropriate section(main, left, etc.) on the page
  5. Save the changes.
  6. New messenger is ready for use.

UX changes

Message send button renamed as 'Reply'

  • The message send button has become more intuitive using the button icon.

Outbound messages are left aligned

  • Messages sent by an agent would be left aligned as per common chat interfaces.

End Conversation button replaced with Resolve at the bottom of the messenger

  • Resolve button position similar to Helpshift agent dashboard.

Redaction settings moved to the bottom of messenger

  • Redaction operation made easy to use.

Send/Read receipts appearance change

  • Send/Read receipts similar to Helpshift messenger

Chatbox height increase and placeholder text change

  • Chatbox height is increased for accommodating longer messages. The height can be further increased by dragging the bottom right corner.

Dashboard URL field label change

Upgrading to 3.3

Tab highlighting can be enabled for Salesforce Console Apps like Service Console.

Step 1 (Add highlight tab component to utility)

  1. Navigate to Setup and search for App Manager.
  2. Search for the desired console app and click on edit as shown below :
  3. In the editor, click on Utility Items (Desktop Only) as shown below :
  4. Click on Add Utility Item and search for highlightTab :
  5. After choosing the highlightTab component, click on Save :

Step 2 (Add new dashboard to the app)

New Helpshift Dashboard is automatically included in the Helpshift App. If it’s not visible, please follow the below steps :

  1. Click on the Setup icon
  2. Search for App Manager in search and click on it
  3. Search for the Helpshift classic app and click on edit
  4. Add the New Dashboard tab as shown below :
  5. Click on Save below

Other functionalities with the new package

  1. Added Helpshift domain name on the Health Check Page
  2. On click of the Assign Permission button, you will be notified via email after the job completion