For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Login
HomeDocs
HomeDocs
    • Work with scripted bots
    • Before you begin
    • Build and maintain your bot
      • Work with blocks and apps
        • Build Answers using blocks
        • Serve content using Message blocks
        • Save chatter information using the Capture block
        • Save content in variables using the Set Variable block
        • Target content to chatters using the Conditional block
        • Create selectable menus using the List Option block
        • Serve time-specific content using the Scheduled block
        • Make API requests using the HTTP Request block
        • Calculate values using the Answer Utilities block
        • Format dates using the Answer Utilities block
        • Increment values using the Answer Utilities block
        • Format and validate text using the Answer Utilities block
        • Search for and replace text using the Answer Utilities block
        • Let chatters upload files using the File Upload block
        • Transfer chatters from one Answer to another using the Redirect block
        • Let chatters advance to other Answers with the Quick Replies block
        • Create scrollable menus using the Carousel block
        • Let chatters select dates using the Date Picker app
        • Generate a chat transcript using the Fetch Chat Metadata block
        • Send emails using the Email app
      • Train and manage Answers
      • Create conversations
      • Personalize conversations
      • Change your bot's look and feel
      • Test your bot
      • Manage your bot and your team
      • Understand the settings chatters can control
      • Create phone conversations with Voice
    • Integrate Ada with other tools
    • Use Ada with your website
    • Measure success
Login
LogoLogo
On this page
  • Overview
  • Requirements
  • Configure the File Upload Block
  • Chatter Experience
  • Cancelling an Upload
  • Agent Experience
  • Zendesk
  • Salesforce
  • Related Articles
Build and maintain your botWork with blocks and apps

Let chatters upload files using the File Upload block

Previous

Transfer chatters from one Answer to another using the Redirect block

Next
Built with

Overview

The File Upload block lets your chatters upload files to your Salesforce or Zendesk Support team directly from Ada. You place the block in an Answer with either the Zendesk Ticketing or Salesforce block. Once triggered, the block initiates the native file system of the chatter’s device, which they’ll use to locate and select the file to upload. The uploaded file attaches to the support ticket.

Any files that chatters upload remain available for 7 days. After that, Ada automatically deletes those files, without keeping any backups.

Requirements

File Upload works in conjunction with either of the following features:

  • Zendesk Ticketing app

  • Salesforce Action block

Configure the File Upload Block

Place the File Upload block in an Answer at the point where the file upload interaction should occur. Once the block is placed, setting it up is quite simple.

  1. In your handoff Answer, Drag and drop the File Upload block into position, at the point in the Answer where you want the chatter to upload the file.

    Insert the File Upload block in your handoff Answer at a position preceding the support block. The chatter must upload their file before the support block triggers.

  2. In the File Upload block, complete the fields under the Configuration and Save Response as Variables sections. For optional fields or variables, click the drop-down menus under each section.

    ConfigurationDescription

    Accepted File Types

    Enter the extensions of acceptable file types. Include the dot in the extension. Separate multiple items with commas.

    Supported extensions: .csv, .doc, .docx, .gif, .jpeg, .jpg, .mov, .mp3, .mp4, .pdf, .png, .ppt, .pptx, .svg, .txt, .wav, .xls, .xlsx, .zip

    Maximum File Size (MB) [optional]

    Enter a value to set a file size limit in megabytes (MB), up to a maximum of 100 MB. Use numbers only.

    Save Response as VariablesDescription

    File URL

    Set a variable to capture the pre-signed URL of the chatter’s uploaded file.

    File Data Token

    Set a variable to capture the file data token, which gives your team access to the uploaded file on the Ada server.

    Attach this variable to the File Data Token field in your support block.

    File Name[optional]

    Set a variable to capture the file name of the chatter’s uploaded file.

  3. At the bottom of the Answer, click Save.

  4. In the handoff block (either the Zendesk Ticketing app or the Salesforce Action block), in the Select Optional Inputs field, enter the file data token variable you set above. Doing so links the file upload with the chat handoff, so that your bot knows to include the file with the handoff.

Chatter Experience

When the chatter encounters the File Upload block during the course of the handoff Answer, they are presented with a widget in the chat window. The widget displays:

  • The accepted file types

  • The maximum file size allowed

  • A link titled Select file

When the chatter clicks the Select file link, the native file navigation view for their device displays. The chatter simply chooses a file and clicks the execute button, usually titled Open. The navigation view disappears, and the upload widget in the chat window shows a file icon and the file name. A Submit File button also appears. The chatter clicks this to upload the file. The widget displays a File successfully uploaded message with a friendly green thumbs up for good measure.

Cancelling an Upload

The File Upload block uses the Cancel Capture Answer, in case the chatter chooses not to upload a file. When the Upload File widget displays, the Cancel Capture Answer’s Never mind button appears beneath it. Clicking this cancels the file upload process, and the handoff flow ends.

Keep the Cancel Capture behavior in mind when adding the File Upload block to your handoff Answer. In certain circumstances, it may be necessary to use a Conditional block to display the block to the chatter only if they explicitly agree or request to upload a file.

Agent Experience

The agent experience varies depending on which support platform your organization uses.

Zendesk

When a file is shared with your Zendesk Support team, the agent assigned to the ticket will see the transferred file right on the ticket itself. From there, they can click to open the file and review its content. The file appears on the main area of the Zendesk dashboard, below the transcript at the bottom of the ticket workspace.

Salesforce

The uploaded file attaches to the Salesforce Case created for the chatter.

On the Salesforce dashboard, go to Cases, open the Case ticket, then click the Related tab. The file appears under the Attachments section.

Related Articles

Zendesk Ticketing App

Salesforce block

Fetch Chat Metadata


Have any questions? Contact your Ada team, or email us at help@ada.cx.