ServiceNow Customer Self-Service Portal Requirements Workshop Questions
Customer Self-Service Portal requirements workshop questions are the prompts a team works through before a portal is built, so that each answer narrows the next. The page covers customer tasks, content, authentication, escalation and adoption, and sets them out in four passes. Use it to settle which customer tasks a portal should handle before any design work starts.
Understanding Customer Needs and Preferences
Before building a Customer Self-Service Portal, clarify what customers actually want to do themselves. Many organisations assume customers want to open tickets, check order status, or download documentation. Reality is more nuanced: some customers prefer self-service for routine questions; others want a human for nearly everything. Some trust the portal once they have used it; others distrust automation and escalate to a phone call after a bad experience.
Ask your support and sales teams: what are the top reasons customers contact you? Which of those can be self-served? A customer reporting a common problem might self-serve if the solution is a clear troubleshooting guide, but will call if the diagnosis is uncertain. A customer checking an invoice might use the portal for routine queries but will call if there is a dispute. Segment by use case, not by customer type.
Content and Knowledge Requirements
A self-service portal only works if customers can find answers. Before launching, audit your documentation: is it current, accurate, and written for a customer (not internal jargon)? Many portals fail because they expose internal knowledge bases designed for support staff, not customers. A customer sees technical terminology, outdated procedures, and answers that assume specialist knowledge.
Ask: how will customers search for help? Will they browse a category tree, use a search bar, or follow a wizard (answer questions and get guided to a solution)? What language do customers use to describe problems, and does your knowledge base use those same words? Search-first designs tend to succeed; category hierarchies tend to fail because customers either search before browsing or cannot guess the right category.
Self-Service Task Design
Common self-service tasks include: reporting a problem, checking the status of a previous request, downloading an invoice or report, resetting a password, updating account information, or browsing a catalogue of products and services. For each task, ask: can a customer complete this independently, or do they need a human? Where will they get stuck and escalate?
Example: a customer opens a ticket to request a discount. Self-service can let them write the request and submit it. But approval requires human judgment. The portal can show them the ticket status and any comments from the support team, which partially addresses the need for visibility. But if they want to negotiate, a human must get involved. This is not a flaw; it is the right boundary between self-service and assisted service.
Authentication and Access Control
Customers need a secure way to log in and see only their own data. Ask: how do customers typically authenticate today? Do they have an existing account in your systems that you can use, or will you need to create portal-specific logins? What about customers who come from multiple business units or divisions—should they see all their interactions, or only some?
Ask whether single sign-on (SSO) is feasible. If many customers use your company’s email domain, SSO via email simplifies login. If customers are external partners or consumers from outside your organisation, SSO is often not possible, and the portal must manage its own logins. This affects user experience and adoption.
Escalation and Handoff to Support
Design the escalation path explicitly. If a customer gets stuck in self-service or encounters an issue that requires a human, how do they reach the support team? Should they be able to attach a screenshot or log file? Can they book a callback instead of waiting on a chat queue? Most successful portals let customers escalate while preserving context: the support agent can see what the customer tried and where they got stuck.
Ask what data the support team needs to see when a customer escalates. Do they need to read a transcript of the customer’s self-service journey, or is just the final question enough? The answer determines how much logging and integration the portal needs.
Adoption and Usage Monitoring
How will you drive adoption? Many organisations launch a portal and wait for customers to find it, then are surprised by low usage. Successful portals are promoted: email to active customers, a link in every support email, a banner on the company website, and support agents directing customers to self-serve resources during calls. Plan the promotional campaign before launch.
Ask how you will measure success. Low portal usage might mean the portal is poor, or it might mean you did not promote it well. Track: how many customers log in, how many use the portal to get answers (vs. just browse), how many escalate to support, and what is the resolution rate for portal-only interactions. These metrics show whether self-service is working or needs rework.
Common Pitfalls
Many portals fail because the organisation assumes customers have more technical knowledge than they do. Guides that assume familiarity with internal systems, use unexplained acronyms, or assume customers know which option to choose will frustrate users and drive escalations. Everytime someone calls in for a self-service task, it is a signal that the portal needs simpler language or better guidance.
Another pitfall is exposing too much information. Some organisations copy their internal ticketing system interface into the portal, expecting customers to understand fields like priority, assignment group, and service catalogue hierarchy. Customers do not care about internal structure. Show them the information they need to take action: is my request approved? When will it be ready? What is the status?
Running the requirements workshop in four passes
A requirements workshop for a customer portal often produces a long list of wishes and very little that a developer can build against. The reason is often sequence. Teams ask about screens before they have agreed which customer tasks matter, and about integrations before anyone knows which records a customer is allowed to see. The question bank below is arranged in four passes so that each answer narrows the next question.
Bring the room the same material each time: the contact reason report, two or three real transcripts with identifying detail removed, and the current list of back-office record types. Questions answered from memory tend to describe the process people wish they followed, while questions answered from transcripts describe the one they actually follow.
- Pass one, the tasks. Agree which customer tasks are in scope, and for each one ask whether it can be finished without a person.
- Pass two, the customer. For each task, ask who the customer is, what they already know, and what they do when the portal fails them.
- Pass three, the records. Ask which back-office records each task reads and writes, and which of those the customer should never see.
- Pass four, the handover. Ask what the support agent needs to see when a customer escalates, and how the customer is told what will happen next.
| Question area | Question to put to the room | Answer that signals a risk |
|---|---|---|
| Task scope | Which task produces the most calls that a form could answer? | Every task is equally important |
| Customer knowledge | What words would a customer type to find this, if they had never seen our product name? | The answer is the internal product name |
| Record visibility | Which fields on the case would be a problem if a customer read them? | No one can name one, because nobody checked |
| Escalation | When a customer gets stuck, what does the agent see first? | The agent starts again from zero with the customer |
| Ownership | Who answers for an article that is wrong next month? | Nobody has been named yet |
Handling disagreement without stalling the session
Disagreement in these workshops is useful when it is about the customer, and wasteful when it is about who is right. Ask each person to state the customer situation they have in mind before offering a solution. Two people who describe different customers are rarely in conflict about the design. They have simply been picturing different groups, and the workshop should split the requirement into one version per group.
Record each unresolved point on a visible list with a named owner and the next date it will be decided. An open item on the list is an honest result. A requirement that was agreed quickly and then reopened in testing costs far more.
Questions people raise about running the workshop
Who should attend from the customer side?
Invite customers who call, not only the ones who answer surveys. Frequent callers tend to describe the failure points in plain language, and their examples tend to be more specific than those of account managers. If a customer representative cannot attend, bring one recent transcript from a customer in that group and read it aloud at the start of the relevant pass.
What if the support team says customers would never use the portal for a task?
Ask them to name the last three calls for that task, and what the caller tried before phoning. Support teams can be good at describing what customers cannot do, and weaker at describing what customers would do if the path existed. Treat the claim as a hypothesis, and plan a small test rather than dropping the task from scope.
How do we know when to stop asking questions?
Stop when each task in scope has a named customer, a short list of records it touches and an agreed escalation route. Further questions at that point tend to reopen decisions that have been made, rather than adding information the design needs.
Should the workshop cover reporting?
Only the reporting that changes a design decision, such as which status values the customer sees. A broader reporting discussion belongs in a separate session with the analysts, because it draws in people who do not need to decide anything about the customer experience.
Once the workshop produces a task list, the enterprise use cases guide is the place to check whether each task belongs in a portal at all. For how case routing should follow the answers, the case routing article is the next read.
Frequently asked questions
Should customers be able to open multiple tickets for the same issue?
Not ideally. If a customer reopens a similar issue, the portal should surface previous tickets and ask if they are following up or reporting something new. This prevents duplicate work and helps the support team understand if an earlier fix did not work.
How can you tell if low portal usage means the portal is bad or adoption is just slow?
Combine usage metrics with user feedback. If the portal has low usage but many of the users who try it say it was helpful, adoption may just be slow and you need more promotion. If usage is low and most users say the portal was unhelpful, you have a quality problem that needs fixing.
Can a portal serve both internal employees and external customers?
Typically not well, because internal employees and external customers need different information and workflows. A customer wants to report a problem; an employee wants to place an internal request. Build separate portals or clearly separate the views and workflows within a single portal.
Related guides
Related Oblytech services
Where this topic turns into delivery work, these are the Oblytech services that cover it.
Planning, running or fixing a ServiceNow programme? Tell us where you are and we will suggest a sensible next step.
Contact us