Overview

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:

1. 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.
   
   
2. 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.
   
   
3. 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.
4. Click on the "Update Tool Permissions" button.
5. Now go to Support Tool > Settings and find the box called "Allow anonymous posting" and select the checkbox. Click on the Update button.
   
   
6. On the same page, find the "Email to Tickets" box and for "Allow email from:" you can do as suggest:
   • 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.
     
     
   Note: You can add an autoresponder email to your customers, which they will receive when they create a support ticket.
7. On the same box, select the option called "Always accept emails from followers". Finally Click on the "Update" button.
8. You are done! Now you just need the email address and you can find it on the same box mentioned in step 6. 

Now that you have setup your support tool, your customers are able now to email you to your_space@support.assembla.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:

1. Go to your Team tool in your Space
2. On the "Add team members" box at the left, enter the email address of your customer and click on the search button.
3. Choose watcher as role.
4. Add a message to let them know what this is about.
5. 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:

1. Going to the Tickets tool > Settings page.
2. Select a default value for the fields you want.
3. 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 support@assembla.com. We will be happy to assist.