Create a helpdesk ticket
You can use Create Ticket to record support requests, customer complaints or internal tasks in a structured manner in the helpdesk.
When do I need this function?
Section titled “When do I need this function?”Use this feature if:
- You want to document a telephone or written customer inquiry and track it for processing.
- You want to create an internal service task, for example manual address verification for customer XY.
Requirements and limitations
Section titled “Requirements and limitations”- Permissions: You need write access to the Helpdesk module (e.g. ticket creation rights).
- Previous configuration required: Many parameters in the ticket form, such as categories, priorities, tags and templates, need to be configured in advance. We recommend carrying out this basic configuration before productive use. Details can be found in the article Configure helpdesk.
Step-by-step instructions
Section titled “Step-by-step instructions”You can start ticket creation in two ways:
Way 1: Create ticket from customer view
Section titled “Way 1: Create ticket from customer view”Navigate to the detailed view of the respective customer and click on Create ticket. Advantage: tebio automatically links the ticket to this customer. The Affected Entity fields and the customer’s contact information are pre-populated.
Way 2: Create a ticket via the global helpdesk
Section titled “Way 2: Create a ticket via the global helpdesk”- Navigate to Helpdesk in the main menu and click Create Ticket in the top right.
Fill out ticket details
Section titled “Fill out ticket details”- Select template: Creating a ticket based on a configured template can speed up the process. If you select a template, for example changing customer data, from the dropdown, tebio automatically fills in fields such as category, subject, description text and standard tags.
- Affected Entity: If you started the ticket from the global help desk, indicate what the ticket relates to here. Search for the customer by name or using the search mask. If you start from the customer view, this field is already filled out.
- Fill out the mandatory fields Priority, Category and Subject if these have not already been prefilled in a template.
- Enter the customer’s actual request in the Description field. Use the rich text editor to format the text clearly, for example with lists or highlights.
- Additional options:
- Attachments: Upload relevant documents, such as screenshots of an error message.
- Tags and Links: Tag the ticket or link it to other existing tickets.
- Assignment: Enter the person responsible and, if necessary, set a target date in the Due to field.
- Finally, click Create Ticket to save the process.
Visibility in the customer file
Section titled “Visibility in the customer file”Helpdesk tickets are linked to the affected entity, for example a customer. A ticket is therefore also displayed in the detailed view of the affected entity. When you open a customer, you can view the associated support cases in the corresponding tab without switching to the global helpdesk.
Result
Section titled “Result”You have created a new ticket. The ticket appears in the ticket search, is assigned to a processing person if specified and is visible in the customer view.
API Notes
Section titled “API Notes”Tickets can also be created via the API, for example to connect external contact forms or third-party systems.
| End point | Method | Description | OperationId |
|---|---|---|---|
/v1/helpdesk/ticket | POST | Create a helpdesk ticket | createHelpdeskTicket |