Custom Functions

The Custom Functions feature in Cubicl allows users to add custom action menu options to task cards and task details pages. This enables users to perform customized actions on selected tasks, making workflows more efficient and improving the user experience.

How Custom Functions Helps You?

With Custom Functions, you can:

• Export task data

• Synchronize tasks with other applications

• Import data or files

• Automate various processes with external tools like Monkedo

Sample Use Cases

Performing an Action in Another Application

• Closing a GitHub Issue: Based on task details, the corresponding issue in GitHub can be automatically closed.

• Sending Notifications: A task completion email, SMS, or chat message can be sent to a customer. For instance, send a Slack or Microsoft Teams message with task updates.

• Adding to Outlook Calendar: A calendar event can be created for the task using Microsoft's Create Calendar Event component.

• Sending notifications when a task is completed: Automatically notify customers, team members, or managers via email, SMS, or messaging platforms when a task is marked as completed.

• Transferring a task to another application: Create a corresponding record in a CRM, calendar, or sales platform when a new task is added or updated. Sync task details with Asana, Trello, or Monday.com for cross-platform task management.

• Retrieving information from another application: Fetch customer details from a CRM and display them in the task. Retrieve a contract document from a sales platform for quick access.

• Creating detailed task reports: Generate a structured report summarizing task progress, comments, and attachments. Automatically export reports to Google Drive, Dropbox, or email as a PDF or Excel file.

Downloading a File

• Generating a Task Report: Task-related data, including comments under task, can be converted into a PDF file and downloaded.

• Bulk File Download: All files related to a task can be zipped and downloaded at once. Sync downloaded files with cloud storage platforms like OneDrive, Google Drive, or Box.

Opening a Browser Tab

• Opening a Related Record in Another App: If a task is linked to a record in another application (e.g., Salesforce), clicking the menu option will open the corresponding record in a new tab.

How to Add a Custom Function?

Go to Organization > Organization Details and find the Custom Functions section.

Custom functions in the Organization Page

Click Add Function+ button and a pop-up window will appear with fields to configure your custom function.

Custom Function Form

Fill in the required details:

Name (Required)

The text shown in the task actions menu. (Max 16 characters)

Icon (Optional)

The icon shown next to the action name in the menu. You can enter an emoji (🎉, 🚀, etc.), a symbol (+, -, etc.), or an icon URL.

Action URL (Required)

When the menu action is clicked, a POST request is sent to this URL with task and user details to trigger the desired action.

Type (Required)

Defines the type of action performed when the menu action is clicked. Action Types are:

• Simple Action: Performs the action and displays either a success or error message.

• Download File: Starts downloading the file returned from the Action URL.

• Preview File: Opens the file returned by the Action URL for preview. Supports PDF and image files; all other file types will be downloaded automatically.

• Open Browser Tab: Opens the URL returned by the Action URL in a new browser tab.

How to Perform a Function in a Task?

Go to the task's details page and click the Actions button. Under Custom Actions, select the function you want to perform.

A task's details page

Processing Data

Sending an HTTP Request

When a user triggers an action, the system sends an HTTP POST request to the "Action URL" specified in the settings. This request includes the following data in JSON format:

{
    // User who clicked the action
    "user": User,
    // Task where the action was clicked
    "task": Task,
}

You can access the data types here: Task and User

Returning a Response

The system at the URL should return an HTTP response in JSON format after processing the incoming request. This response may vary depending on the type of action. Here are the responses that should be returned according to the types:

Simple Action

If you don't want to display a custom message, you can return an empty response.

{
    "message": "CUSTOM MESSAGE"
}

Download File / Preview File

{
    "url": "FILE URL",
    "name": "FILE NAME"
}

Open Browser Tab

{
    "url": "URL",
}

Displaying an Error

If you want to display an error message when an error is returned from the Action URL, you should return a JSON data like the following. This data format is valid for all types:

{
    "message": "ERROR MESSAGE"
}

Need a Custom Solution?

If you need to perform specialized operations or display custom information on different Cubicl screens, our support team is happy to assist you. Feel free to reach out to us!