The Assembla Support tool allows non-Team members to submit tickets directly into a space via email or Web. Whether your customers have an Assembla account or not, they can post support tickets in seconds. They can track the ticket as your developers work on it, and leave comments directly on the ticket or via email. By allowing your customers into the process without giving them accounts, you keep your space maximally efficient and secure.
You can use custom settings and permissions to decide how involved you want your customers to be, and elect which privileges to give them. You can even write instructions and an email autoresponse for customers submitting tickets to make the experience as simple and straightforward as possible.
1. Install the Support Tool
You need to install the Support tool first. To do that please go to Your Space > Admin > Tools page and click on the "Add" button for the Support Tool.
2. Common Scenarios
The most used scenarios for the Support Tool are:
- Allow your customers to submit support tickets without having an Assembla account
- Invite your customers to your space and allow them to submit support tickets
In both scenarios, you can restrict the access to other tools. You will learn how to do this in the next points.
Scenario 1: Allow your customers to submit support tickets without having an Assembla account
Before going forward on how to set up this scenario for your support tool, you must know that your customers will only be able to create support tickets via email and not from the assembla UI. If you are OK with this, then you can continue with all the steps.
There are 2 ways to create a support ticket via email:
- By instructing them to send an email
- By creating a form in your website which sends an email
In both cases, you will need the same configuration. To achieve this, please follow these steps:
- Go to Your Space > Admin and under Security box, find the option called "Non-member access" and change its value from None to View. It will prompt a warning window, just click on the "Make this Space Public" button.
- Now, on the same page, click on the Security title, it will send you to the security page (.../my_space/admin/security). Scroll down at the bottom and you will find a table with all the installed tools and 3 columns.
- Look for the "Public Access" column and change all the values to NONE for all the tools except for the Support Tool which will have EDIT permissions.
- Note: You can select the permissions you want on each tool. Just make sure to do it correctly, otherwise, your customers might have access to your data.
- Nobody: It means nobody will be able to send an email to your support tool. Some people use this setting along with the "White list domains" which will allow only the registered domains to send emails.
- Anyone: It means that anyone will be able to send an email to your support tool.
Now that you have setup your support tool, your customers are able now to email you to email@example.com and a support ticket will be created. Any comment you add on that support ticket, will send an email to your customer. If you want to learn more about how to use emails with assembla, please check this article: Create and edit tickets using email.
Scenario 2: Invite your customers to your space and allow them to submit support tickets
If you want to know who is submitting your support tickets and you want your customers to use Assembla, then you will need to invite them to your team. To do that just follow these steps:
- Go to your Team tool in your Space
- On the "Add team members" box at the left, enter the email address of your customer and click on the search button.
- Choose watcher as role.
- Add a message to let them know what this is about.
- Click on Invite
Your customer will receive an email to join your space. He will be able to signup in 2 simple steps.
Now, to configure your space, you can follow the same steps of scenario 1 with the only difference that:
On step 1: You don't change anything. Just leave it in NONE.
On step 2: You are looking for Watcher instead of Public Access.
On step 5 and forward: You can skip them if you want.
3. Adding custom fields
If you want to manage your support tickets in a more efficient way, you can create custom fields.
Creating a custom field
To create a custom field please read our "Custom Fields" article.
Setting a Default value
You can choose a default value for a certain field by:
- Going to the Tickets tool > Settings page.
- Select a default value for the fields you want.
- Click on the "Update Default Values" button.
In the following example, a default value has been added for the "milestone", "permission type" and "support category" fields.
4. Choose what fields will be visible or editable
You can choose what fields your customers can see and edit. To do this, just go to your Support tool > Settings > Allow customers to view or edit each field.
You'll have the ability to hide (NONE) the fields or just make them visible (VIEW), or you can allow your customers to edit them (EDIT).
This is how a support ticket looks like after the settings we just did above:
And this is how it looks from the Tickets tool, where you and your team will be working on:
5. Support Tickets: Private vs Public
There are 2 types of support tickets in Assembla, Private and Public, and they are under the "Permission type" field inside a ticket. This field has 3 options:
- None: The ticket will not be considered as support ticket and it won't be shown in the support tool. It will only be shown in the tickets tool.
- Private: The ticket will be considered as support ticket and only the people on the follower list will be able to access it from the support tool.
- Public: The ticket will be considered as support ticket and anyone will be able to access it from the support tool.
Public tickets is the best option when a customer wants to open a support ticket and get everyone involved. For example the system is down, how to access to your site, etc.
On the other hand, Private tickets is the best option if a customer wants to report an issue that involves private information.
Either way, you can decide how to manage your support tickets:
- Scenario A: You don't want any public tickets - You just need to set NONE on the Permission type field and make sure the default value is not PUBLIC and all the support tickets will be created as private.
- Scenario B: You want public tickets - You need to set EDIT on the Permission type field and add the "Public Tickets" tab on the Support Settings page.
6. Configuring the message and fields that you want your customers to see
Once you're on the Support Tab click on "Settings". You can type an instruction message to your customers using html. Here is an example:
<p>Please search the <a href="https://assemblasupport.zendesk.com">Support Center</a> for a solution before posting a ticket.</p>
<p>Use the <b>New Ticket</b> button above to submit a ticket for technical support.</p>
<p>Include the following to expedite your ticket:<br>
<p> <strong> 1: Project URL</strong> and any other information that will help us troubleshoot.<br /></strong>
<strong>2: Screenshots and detailed steps</strong> we can use to try to reproduce your issue is also very helpful.</p>
<p><b>P.S: All API questions and issues should be posted at our official API Support Group: https://groups.google.com/forum/#!forum/assembla-api-dev</b></p>
<p><strong> If you need our help to configure your Project/Portfolio.</strong> Please <a href="https://assembla-inc.assembla.com/spaces/Customize-Space-Configurations/support/tickets/new">create a support ticket</a> with your requirements. We would love to help you.</br></p>
<p>Customer Support : 1.781.583.7541 </br></p>
<p>Toll Free: 1.844.332.5080 (US and Canada Only)</br></p>
And this is the instruction message customers see:
If you have any questions or need assistance. Please always feel free to email us at firstname.lastname@example.org. We will be happy to assist.