Forms

Prev Next

Overview


The CommBox Forms module allows agents to create and send fillable forms to customers. Agents can pre-fill some or all fields on behalf of the customer and may require the customer to complete the remaining fields or simply sign the form. Customers can easily fill out, sign, and submit forms, streamlining the overall communication process.
This guide covers Forms management, creation process, and best practices.

Key Considerations


a. Once submitted, a form can no longer be edited.

b. When a form is sent, a form icon appears in the conversation summary box.

c. When the customer submits the form, a new conversation is automatically opened in the Forms channel. This new conversation contains a link to the completed form and is meant for agent remarks. It also includes a reference to the original conversation.
conversation with form outgoing and returned.png

d. Form links can be generated via an API. Learn more at our Developer Center.
Post /forms/createlink/{FORM_ID}
Post /forms/createpredefinedlink/{FORM_ID}

Forms Channel


The Forms Channel presets communication settings before and after the customer’s form submission.

  1. At the CommBox Settings page, select the Forms module (in the Settings & Tools section), and click the +Forms Channel button.
    new form channel2.png

  2. Name the new channel and click Create Channel.

  3. Modify (optional) the new channel settings:
    a. Language of instruction
    b. Legal message before signature. Consult with your legal adviser as to the content of this message.
    c. The confirmation message the customer receives after submitting the signed form.
    d. Confirmation icon image.png
    e. Limit the time (in hours) the link with the form will be available.
    f. Enable customers to download their completed form.
    new form channel settings.png

If you changed the default settings, click Save at the top of the page.

Granting Agent Permissions


Once you set up the form channel, create or edit a permission profile for the form channel, or navigate to the Agents page (in the Settings sidebar) and grant permissions to specific agents.
Note that “Viewing only” rights will not let the agents use forms with that channel or subchannel.
permissions1.png

Managing Forms


This section outlines how to work with forms in the system, including how to access, edit, share, and manage form visibility. It also explains the different ways forms can be sent to customers and what happens after a form is submitted.

Navigate to the Form listing from any Forms channel by clicking the button at the top corner
to open the Forms Listing.png

The Forms listing is where you can organize and manage the different items:

Form page items.png

Form name - Click on the form’s name to edit its content.

Form ID - Required for related APIs
Number of pages - The number of pages of the document.
Channel Name
Edit - Change the channel related to this form.
Editing chnnel of form.png

Delete - Permanently delete the Form.

Active - Only Active forms can be viewed by customers.
Note that non-active forms will not appear in the list of available forms when clicking on the form icon in the reply box or the compose section.

Public - The option Copy link appears when checking the Public option in the Form list. Click to copy the link and paste it into your message to the customer or send it directly from the reply box or compose screen by clicking the Forms icon and selecting the desired form.
Clients can also plant this link into their product and enable their customers to fill it independently of communication.

Organizing Forms into Folders


You can group multiple forms into folders for easy sharing. To create a folder:

  1. Select a Form channel and click the +New Folder at the top of the page.
  2. Name the folder.
  3. Add forms and click Save.
    new folder - update pic.png

The folder will appear after the forms.
listed folders.png

Sending Forms and Folders to Customers

From the Forms list

At the Forms list, click the copy link and paste it into the message for the customer.
If you don’t see the copy link, check the Public box, to make the link appear.
image.png

Note: Each Form has a dedicated channel, and agents must have permission for that channel for the Form to work.

From the Inbox


In the inbox, click the Forms icon.
Forms menu from inbox.png

Click on the form name to add the form to the inbox message without editing.

  • The inserted form will appear as a link on most communication channels, such as WhatsApp, SMS, Instagram, etc.
  • In Email conversations, you can click the inserted form to view it in a new tab.
  • In Chat conversations, you can’t click on the inserted form as it becomes a link only for the recipient.
    Forms menu from inbox - boxed.png

To edit the form, click the form icon next to the form's name to prefill the form you want to send. Click Insert when done.

prefilling forms when sending.png

prefilling forms when sending2.png

In email channels, you can double-click on the form link to view the prefilled form.
prefilling forms when sending3.png

From the Compose Screen:


At the Compose screen, click the Forms icon to add the form to the message you want to send.
Selecting Forms from Compose.png

After Submission


After the customer sends the form (clicking SEND at the bottom of their screen), they receive the following message with a direct link to their form.
post sending by customer.png

The signed/returned form is directed to a form channel. Clicking on the link provided enables the customer to view and save the submitted form. They can not edit the form at any time.
If you assign this customer to yourself, the conversation will be added to your assigned conversations. Click on the link in the conversation list to view the signed form.
form recieved.png

Creating New Forms


Creating and managing forms requires an admin status or an agent with granted admin permissions for forms (found in the General section of the permission list).
Forms have fillable fields that are created on top of a PDF image, or on a blank page. In our example, we will download an existing PDF and create the fields for filling it out and signing it.

  1. At the selected Forms channel, click on Click here to set up forms which will open a list of all existing forms.
    image.png

  2. Click on +New Form at the top of the page to create a new form.
    image.png

  3. At the dialog box, fill in the general information about your form:
    a. Enter the form’s name
    b. Select the type of template that will be sent to the customer (in our example, a PDF we preloaded).
    c. Select the Form channel for the new form. The above sections explain how to create and set up Form channels.
    d. Once you select a channel, you can upload files. Click the button and upload the form you want the customer to fill in.
    e. Click Save.
    image.png

  4. As the form opens, move your mouse to the location where you want the customer to fill in information and double click at that spot.
    new form4.png
    a. Name the field (no spaces)
    b. Select the Type of data the field will contain based on the expected answers of the customer.
    image.png
    c. Mandatory field – Checking this box will prevent the customer from returning the form with this field empty.
    d. Custom Fields – If the information in this field matches a specific field in the Customer Information pane, you may select this custom field to be populated automatically when the customer submits the form. For example, when setting the field for the First name, select the First name form the custom field list.
    image.png
    Note: The menu will only include fields that match the type of data of the custom field. For example, when choosing a field restricted to numeric inputs, you will be able to select only Customer Fields designated for numerical data, such as phone numbers.
    e. Dependent field – This field will appear only if another field (selected from the menu) has content. For example, if the customer checks a checkbox field A, field x and field y will appear. When setting up Field X in the form, select Field A from the Dependent Field menu.
    f. Click Add to save the field.
    Note that sometimes the field will “miss the target”. If that happens, click and drag the box to the correct location in the form

  5. Add additional fields as needed (repeat step 4) and click Save when done.
    Note:
    Note that sometimes the field will “miss the target”. If that happens, click and drag the box to the correct location in the form.

When customers fill out forms, many tend to click the Tab key to jump to the next field. Keep this in mind when creating a form since the order the Tabs when filling out the fields follows the order they were created.

Best Practice

  1. Custom Fields: Use auto-filled fields to save time (e.g., first name, phone number).
  2. Dependent Fields: Make forms dynamic by showing fields only when needed.
  3. Adjust Field Sizes: Ensure field sizes match the form's layout.
  4. Conditional Signatures: Set up fields that must be completed before the signature field appears.

Some of the features we used in our example:
• The first and last name were entered automatically by the custom fields.
• The business name was entered by the agent before sending the document.
• In section 3a, the box for entering the Corp type’s letter was dependent on the LLC checkbox.
dependent field.png

dependent field2.png

• Changing the field size, changes the size of the information entered. Make larger or smaller to fit the form’s provided space.
• The signature was dependent on completing another field and appeared only after the customer filled it that other field.
image.png