About Contextual Help for the Web Widget

Have more questions? Submit a request

35 Comments

  • Robert Koch
    Comment actions Permalink

    Does contextual help search tags too, or just words in the actual article?

     

    Chat lives on pages like this 

     

    https://live.taketheinterview.com/my_interview?code=3dcd3646deb02fbddd58dad1e1fd4969#login

     

    How can we get related articles to populate? Right now it is wrong. 

    2
  • Erica Wass
    Comment actions Permalink

    @robert Contextual Help uses the same search as your Help Center Knowledge Base. I've created a ticket for your question so we can look into your specifics with you. 

    0
  • Scott
    Comment actions Permalink

    We're seeking to embed the contextual help into our online app. We'd like to filter the results by the article's label and then by a language search within that label.

    Is that possible with the Widget API?  (If not... I'd like to offer that kind of two-tiered filter as a suggestion!)

    0
  • Erica Wass
    Comment actions Permalink

    Scott, the Web Widget automatically keys to the browser language so I expect that it would display articles of that language that use the label included in zE.setHelpCenterSuggestions. Is that not what you are finding?

    0
  • Sybil
    Comment actions Permalink

    I am having the same issue as mentioned here https://support.zendesk.com/hc/en-us/community/posts/218033707/comments/226504588 . When navigating between pages in an SPA, previous 'Top suggestions' stay in the widget until a later suggestion is found. This is a major problem for an SPA with many routes - I can't guarantee that all of them will find their own top suggestions, and if the old suggestions stay in the widget then that is simply confusing for end users.

    Is there any plan to either automatically clear the top suggestions when calling setHelpCenterSuggestions , or to offer a 'resetSuggestions' function? I'd really like to avoid having to roll our own widget using the apis! 

     

     

    0
  • Nicole - Community Manager
    Comment actions Permalink

    Hey Sybil - 

    Welcome to the Zendesk Community! 

    I've taken a look at the ticket that was created for Dave, and it seems that in his case it was an issue within the way his app was coded. Because it's such a one-off problem, I'm going to go ahead and create a ticket for you so that our support team can do the appropriate troubleshooting for you. Look for an email from me shortly. 

    0
  • Andrew Cohen
    Comment actions Permalink

    Can you use *wildcards in the URLs?  For example, if we have thousands of custom URLs like /study?deck_id=12345&pack_id=54321 , and we want a particular contextual Help message to show up on ALL pages whose URL is "like" /study* , is that possible?

    If so, this should be heavily mentioned in this Help article, as I'm sure it's pretty important for a lot of companies!

    0
  • Andrew Cohen
    Comment actions Permalink

    Also, does contextual help work in the mobile SDK?

    1
  • Daniel Aron
    Comment actions Permalink

    Hi Andrew, the native functionality works off URL. You could try custom code with zE.setHelpCenterSuggestions https://developer.zendesk.com/embeddables/docs/widget/api#ze.sethelpcentersuggestions

    For the mobile SDK there are ways to show a single article but the feature "contextual help" only relates to the web widget.

    0
  • Andrew Cohen
    Comment actions Permalink

    Thanks for this, @Daniel.  But I'm not sure that documentation answers my question about wildcards.  In all of your examples above and elsewhere, it's assuming that the widget lives on pages with clean URLs, such as /pricing.

    But what if, say, we have a unique URL for each user (e.g. with the user's ID in the URL), such as /pricing?user_id=12345, /pricing/?user_id=54321, etc.?

    Is there a way we could just create a *single* widget condition for all pages like /pricing* , using the * character (or % ?) as a "wildcard"?

    0
  • Daniel Aron
    Comment actions Permalink

    Hi Andrew let me create a ticket for you and we discuss further there.

    0
  • Andrew Cohen
    Comment actions Permalink

    Hi Daniel, I never received the ticket.  Please note that the Admin account we're using is info@brainscape.com (but you can also use this email address for Andrew Cohen for just support, even if it doesn't have a Zendesk admin or agent account).  Thanks!

    0
  • Daniel Aron
    Comment actions Permalink

    Hi Andrew, looks like our Advocates are taking care of you with ticket ID #3052923.

    0
  • Ryan Walsh
    Comment actions Permalink

    To work off of the original comment by Robert Koch, does/can Contextual Help take the ending URL and match with a label in our Guide Knowledge Base?

    So if I were to use the Guide KB labels to match URL endings would end users get more accurate Contextual Help results?

     

    0
  • Daniel Aron
    Comment actions Permalink

    Hi Ryan, no Contextual Help does not match the ending URL to a label. If you want to use specific labels I'd recommend using the API zE.setHelpCenterSuggestions.

    https://developer.zendesk.com/embeddables/docs/widget/api#ze.sethelpcentersuggestions

    0
  • Noam Mahler
    Comment actions Permalink

    I'm having the same issue as Andrew Cohen above. 

    How do you handle URLs that include a user's ID and additional parameters?

    Can you share your answer?

    0
  • Tri Ardini
    Comment actions Permalink

    Hi all, 

    can I set top suggestion article on web widget for more than 3 articles?

    Thanks

    2
  • Nicole - Community Manager
    Comment actions Permalink

    Hi Tri, 

    No, that is not a customizable function. However, the "view more" button should suffice to show users additional content if needed. 

    -1
  • Robert Davis
    Comment actions Permalink

    Hi Daniel and Nicole,

    I have the same issue as Andrew.  Some of our URLs have a User ID or other identifying ID (e.g. www.smarterselect.com/forms/453423) and we want the contextual help to ignore the IDs and just focus on "forms".  I've not found any info in the Q&A or Community.  How did you guys figure it out with his "ticket ID #3052923"?

    Many thanks,
    Robert

    0
  • Nicole - Community Manager
    Comment actions Permalink

    Hey Robert, 

    Here's the solution that Andrew received from our Customer Advocates: 

    "About Contextual Help for the Web Widget outlines that we use whatever is in the URL after the hostname to search.  In your case, since you are adding additional information that would not likely produce useful suggestions, I would recommend following the workaround provided under "Customizing Contextual Help results" by overriding the search by utilizing one of our SetHelpSuggestions API methods.

    For information on customizing your results, visit our Web Widget Developer Documentation (this is a Javascript API that you add code to the webpages to modify the behavior.)

    For any /pricing?user_id=12345 type URL you can add in a zE.setHelpCenterSuggestions function in your site's code to set what search options you want that page to be using instead of the URL."

    Let me know if that helps, or if you have further questions. 

    0
  • Robert Davis
    Comment actions Permalink

    Hi Nicole,

    Thanks!

    RD

    0
  • Daniel Aron
    Comment actions Permalink

    We just deployed a minor enhancement to the Web Widget Contextual Help that should improve results returned in scenarios where URLs include IDs or other numeric strings.  Please let us know how you go!

    1
  • Paul Reeves
    Comment actions Permalink

    This doesn't seem compatible or complimentary to Chat. Is that correct? We have an offline message when an agent is not available and our widget displays that message, not contextual help. 

    Our CSS template has a related articles area next to our content (like this page). I assume that's a simplistic implementation of contextual help?

    0
  • Nick Dushack
    Comment actions Permalink

    Hi Paul,

    You are correct in that this does not apply to the Chat-only widget. Contextual Help is managed within Support under the Web Widget settings. You can offer the Contextual Help feature, a Contact Form, and Chat, all from the same Widget if you have both a Support and Chat account. 

    Seeing as you have access to the CSS template, this leads me to believe you have access to Guide, which you cannot access unless you have a Support account. Therefore, I would recommend utilizing the Web Widget instead of the Chat-only widget.

    If for some reason you require the Chat-only widget, you could then build your own widget with the Web SDK and possibly implement a reference to your Help Center articles via the Help Center API. This would require a high level of custom-coding however.

    I hope this provides some clarification for you. Let us know if you have any other questions!

    0
  • Rebecca McMurry
    Comment actions Permalink
    We are considering SSO for a new site we are creating.  I was just reading this article and was surprised to see that contextual help does not work with the widget if a login is required. Is that still the case?
     
    Does the chat widget work behind a login?
     
     
    0
  • Brett - Community Manager
    Comment actions Permalink

    Hi Rebecca,

    You are correct and the Contextual Help will only work properly or login is not required in your Help Center. With login required users would need to log in first before they can access the Help Center content.

    As for the Chat widget, are you hosting on an external website? Users should be able to Chat with an agent without logging into the Help Center but let me know if you experience anything different on your end.

    Cheers!

    0
  • Gwenaelle Pellerin
    Comment actions Permalink

    Hi, 

    I have enabled Contextual aid.

    My url is www.feelfrancais.com/human so in order to have the article I wanted in the contextual help I have added Human 2 times in the article but still don't have anything in suggestion. 

    Am i doing something wrong ? 

    Thanks a lot for your help

    Gwenaelle

    0
  • Pedro Reis
    Comment actions Permalink

    Hi, Is there any workaround to list more than 3 articles, I don't see any "view more" option has mentioned above.

    Also, the help center search only works for English articles, not Spanish. Our articles exist in both languages. Am I missing something?

     

     

    1
  • Patrick Bosmans
    Comment actions Permalink

    Pedro,

    Unfortunately, the View more button was removed early 2018.

    https://support.zendesk.com/hc/en-us/articles/229167008/comments/360001759148

    -1
  • Annie Ashenfelter
    Comment actions Permalink

    I request the ability to control the number of articles displayed in the top suggestions list. This currently defaults to 3, and cannot be changed. Please vote in support of this feedback request here:

    https://support.zendesk.com/hc/en-us/community/posts/360029602954-Modify-Number-of-Top-Suggestions-Results-in-Web-Widget-Contextual-Help

    In addition, please consider restoring the removed View More button feature, which at least allowed the user to see more results.

    The explanation for the feature removal was to "lessen the number of clicks for users to navigate the widget" but this reasoning doesn't make sense. If the user doesn't find what they are looking for in the Top Suggestions, they must either manually enter search terms and click the search icon (i.e. more clicks), or they just resort to submitting a ticket, which does not deflect tickets or encourage self-serve.

    https://support.zendesk.com/hc/en-us/articles/229167008?page=5#comment_360001759148

    0

Please sign in to leave a comment.

Powered by Zendesk