Streamlining Gladly Task Creation with Apex Code

Elevate Gladly Task creation with Apex code integration. Explore Innostax's guide on maximizing efficiency and functionality within your apps.

Sahil Khurana

Published: February 7, 2024

Key takeaways

Leverage Apex to integrate Gladly tasks seamlessly into your workflow by creating robust wrapper classes and handling API requests efficiently, boosting productivity through automated task management.
Utilize POST API endpoints to manage tasks in Gladly, including task creation and assignment, by defining a structured request body and integrating necessary parameters such as due dates and customer details.
Implement error handling and customization in your Apex methods for task creation, ensuring smooth integration with Gladly's API while tailoring the solution to specific needs like rescheduling appointments and managing tasks.

In the realm of modern work dynamics, efficient task management is the linchpin of heightened productivity. Gladly, an adept task management platform, opens new avenues for seamless task integration through its robust API. This guide zeroes in on the intricacies of crafting Gladly tasks using Apex, Salesforce’s formidable programming language. Whether you’re a seasoned developer or just embarking on your coding journey, this tutorial is your compass to elevate your workflow by harnessing the full potential of Gladly.

What is a Gladly Task?

A task is a way to create and do internal follow-up work for a customer within Gladly. Tasks have a due date, an assignee, a description of what is needed for a customer, and can be commented on. These can be created through the API to assign items to work within Gladly and through the its dashboard.

How to create a Gladly task?

To add tasks to the timeline for a customer specified by identifying information, the user can use a post request. Also, If the customer doesn’t exist, a new customer profile is created by default.

In this guide I will be using Apex to create Gladly Tasks through the POST API endpoint.

1. REQUEST BODY SCHEMA: application/json

{
  "id": "pOVVdzweSumI4bFxjlT8LA",
  "assignee": {
    "inboxId": "NFpDZtfqhk2pI6fjaVDlFf",
    "agentId": "zGaHXjD4SR-moMR9LbULDa"
  },
  "body": "Create task to reschedule appointment",
  "dueAt": "2020-03-15T06:13:00.125Z",
  "customer": {
    "emailAddress": "michelle.smith@example.org",
    "mobilePhone": "+16505551987"
  }
}

{

"id": "pOVVdzweSumI4bFxjlT8LA",

"assignee": {

"inboxId": "NFpDZtfqhk2pI6fjaVDlFf",

"agentId": "zGaHXjD4SR-moMR9LbULDa"

"body": "Create task to reschedule appointment",

"dueAt": "2020-03-15T06:13:00.125Z",

"customer": {

"emailAddress": "[email protected]",

"mobilePhone": "+16505551987"

}

id
String &lt;= 50 characters
Specifies the id of the task
assignee 
    required
object (Assignee)
Inbox and agent assignee for a task
body
   required
string &lt;= 10000 characters
Text to describe what task to complete. Constrained HTML Rich Content is supported.
dueAt
   required
string &lt;RFC3339&gt;
Time when the task will be due. This must be set to a time in the future.
Customer
   required
object (Customer Specification)
Specifies the customer a task belongs to. You must provide exactly one of the values.

String <= 50 characters

Specifies the id of the task

assignee

required

object (Assignee)

Inbox and agent assignee for a task

body

required

string <= 10000 characters

Text to describe what task to complete. Constrained HTML Rich Content is supported.

dueAt

required

string <RFC3339>

Time when the task will be due. This must be set to a time in the future.

Customer

required

object (Customer Specification)

Specifies the customer a task belongs to. You must provide exactly one of the values.

2. Let’s Create some Apex Wrapper Classes for Task Management

 public class TaskWrapper {
        public String id;
        public AssigneeWrapper assignee;
        public String body;
        public DateTime dueAt;
        public CustomerWrapper customer;


        public TaskWrapper(String id, AssigneeWrapper assignee, String body, DateTime dueAt, CustomerWrapper customer) {
            this.id = id;
            this.assignee = assignee;
            this.body = body;
            this.dueAt = dueAt;
            this.customer = customer;
        }
    }


    public class CustomerWrapper {
        public String emailAddress;


        public CustomerWrapper(String email) {
            this.emailAddress = email;
        }
    }


    public class AssigneeWrapper {
        public String inboxId;
        public String agentId;


        public AssigneeWrapper(String inboxId) {
            this.inboxId = inboxId;
        }
        public AssigneeWrapper(String inboxId, String agentId) {
            this.inboxId = inboxId;
            this.agentId = agentId;
        }
    }

public class TaskWrapper {

public String id;

public AssigneeWrapper assignee;

public String body;

public DateTime dueAt;

public CustomerWrapper customer;

public TaskWrapper(String id, AssigneeWrapper assignee, String body, DateTime dueAt, CustomerWrapper customer) {

this.id = id;

this.assignee = assignee;

this.body = body;

this.dueAt = dueAt;

this.customer = customer;

}

public class CustomerWrapper {

public String emailAddress;

public CustomerWrapper(String email) {

this.emailAddress = email;

}

public class AssigneeWrapper {

public String inboxId;

public String agentId;

public AssigneeWrapper(String inboxId) {

this.inboxId = inboxId;

}

public AssigneeWrapper(String inboxId, String agentId) {

this.inboxId = inboxId;

this.agentId = agentId;

}

3. Create a method to construct the request body with required parameters.

 public static void createTaskToRescheduleAppointment(String customerEmail, String previousDate, String newDate) {
        String taskBody =
             '&lt;strong&gt;Appointment Rescheduled:&lt;/strong&gt; &lt;br&gt;Your appointment has been rescheduled to ' +
             newDate +
             ' from &lt;strong&gt;' +
             previousDate+
             '&lt;/strong&gt;.&lt;br/&gt;';
 
         try {
             // Implement logic to get the inbox ID according to your needs.
             String inboxId = getInboxId();
 
            AssigneeWrapper assignee = new AssigneeWrapper(inboxId);
            CustomerWrapper customer = new CustomerWrapper(customerEmail);
 
            // Either Create a method to get the dueAt date for the new task or use any value directly for the due date according to your requirement.
             DateTime dueAt = getRescheduleDueDate();
 
            TaskWrapper task = new TaskWrapper(null, assignee, taskBody, dueAt, customer);
 
            createTask(task);
         } catch (Exception e) {
             // handle the catch block according to your requirement.
         }
     }

public static void createTaskToRescheduleAppointment(String customerEmail, String previousDate, String newDate) {

String taskBody =

'Appointment Rescheduled: Your appointment has been rescheduled to ' +

newDate +

' from ' +

previousDate+

'. ';

try {

// Implement logic to get the inbox ID according to your needs.

String inboxId = getInboxId();

AssigneeWrapper assignee = new AssigneeWrapper(inboxId);

CustomerWrapper customer = new CustomerWrapper(customerEmail);

// Either Create a method to get the dueAt date for the new task or use any value directly for the due date according to your requirement.

DateTime dueAt = getRescheduleDueDate();

TaskWrapper task = new TaskWrapper(null, assignee, taskBody, dueAt, customer);

createTask(task);

} catch (Exception e) {

// handle the catch block according to your requirement.

}

4. Create the createTask method to handle the post request.

public static void createTask(TaskWrapper task) {

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (task != null) {

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;createTaskOnGladly(task);

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;&nbsp;private static HttpResponse createTaskOnGladly(TaskWrapper gladlyTaskWrapper) {

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;String requestBody = JSON.serialize(gladlyTaskWrapper);

&nbsp;&nbsp;String GLADLY_ENDPOINT = '&lt;organization&gt;.gladly.com/api/v1/tasks';

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;HttpRequest req = new HttpRequest();

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;req.setEndpoint(GLADLY_ENDPOINT);

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;req.setMethod('POST');

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;req.setHeader('Content-Type', 'application/json;charset=UTF-8');

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;req.setBody(requestBody);

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;HttpResponse response = (new Http()).send(req);

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;// Get the status code of the API request and handle additional features

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (response.getStatusCode() == {Status Code to check}) {

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return response;

&nbsp;&nbsp;&nbsp;&nbsp;}

public static void createTask(TaskWrapper task) {

        if (task != null) {

            createTaskOnGladly(task);

        }

    private static HttpResponse createTaskOnGladly(TaskWrapper gladlyTaskWrapper) {

        String requestBody = JSON.serialize(gladlyTaskWrapper);

String GLADLY_ENDPOINT = '<organization>.gladly.com/api/v1/tasks';

        HttpRequest req = new HttpRequest();

        req.setEndpoint(GLADLY_ENDPOINT);

        req.setMethod('POST');

        req.setHeader('Content-Type', 'application/json;charset=UTF-8');

        req.setBody(requestBody);

        HttpResponse response = (new Http()).send(req);

        // Get the status code of the API request and handle additional features

        if (response.getStatusCode() == {Status Code to check}) {

        }

        return response;

    }

Conclusion

In conclusion, this guide has unveiled the power of Apex in simplifying the creation of Gladly tasks. By delving into the code intricacies, you’ve gained the tools to seamlessly integrate Gladly into your workflow, leveraging the capabilities of Apex. As you implement these insights, you’re not just writing code; you’re sculpting a more efficient work environment. Cheers to unlocking the synergy between Apex and Gladly for a productivity boost in your day-to-day tasks with the expertise of Innostax.

Get a Fast Estimate on Your Software
Development Project

What is a Gladly Task?
How to create a Gladly task?
1. REQUEST BODY SCHEMA: application/json
2. Let’s Create some Apex Wrapper Classes for Task Management
3. Create a method to construct the request body with required parameters.
4. Create the createTask method to handle the post request.
Conclusion

See how efficient your engineering team really is?

Calculate For Free

Streamlining Gladly Task Creation with Apex Code

Key takeaways

Leverage Apex to integrate Gladly tasks seamlessly into your workflow by creating robust wrapper classes and handling API requests efficiently, boosting productivity through automated task management.

Utilize POST API endpoints to manage tasks in Gladly, including task creation and assignment, by defining a structured request body and integrating necessary parameters such as due dates and customer details.

Implement error handling and customization in your Apex methods for task creation, ensuring smooth integration with Gladly's API while tailoring the solution to specific needs like rescheduling appointments and managing tasks.

What is a Gladly Task?

How to create a Gladly task?

1. REQUEST BODY SCHEMA: application/json

2. Let’s Create some Apex Wrapper Classes for Task Management

3. Create a method to construct the request body with required parameters.

4. Create the createTask method to handle the post request.

Conclusion

Get a Fast Estimate on Your Software
Development Project

Table of Contents

See how efficient your engineering team really is?

Related Blog Articles

Streamlining Gladly Task Creation with Apex Code

Key takeaways

Leverage Apex to integrate Gladly tasks seamlessly into your workflow by creating robust wrapper classes and handling API requests efficiently, boosting productivity through automated task management.

Utilize POST API endpoints to manage tasks in Gladly, including task creation and assignment, by defining a structured request body and integrating necessary parameters such as due dates and customer details.

Implement error handling and customization in your Apex methods for task creation, ensuring smooth integration with Gladly's API while tailoring the solution to specific needs like rescheduling appointments and managing tasks.

What is a Gladly Task?

How to create a Gladly task?

1. REQUEST BODY SCHEMA: application/json

2. Let’s Create some Apex Wrapper Classes for Task Management

3. Create a method to construct the request body with required parameters.

4. Create the createTask method to handle the post request.

Conclusion

Get a Fast Estimate on Your Software Development Project

Table of Contents

See how efficient your engineering team really is?

Related Blog Articles

Get a Fast Estimate on Your Software
Development Project