Configuring and Using the Service Portal

From AgileApps Support Wiki

The Service Portal gives your customers a place to create and track cases, and optionally to interact with your user Community or access your Knowledge Base.

Configuring the Configuring and Using the Service Portal

To configure the Service Portal, you start by selecting the features you want:

  1. Go to GearIcon.png > Channels > Service Portal
    The Configure Service Portal page opens.
  2. Under Portal Features:
    1. Click the Community checkbox to let users interact with each other
    2. Click the Knowledge Base checkbox to give users access to articles you've published
    In the portal, the Cases tab lets customers create new cases and monitor cases they have created.
    These options create additional tabs that portal users can access.
  3. Next decide if you'll allow users to register themselves:
    Self-registration is generally useful for business-to-consumer (B2C) support, where customers may have purchased your products through a retail channel. When customers visit your Service Portal, they can then login using their Google ID--or they can create a new username and password at the portal site.
    For B2B support, this option is generally disabled. When it is, customers can register only when you send them an invitation.
  4. You can also upload a logo image and customize the Service Portal in other ways.
    Learn more:
    Branding Applications for Your Organization
    Service Portal Settings, for a complete list of settings

Working with the Service Portal

How Your Customers Use Your Service Portal

If customers are allowed to use the Service Portal without registering (an option you can configure) then they see service portal as a guest. Here's the interface that greets them when they arrive:


In this case, both the Knowledge Base and Community features have been enabled (you'll learn how to do that in a moment), so there are tabs for both of those options.

Registered portal users see an additional tab--the Cases tab, shown here:


This tab lets them add new Cases and view Cases they have previously filed.

How an Agent Gets to the Service Portal

External users go directly to the Service Portal when they browse to your ServiceDesk URL on the web. There, they'll see the features you have configured. If they're registered users, they'll also be able to browse their cases. Agents and other internal users, on the other hand, go to the Agent Portal when they log in.

To get to the Service Portal from the Agent Portal:

  1. Click the down arrow next to your login name, and then click Go to Service Portal
    (To get back, use the same process and choose Go to Agent Portal.)
  2. In the Support Portal, click the Knowledge Base or Community tab:
    (These tabs appear when they are enabled in the Service Portal configuration.)

Creating Categories

Categories help users to narrow their focus when searching or browsing for information. They can be featured in the Community page, the Knowledge Base, or both. When a user clicks on a category, they zoom into that subset of the community's messages and knowledge base articles. Initial categories for a community might include:

  • Announcements
  • General Questions
  • Billing Questions

Initial categories for a knowledge base might include:

  • Getting Started
  • Tips and Tricks
  • Troubleshooting

In both the Community pages and the Knowledge Base, categories are called topics. You can create a topic from either location.

To create a new category:

  1. In the Community or Knowledge Base tab, click the New Topic button:
  2. To create a new top-level category, leave the Parent Topic blank.
    To create a lower-level category, choose one of the existing topics as the parent.
  3. Click Save.

Working with the Community

The community is a place where your customers can ask questions and get help from each other, as well as your support team.

Asking Questions

  1. In the Community tab, click Add Question
  2. Fill in the subject and body, and select a topic for the question:
  3. Click Save.

Answering Questions

When you view a question, click in the Post an Answer area to respond to it.


Previous answers are shown below the response area. Registered users can vote on an answer to move it up or down in the rankings. (Comments are ordered by their rank first, and by date second.)

Discussion Options

Registered users can subscribe or unsubscribe from a discussion, while Case agents can convert the original question to case, to make sure it gets the attention it needs.


Working with the Knowledge Base

With the knowledge base, your support team can publish articles where customers can find them. Customers can then search for articles and browse the article categories, and your support team can send links to articles that answer common questions.

Adding an Article

  1. In the Knowledge Base tab, click New Article:
  2. Adding an article is a lot like adding a community question except that:
    1. You can tag the article with multiple topics.
    2. You can make it a Featured Article, so it's listed on the first page.
    3. If you don't make it Publicly Visible, it can be seen only by internal users.
    4. You can add attachments.

Adding a Picture to an Article

Images from anywhere on the web can be inserted into an article using the HTML <img> tag. A basic version of that tag looks like this:

   img alt="someImage.png" src="http://path/someImage.png"

The filename is typically put into the alt attribute to help with debugging, since that information appears only when the image can't be found.