---
title: Form
slug: mydesken/form
createdAt: 2024-12-09T18:29:46.651Z
---

<font color="#2166AE">**Administrator**</font>

Each activity can have a customized form with specific fields that will be filled out by the requester when opening a ticket. This feature allows you to define exactly what information will be requested — making the service more precise and organized.

# <font color="#ffffff">1 - F**orms**</font>

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/nr-J3V5p5201mlHyY5LOb-20260122-130256.gif)

See below for step-by-step instructions on how to access it:

::::WorkflowBlock
:::WorkflowBlockItem
**Go to Settings → Portfolios**

In the top menu and then in the side menu.
:::

:::WorkflowBlockItem
**Click on the desired portfolio**

The related services will be displayed below.
:::

:::WorkflowBlockItem
**Click on the desired service**

As atividades do serviço serão exibidas.
:::

:::WorkflowBlockItem
**Click on the desired activity**

A window will open on the right side of the screen.
:::

:::WorkflowBlockItem
**Click on Activity Form**

A new window — Customize Form — will open in the center of the screen, with the tabs Form and Guidelines.
:::
::::

# <font color="#ffffff">2 - Create a Form with AI</font>

***

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/BewoxTTB6TZMkfhtm-Fjx-20260122-130521.gif)

My Desk uses artificial intelligence to simplify form creation. Unlike portfolio creation—where you need to describe in detail what you want—form generation automatically suggests fields based on the activity and service name with a single click. See below for a step-by-step guide on how to request form generation using AI:

::::WorkflowBlock
:::WorkflowBlockItem
**Access the Customize Form window**

Follow the steps in section 1 above to reach the form window.
:::

:::WorkflowBlockItem
**Click on Suggest form with AI**

The button is located to the right of the search bar. Please wait a few seconds while the AI ​​processes the suggestion.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/MXOMlNFOTaMFkmoXESrWM_formulario-criar-ia.jpg)
:::

:::WorkflowBlockItem
**Review the generated suggestion**

Edit, add, or delete fields from the suggested form, if necessary.
:::

:::WorkflowBlockItem
**Click Save**

The button is located in the bottom right corner of the screen.
:::
::::

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/aGnTwcPuRnLf9qFNFUEVq_formulario-criar-ia.gif)

# <font color="#ffffff">**3 - Creating a New Form**</font>

***

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/igaqebbxO6XABXvXDN4Qm-20260122-131200.gif)

The Customize Form window has two parts: on the left are the available field types, and in the center is the preview area with the fields already added.

To manually create a form, follow the steps below:

::::WorkflowBlock
:::WorkflowBlockItem
**Locate the desired field**

Use the search bar in the left panel to find a field by name, or browse the list of available types.
:::

:::WorkflowBlockItem
**Add the field to the form**

Click on the field or drag it to the preview area in the center. The field will be added to the form's list.
:::

:::WorkflowBlockItem
**Configure the field**

Click the pencil icon or the three dots (···) in the upper right corner of the field to edit its properties.
:::

:::WorkflowBlockItem
**Click outside the editing window to save**

The field settings will be maintained automatically.
:::

:::WorkflowBlockItem
**Reorder the fields if necessary**

Click and drag the button with 6 dots on the left side of each field to change the order.
:::

:::WorkflowBlockItem
**Click Save**

The form will be saved and will be available when you open a ticket for this activity.
:::
::::

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/D43ypS5iMYYjIjJQXDtax_formulario-criar-manual.gif)

**The creation window is divided into two sections:**

- **Form**;
- **Instructions**.

See below for details on each.

# <font color="#ffffff">**4 - Form Section**</font>

***

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/W12i_a8VVeGgEJoMZDNDT-20260122-131604.gif)

In this section, you can actually create or edit your forms.

The available field types are displayed on the left side of the menu, and the list of fields added to the form will be displayed in the center.

To add a new field to your form, click on the corresponding field and drag it to the preview screen; a new field will be added to the center of the screen.

Below is a description of all available fields and a step-by-step guide to customizing them.

:::ExpandableHeading
## 4.01 - Search Field

Search bar where you can find the fields you need to create your form.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/O62EyM5Fy9x2BO_CXmm_E_formulario-busca.gif)
:::

:::ExpandableHeading
## 4.02 - Short Text&#x20;

This field allows users to input a short text.&#x20;

To use this field in your form, follow these steps:

- Click on the **Short Text** field in the left panel, hold and drag it to the preview area.
- Click on the **pencil icon** :FontAwesome[]{icon="fa-solid fa-pencil"}  or the **three dots (...)** in the top right corner of the field to edit or delete it.
- Edit the following fields:&#x20;
  - **Field Title** – Enter a short name.
  - **Field Subtitle** – Provide a brief description or subtitle.
  - **Required** – Check the box to make the field mandatory for users, or leave it unchecked to make it optional.
- **Cancel/Save** – Click **Cancel** to return to the preview section without saving changes, or click **Save** to apply and keep the changes.
- To move or reorder the field, click the **six-dot button** ⠿ on the left side of the field.&#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/umgbXzpi2abf48gaa8c60_image.png)
:::

:::ExpandableHeading
## 4.03 - Long Text

Este campo aceita um input de texto longo do usuário.&#x20;

**How to Use This Field in Your Form**

1. Click on the **Short Text** field on the left side of the window, hold and drag it to the preview area.
2. Click the **pencil icon** ✏️ or the **three dots (...)** in the top-right corner of the field to edit or delete it.
3. Edit the following fields:
   - **Field Title** – Give it a brief name.
   - **Field Subtitle** – Add a short subtitle or description.
   - **Required** – Check the box to make it mandatory or leave it unchecked to keep it optional.
4. **Cancel/Save**:
   - Click **Cancel** to return to the preview section without making changes.
   - Click **Save** to finalize and apply your edits.

To move or change the field’s order, click and drag the **six-dot button&#x20;**⠿ on the left side of the field. &#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/oVZlf2cdirkJRYZDK3gnf_image.png)
:::

:::ExpandableHeading
## 4.04 - Number

This field allows users to input **numbers only**.

**How to Use This Field in Your Form**

1. Click on the **Number** field on the left side of the window, hold and drag it to the preview area.
2. Click the **pencil icon** ✏️ or the **three dots (...)** in the top-right corner of the field to edit or delete it.
3. Edit the following fields:
   - **Field Title** – Give it a brief name.
   - **Field Subtitle** – Add a short subtitle or description.
   - **Required** – Check the box to make it mandatory or leave it unchecked to keep it optional.
4. **Cancel/Save**:
   - Click **Cancel** to return to the preview section without making changes.
   - Click **Save** to finalize and apply your edits.

To move or change the field’s order, click and drag the **six-dot button** ⠿ on the left side of the field.&#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/6fYB1EeFcrVFdoAbZ6E0a_image.png)
:::

:::ExpandableHeading
## 4.05 - CPF/CNPJ&#x20;

This field allows users to input **numbers only**, with validation for either **CPF or CNPJ**. There is a separate field for each option: **one for CPF and another for CNPJ**.

**How to Use This Field in Your Form**

1. Click on the **CPF or CNPJ** field on the left side of the window, hold and drag it to the preview area.
2. Click the **pencil icon** ✏️ or the **three dots (...)** in the top-right corner of the field to edit or delete it.
3. Edit the following fields:&#x20;
   - **Field Title** – Give it a brief name.
   - **Field Subtitle** – Add a short subtitle or description.
   - **Required** – Check the box to make it mandatory or leave it unchecked to keep it optional.
4. **Cancel/Save**:&#x20;
   - Click **Cancel** to return to the preview section without making changes.
   - Click **Save** to finalize and apply your edits.

To move or change the field’s order, click and drag the **six-dot button** ⠿ on the left side of the field.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/7ahWJqWyjf9x9okL1abw2_image.png)
:::

:::ExpandableHeading
## 4.06 - Phone Number&#x20;

This field allows users to input **numbers only**.

**How to Use This Field in Your Form**

1. Click on the **Phone Number** field on the left side of the window, hold and drag it to the preview area.
2. Click the **pencil icon** ✏️ or the **three dots (...)** in the top-right corner of the field to edit or delete it.
3. Edit the following fields:
   - **Field Title** – Give it a brief name.
   - **Field Subtitle** – Add a short subtitle or description.
   - **Required** – Check the box to make it mandatory or leave it unchecked to keep it optional.
4. **Cancel/Save**:
   - Click **Cancel** to return to the preview section without making changes.
   - Click **Save** to finalize and apply your edits.

To move or change the field’s order, click and drag the **six-dot button** ⠿ on the left side of the field.  &#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/w9MrA-5OAU5Mh-5BVxuzT_image.png)
:::

:::ExpandableHeading
## 4.07 - Multiple Choice&#x20;

This field allows users to select from a **dropdown list**, with either **single-selection** or **multiple-selection** options.

**How to Use This Field in Your Form**

- Click on the **Multiple Choice** field on the left side of the window, hold and drag it to the preview area.
- Click the **pencil icon** :FontAwesome[]{icon="fa-solid fa-pencil"}  or the **three dots (...)** in the top-right corner of the field to edit or delete it.
- Edit the following fields:
  - **Field Title** – Give it a brief name.
  - **Field Subtitle** – Add a short subtitle or description.
  - **Required** – Check the box to make it mandatory or leave it unchecked to keep it optional.
  - **Multiple Selection** – Check this box to allow users to select multiple options or leave it unchecked for single selection only.
  - **Options** – Add one or more options:
    - Type the desired option text in the box and click **\[+]** to add it.
    - Click the **six-dot button**  ⠿ and drag an option up or down to rearrange the order.
    - Click the **trash icon** :FontAwesome[]{icon="fa-solid fa-trash"} to delete an option.
- **Cancel/Save**:
  - Click **Cancel** to return to the preview section without making changes.
  - Click **Save** to finalize and apply your edits.

To move or change the field’s order, click and drag the **six-dot button** ⠿ on the left side of the field.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/eJrKBY1-huT9NROyhSuQr_image.png)
:::

:::ExpandableHeading
## 4.08 - Date&#x20;

This field allows users to input a **date**.

**How to Use This Field in Your Form**

1. Click on the **Date** field on the left side of the window, hold and drag it to the preview area.
2. Click the **pencil icon** :FontAwesome[]{icon="fa-solid fa-pencil"} or the **three dots (...)** in the top-right corner of the field to edit or delete it.
3. Edit the following fields:
   - **Field Title** – Give it a brief name.
   - **Field Subtitle** – Add a short subtitle or description.
   - **Required** – Check the box to make it mandatory or leave it unchecked to keep it optional.
4. **Cancel/Save**:
   - Click **Cancel** to return to the preview section without making changes.
   - Click **Save** to finalize and apply your edits.

To move or change the field’s order, click and drag the **six-dot button** ⠿ on the left side of the field. &#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/Fe4BnGr-s6pmanGoSNa2W_image.png)

**Note:** The date selection field in calendar format can only be viewed by the user when opening a ticket or by clicking the **Preview** button at the top of the page.&#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/cLqjPLxHr1hv2cHOEWPI9_portfolio-formulario-data.gif)


:::

:::ExpandableHeading
## 4.09 - Checkbox

This field allows users to select one or more options.

In the form options list, the checkbox displays:

- **Title**
- **Options**

To use this field in your form, follow these steps:

- Click on the **Checkbox** field in the left panel, hold and drag it to the preview area.
- Click on the **pencil icon** :FontAwesome[]{icon="fa-solid fa-pencil"} or the **three dots (...)** in the top right corner of the field to edit or delete it.
- Edit the following fields:
  - **Field Title** – Enter a short name.
  - **Field Subtitle** – Provide a brief description or subtitle.
  - **Required** – Check the box to make the field mandatory for users, or leave it unchecked for an optional field.
  - **Options** – Add one or more options:
    - Type the option text into the box and click **\[+]** to add it.
    - Click the **six-dot button** ⠿ and drag the option up or down to reposition it.
    - Click the **trash bin icon** :FontAwesome[]{icon="fa-solid fa-trash"}  to delete an option.
- **Cancel/Save** – Click **Cancel** to return to the preview section without saving changes, or click **Save** to apply and keep the changes.

To move or reorder the field, click the **six-dot button** ⠿ on the left side of the field.&#x20;

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/PYXRxbNG2IwSfmy0Yw_Or_image.png)
:::

:::ExpandableHeading
## 4.10 - Address

This field accepts a short address input from the user.

- Click on the **Address** field in the left panel, hold and drag it to the preview area.
- Click on the **pencil icon** :FontAwesome[]{icon="fa-solid fa-pencil"}  or the **three dots (...)** in the top right corner of the field to edit or delete it.
- Edit the following fields:&#x20;
  - **Field Title** – Enter a short name.
  - **Required** – Check the box to make the field mandatory for users, or leave it unchecked to make it optional.
- **Cancel/Save** – Click **Cancel** to return to the preview section without saving changes, or click **Save** to apply and keep the changes.

To move or reorder the field, click the **six-dot button** ⠿ on the left side of the field.

**Note**: The address field includes **seven options** for users to fill out:

- ZIP Code
- Street
- Neighborhood
- City
- State
- Number
- Additional Details.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/76Kn9uHg6PqajBPjRQ2dh_image.png)
:::

# <font color="#ffffff">**5 - Guidelines Section\:**</font>

***

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/yfYZGVkUihdF9uTLe2JIo-20260122-140526.gif)

The Guidelines tab allows you to add a description or instruction that will be displayed to the applicant when they open the form in the Experience Center — before filling in the fields.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/vFwy2z8eul3e0xwrZR3A5_image.png)

***

## 5.1 - Generate Form Guidelines with AI

Você também Gerar orientações para seus formulários utilizando a IA. Para isso siga os passos abaixo:

::::WorkflowBlock
:::WorkflowBlockItem
**Access the Customize Form window**

Follow the steps in section 1 to reach the form window.
:::

:::WorkflowBlockItem
**Click on the Instructions tab**

In the upper left corner of the window.
:::

:::WorkflowBlockItem
**Click on Suggest AI-powered directions**

The AI ​​will generate a suggested direction based on the activity.

::Image[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/UajEv8VrqTU03lpUmdO9D_image.png" size="30" width="380" height="73" position="flex-start" darkWidth="380" darkHeight="73" showCaption="false"}
:::

:::WorkflowBlockItem
**Edit the suggestion if necessary**

Adjust the generated text to suit your organization's needs.
:::

:::WorkflowBlockItem
**Click Save**

The instructions will be saved and displayed to the applicant when they open the form.
:::
::::



![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/sXrs-HNrJPsLGYf7MnG4m_image.png)

***

## 5.2 - Attach knowledge base

You can attach a knowledge base document so that the AI ​​can generate comments on the ticket. By reading the document, the AI ​​can, for example, provide tips on how to resolve the issue.

The AI ​​only generates comments on tickets for this activity when there is a linked knowledge base article that serves as context. Only one article can be linked.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/skpB1IQxNFLe0Q8_h-_bK_formulario-orientacoes-anexar-conhecimento.gif)

# <font color="#ffffff">6 - Preview</font>

***

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/iFVv_3ppbhqNUp7Gru8fp-20260122-141419.gif)

To view and test the form before publishing it, click the Preview button located in the lower left corner of the form customization window. A sample preview will open with all fields configured, exactly as the requester will see when opening a ticket.

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/-0xaNL5-Uju0sXA8J4vC9_image.png)

![](https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/LCFxAdTwINCwiJii3kJFF_formulario-pre-visualizar.gif)

&#x20;
