Help Center

Articles Help Center

From version 10.0.0 of the Android SDK you can display your Help Center, show articles programmatically, filter your Help Center content and using our data methods, deeply embed your Intercom Help Center alongside your own content.

Check here for more content on setting up your Help Center in Interccom.

To display an Activity with your Help Center content, call the following method:

Intercom.client().displayHelpCenter()

šŸš§ Make sure Help Center is turned on

If you don't have Help Center enabled in your Intercom settings the method displayHelpCenter will fail to load. To enable your Help Center please go here and click the "Turn On Help Center" button.

Present an Article Programmatically

From version 8.1.0 of the Android SDK you can programmatically present an Article. To present an Article, pass in an articleID from your Intercom workspace to the following method:

Intercom.client().displayArticle("123456")

šŸš§ Make sure your article is live

An article must be ā€˜liveā€™ to be used in this way. If it is in a draft or paused state, end-users will see an error if the app tries to open the content.

Present a filtered Help Center

From version 10.0.0 of the Android SDK you can now pass in 1 or more collection IDs to filter the Help Center. This will display the same Activity as calling displayHelpCenter but the collections list will only show the IDs passed in.

Intercom.client().displayHelpCenterCollections(listOf("COLLECTION_1_ID", "COLLECTION_2_ID"))

šŸš§ Empty or invalid collection IDs

If the collection IDs are invalid or have no content, we will default to showing the complete Help Center list.

Using the data API

From version 10.0.0 you can now fetch the data directly and build your own UI. This is useful when you want to show Intercom collections alongside your other support content.

Fetch Collections

To fetch a list of all Collections call:

Intercom.client().fetchHelpCenterCollections(collectionRequestCallback)

The CollectionRequestCallback has three callbacks:

  • onComplete - if the request is successful we return a list of HelpCenterCollection objects.
  • onError - we return onError for any server errors or if the content isnā€™t found. We return the error code to the client, this would include errors like 500s, 404s, 401s.
  • onFailure - we hit this block if we either had a connectivity issue or some unknown error

The HelpCenterCollection object contains the follow values:

  • summary - an optional string that describes the collection
  • id - a string to identify that collection, this can be used to fetch the sections/articles for this
  • title - a string with the title of the collection

Fetch the contents of a collection

To get a list of sections/articles for a collections call:

Intercom.client().fetchHelpCenterCollection("COLLECTION_ID", collectionContentCallback)

This method requires a ā€œCOLLECTION_IDā€. You can get the IDs of your collections from fetchHelpCenterCollections or fetchFilteredCollections methods.

The CollectionContentRequestCallback has three callbacks:

  • onComplete - if the request is successful we return a HelpCenterCollectionContent object.
  • onError - we return onError for any server errors or if the content isnā€™t found. We return the error code to the client, this would include errors like 500s, 404s, 401s.
  • onFailure - we hit this block if we either had a connectivity issue or some unknown error

A collection can have a section (a group of articles with a header) or articles without a section. The HelpCenterCollectionContent object contains the following values:

  • id - a string, the id of the collection
  • name - a string with the name of the collection
  • summary - an optional string that describes the collection
  • articles - a list of HelpCenterArticle objects
  • sections - a list of HelpCenterSection objects

A section is a grouping of articles with a name. The HelpCenterSection model is described as:

  • name - a string, the name of the section
  • articles - a list of HelpCenterArticle objects

The HelpCenterArticle model can be found both inside of sections, or at the top level of the collection content (not a part of any section). The HelpCenterArticle model is described as:

  • articleId - a string, the id of the article, this can be used to display the article calling displayArticle(articleId)
  • title - a string, the title of the article

Search the Help Center

To get a list of articles in the Help Center, filtered by a search term call:

Intercom.client().searchHelpCenter("SEARCH_TERM", searchCallback)

The method takes a string to filter the Collections. The SearchRequestCallback has three callbacks:

  • onComplete - if the request is successful we return a list of HelpCenterArticleSearchResult objects.
  • onError - we return onError for any server errors or if the content isnā€™t found. We return the error code to the client, this would include errors like 500s, 404s, 401s.
  • onFailure - we hit this block if we either had a connectivity issue or some unknown error

The HelpCenterArticleSearchResult object contains the follow values:

  • articleId - a string, the id of the article, this can be used to display the article calling displayArticle(articleId)
  • title - a string, the title of the article
  • matchingSnippet - a string with the part of the article that matched the search string provided
  • summary - a with a summary of the article