Support

Customers open support requests (tickets) in the portal. Your team answers them in the Helpdesk of the back office. Staff with any staff role can use the helpdesk: owner, admin, billing and support.

Email notifications#

Set a Support email under Platform settings. See Branding and access. Stacklane sends a short email to this address when:

The email has the subject [#<ticket number>] <subject> and contains the name of the customer, the category, the priority and a link to the request in the helpdesk.

Without a support email, Stacklane sends no notifications to your team.

The customer who opened the request gets an email when a staff member replies. Internal notes do not send an email.

Tickets#

A ticket has a subject, a category, a priority, a status and a list of messages.

Categories#

general, technical, billing, sales and abuse. The customer chooses the category. The default is general.

Priorities#

low, normal, high and urgent. The customer chooses a priority when opening the request. The default is normal. Staff can change it.

Statuses#

StatusCustomer seesMeaning
openWaiting for supportThe customer wrote last. Your team should reply.
answeredAnsweredYour team replied. The ticket waits for the customer.
closedClosedThe request is done.

Stacklane changes the status by itself:

Customers can close their own requests. Staff can set any status.

The ticket queue#

Open Helpdesk in the Support group of the back office. The queue shows the requests of all organizations, with the name of the organization.

Use the status filter to choose a view:

ViewShows
Waiting for usTickets with the status open. This is the default view.
Open requestsAll tickets that are not closed.
AnsweredTickets with the status answered.
ClosedTickets with the status closed.
All requestsAll tickets.

Turn on Assigned to me to see only the tickets assigned to you.

The queue is sorted with open tickets first, then answered, then closed. Inside each group, the most recently updated tickets come first.

Answer a request#

  1. Click a ticket in the queue.
  2. Read the messages. Internal notes are marked and are only visible to staff.
  3. Type your reply in the text field.
  4. Click Send.

A message can be up to 20,000 characters.

Internal notes#

To write a note for your team only:

  1. Turn on Internal note, not visible to the customer.
  2. Type the note.
  3. Click Add note.

The customer never sees internal notes, and the status of the ticket does not change.

Properties#

In the Properties card of the ticket you can change:

Click Save to apply the changes.

Audit events#

Stacklane writes these audit events:

EventWhen
support.tickets.createA customer opens a ticket.
support.tickets.closeA customer closes a ticket.
admin.support.replyA staff member replies.
admin.support.noteA staff member adds an internal note.
admin.support.updateA staff member changes the status, priority or assignee.

Limits#

An organization can open at most 20 new requests per hour. Above that, the customer gets the error throttled.

API endpoints#

MethodPathDescription
GET/api/admin/support/ticketsThe queue. Query: status (active, open, answered, closed), mine=true, limit, offset.
GET/api/admin/support/tickets/{id}The ticket with all messages, internal notes, the organization name and the list of staff members who can be assigned.
PUT/api/admin/support/tickets/{id}Change the properties. Body: {"status": "answered", "priority": "high", "assigned_to": 12}. Use null for no assignee.
POST/api/admin/support/tickets/{id}/repliesReply. Body: {"body": "...", "internal": false}.

For the customer endpoints, see API.