How to customize the tickets module for the ASAP Android SDK?
The ticket module in Zoho Desk manages all customer support requests or inquiries. Each Ticket includes the customer's name, email, phone number, and issue. The ticket module also offers automated ticket assignment, escalation, and SLA management to help support teams streamline their workflow and efficiently support their customers.
These methods help configure the Submit Ticket form on the ASAP help widget.
Hiding fields in the Submit Ticket form
The Submit Ticket form in your ASAP help widget displays the same fields configured in the ticket layout in your Zoho Desk portal. To hide any of the fields in the form, you can use the setTicketsFieldsListTobeShown() method.
You must pass this method's list of fields (apiNames) as strings. You might also have to pass the departmentId key, depending on the department mapping of the help widget. For instance, if the help widget is configured for a specific department, you don't need to pass the departmentId key. If the help widget is configured for multiple departments, you must pass the departmentId key to ensure department-ticket field mapping in the Submit Ticket form.
After you include this method, the form displays only the fields you passed.
ZDPortalSubmitTicket.setTicketsFieldsListTobeShown(ticketListTobeShown, deptId, layoutId);
- ticketListTobeShown - List of strings (apiName of the Ticket Fields)
- departmentId - ID of the department for which you want to configure the Ticket Fields list.
- layoutId - ID of the particular layout for which you want to configure the Ticket Fields.
Please note that mandatory fields are not hidden even if you do not pass their names in the method.
Hiding mandatory fields in the Submit Ticket form
If you want to hide a mandatory field in the form, you can do so, provided the field's value is pre-filled. To do this, you must use the preFillTicketFields() method.
The preFillTicketFields() method proves helpful when you want to pre-populate fields with values, such as auto-generated IDs or OS versions of devices. To use this method, you must pass the list of PreFillTicketField objects. You should also pass the departmentId key, depending on the department mapping of the add-on. Just like in the case of the setTicketsFieldsListTobeShown() method, if the add-on is configured for a specific department, you don't need to pass the departmentId key. If the add-on is configured for multiple departments, you must pass the departmentId key to ensure department field mapping.
ZDPortalSubmitTicket.preFillTicketFields(preFillTicketFields, deptId, layoutId);
- preFillTicketFields - List of PreFillTicketField objects
- deptId - ID of the department you want to configure the Ticket Fields list.
- layoutId - ID of the particular layout for which you want to configure the Ticket Fields.
The PreFillTicketField object contains three main properties:
- fieldApiName—string—the API Name of the ticket field. You can retrieve the API Name of each field using the getTicketFields() method.
- fieldValue - object
- For multi-select fields, pass the values allowed as a list of strings.
- Pass one of the values allowed as a string for pick list fields.
- For date fields, pass the value as a string in the dd-MM-yyyy format.
- For dateTime fields, pass the value as a string in the dd-MM-yyyy HH-mm format.
- For Boolean fields, pass a Boolean value.
- For all other field types, pass the values as string objects.
- Make sure that the values you pass adhere to the maxlength and decimal restrictions defined for the field.
- isEditable - Boolean - Key that defines if the value in the field is editable or not
For more details, refer to the sample code.
Submit Ticket event with a subscription
If you want your app to subscribe to the Submit Ticket event, use the following method, which includes an event callback.
- ZDPortalSubmitTicket.setCreateTicketCallback(new ZDPortalCallback.CreateTicketCallback()
{
@Override
public void onTicketCreated(Ticket ticket)
{
//Ticket created
}
@Override
public void onException(ZDPortalException e)
{
//Exception
}
});
CreateTicketCallback is the callback object that sends ticket information when a ticket is submitted via the Submit Ticket screen.
If an authenticated user submits a ticket, all its details are sent to your app. Only the ticket number is sent if a guest user submits a ticket.
Custom-Configuring Ticket actions
Users can perform various actions, including replying to, commenting, and closing tickets.
The following method helps you define which actions must be allowed and which must be disallowed when users access the ticket submission screen on the ASAP add-on.
- ZDPTicketConfiguration configuration = new ZDPTicketConfiguration.Builder()
.isReplyAllowed(true)
.isCommentAllowed(true)
.isCommentEditAllowed(true)
.isTicketUpdateAllowed(true)
.build();
ZDPortalTickets.setConfiguration(configuration);
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho FSM Video Tutorials
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
How to change your language settings for ASAP Android SDK?
The ASAP SDK supports 47 languages. You can set any language of your choice based on the geographical location of your app's end-users. Below are the 47 language codes that help you set the language for the ASAP help widget. Language Local Code ...ASAP SDK Android - Release Notes
Please refer to the Release Notes page for further updates. 4.6.0 The old and new CAPTCHA mechanism is implemented to submit tickets. Enhanced ASAP SDK's accessibility, which includes content description for icons and vibration and haptic feedback. ...Working with the ASAP SDK for Android
This document pertains explicitly to help widgets created using the updated new ASAP Setup. Please note that if you are using an older version of ASAP, the help widgets will be read-only. To enable the new ASAP widgets on your app, use the latest ...Introducing ASAP Android SDK
This document pertains explicitly to help widgets created using the updated new ASAP Setup. Please note that if you are using an older version of ASAP, the help widgets will be read-only. To enable the new ASAP widgets on your app, use the latest ...Working with the ASAP SDK for React Native
The ASAP SDK for mobile provides easy access to help end-users of your React Native app. Using this SDK, you can create and customize a help widget that resides within your app and provides end-users with easy access to the Help Center services: • ...
New to Zoho LandingPage?
Zoho LandingPage Resources