Support & Quality

Product Support Workflow

No support without a ticket 😘

The help desk provides technical support to end users, troubleshoots customer and user issues, and/or guides them through specific tasks and actions. The fundamental aim of our help desk is to provide swift and effective resolutions for user queries and act as a one-stop shop to manage all customer queries, complaints, needs, requests and support. It is essentially a single point of communication between Akvo and end users and helps resolve any product issues swiftly and effectively.

What Is The Support Process?

How to Categorize Issues?

Severity

Definition

Critical Impact

Production application down or major malfunction resulting in in-operative condition.

Significant Impact

Critical loss of application resulting in high number of users unable to perform their normal functions. Major failure; inconvenient workaround or no workaround exists.

Minor impact

Moderate loss of application functionality or performance resulting in multiple users impacted in their normal functions. Minor feature/product failure, convenient workaround exists/minor performance degradation.

Low impact

Minor loss of application functionality, cosmetic issues.

How To Tag Incoming Tickets?

See this page.

Response Time

The support team commits to responding to issues within 1 working day.

How To Reach Out To Support?

The strong preference is for users to submit requests via the Contact Us form in the support portal. 

To create a support request, follow the below steps:

  1. Locate the Contact Us form - Look for a link or button labelled "Contact Us" on the product support pages.
  2. Enter your information - On the contact form page, enter your name, email address, the hub you work with, the product you need help with, and any other information required by the form. Also select whether you are reporting a bug, requesting a feature or have a question.
  3. Write your message - Use the message box provided to write your inquiry or message. Be clear and concise, and include any necessary details to help us understand your request. See guidelines below on how to write appropriate messages.
  4. Review and submit - Before submitting the form, review all of the information you've entered to make sure it's accurate and complete.

Please reach out on Slack to make sure we attend to the ticket if it is urgent.

If a client reaches out to you directly:

  1. Inform clients that a ticket will be created for them
  2. Make sure the client knows that the support team will end up reaching out to them over email (support ticket)

How To Properly Document A Support Issue?

Sharing as much information as possible helps us in researching and replicating the issue.  “It doesn’t work” makes it very hard to research a problem. 

A general guideline on what to provide:

  1. What were you doing - the action the user was performing
  2. What did you expect to happen - expected result
  3. What actually happened
  4. Steps to reproduce the problem - Any steps that will help reproduce the problem
  5. Flow specific - Dashboards, folders, surveys, assignments, device IDs, IMEI, etc.
  6. RSR specific - User roles / account, specific project, organization, RSR page, etc.
  7. Lumen specific - Instance, user, dataset, visualization, dashboard, etc.
  8. Device specific - Type of computer/browser, type of phone or tablet, app version (and connected dashboard)

Rationale

The process of submitting all produced related inquiries, issues, and complaints through the help desk ticketing system will ensure that your requests are logged and tracked, and our support team can address your needs in a timely and organized manner. Additionally, by following this process, we can document and analyze the data collected from your requests;  This data will allow us to measure our performance and identify areas for improvement.

How To Tag Tickets

Tag

Description

Hub

The hub from which the client/partner is managed from. Can be one off East-Africa, Europe, West-Africa, Asia, Americas.

 

The following tags are available on Re:amaze for the regions partners are managed from:

  • #Submit-Asia:
  • #Submit-EastAfrica
  • #Submit-Americas
  • #Submit-Europe
  • #Submit-WestAfrica

Partner

The partner/client name. The partner tag beings with a “#instance-” followed by the partner name e.g. for Nuffic the partner tag is "#instance-nuffic" for Wemos "#instance-wemos" etc.

Category

Groups tickets by whether it is a question, bug or feature request. When triaging a ticket the support office the following tags are available for this:

  • #question
  • #bug
  • #feature 

Escalation Status

Flags whether the ticket required additional input from L2. This is for tickets that are not resolved by L1 usually bugs or feature requests. The available tag options for this are:

  • #escalated
  • #not-escalated

Impact

Categorizes tickets by the severity of the impact. The description of each of this can be found here.

Issue

A brief tag that describes the issue being reported by the user e.g. data import or export, user management etc.

No standard classification. But be mindful of reusing existing tags as much as possible.

Product Support Dashboard

See the dashboard here.

What Is the Product Support Dashboard?‌

 A ticket dashboard collects all client tickets and provides a centralized place for support teams to view and manage the issues and requests. The dashboard provides a quick, visual overview of ticket status, ticket volume and overall team performance.

What does each chart mean?

Volume Reports

The Volume report shows you a summary and detailed breakdown of customer support requests. It gives you an idea of how "busy" things are in the world of support.  

There are 3 volume reports  grouped by:

  1. The product/brand
  2. The impact/severity of the issue
  3. The category of the ticket
  4. Escalation Status

There is an additional volume report that shows which partners have raised the most number of tickets and a summary of the same by date.

image.png

Average Response Time

The Average Response Time report tells how fast your team is getting back to customers. It's a metric on quality of support and the reports show you when you're doing well and when there are deficiencies in speed. 

image.png

Filtering The Dashboard