---
schema_version: "1"
id: 50eaf9f65879ab09c8d945b633b1fe0aa317b551b73fef478fc02a3cd472c43d
title: Receive a File with an Enhanced Bot
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/service/264-0-0/bots_service_enhanced_file_inbound.md
canonical_url: https://help.salesforce.com/s/articleView?id=service.bots_service_enhanced_file_inbound.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: e654deedca48141ecf050f5d43bf0886aacfb942590888239910a79156d13f65
description: Set up your enhanced bot to request and store a file upload from a customer, so you can reduce service rep handle time by collecting files before a service rep joins the conversation. For example, request documentation related to an insurance or other reimbursement claim. Or prompt a customer for additional information about a possible issue, such as a screenshot of an error message.
products:
  - Service Cloud
  - Service Intelligence
release: "264"
---
# Receive a File with an Enhanced Bot

Set up your enhanced bot to request and store a file upload from a customer, so you can reduce service rep handle time by collecting files before a service rep joins the conversation. For example, request documentation related to an insurance or other reimbursement claim. Or prompt a customer for additional information about a possible issue, such as a screenshot of an error message.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=service.einstein_service_intro.htm&amp;language=en_US" target="_blank">View supported editions</a> for Einstein Bots.</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;"><a href="https://help.salesforce.com/s/articleView?id=service.messaging_editions.htm&amp;language=en_US" target="_blank">View supported editions</a> for Messaging.</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d71886e64">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d71886e64 ">To build and manage Einstein Bots:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d71886e64 ">
              <p>Customize Application</p>
              <p>OR</p>
              <p>Modify Metadata</p>
              <p>OR</p>
              <p style="margin-bottom:0;">Manage Bots</p>
            </td>

          </tr>
        </tbody>
      </table>

Supported file types and sizes vary by channel. See [Send Images and Files in Messaging Sessions](https://help.salesforce.com/s/articleView?id=service.livemessage_agent_send_files.htm&type=5&language=en_US).

Each File dialog step accepts one successful upload only, so keep these considerations in mind when designing your dialog.

- On most channels that support multiple file attachments, the bot end user must attach all files in one message. If the user attempts to send one file per message, the first file is saved and the bot moves to the next step in the dialog. If you expect your user to upload multiple files, include specific guidance in the Message field of your File step. A Enhanced Chat user can only send one total file to an enhanced bot.
- Create a File dialog step each time you request a file from your customer. If you reuse the same File dialog step, each customer response overwrites the variable and only the most recent file upload is stored.
- For best results, the bot end user should attach a file to a blank message. On some channels, when a message includes text and an attached file, the text and file are broken into separate messages and the text is delivered before the file. The bot recognizes the first message as the upload attempt and enters upload failure handling, if configured. Consider including specific guidance in the Message field of your File step and in any retry attempts.

1. From the Bot Builder, select **Dialogs**, and then select the dialog that you want to use to receive a file upload.
2. From the Dialog Component Library, drag the **File** dialog step onto the canvas.
3. In the Step Properties panel, in the File Interaction field, select **Receive File**.
4. Enter a message that prompts the bot end user to send a file. We recommend telling your user to attach their file to a blank message. If you expect your user to upload multiple files, tell your user to submit all files in one message.
    
    ![Message field in the Step Properties panel](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_intelligence-264-0-0-production-enus/dcd06a7b-b5ab-448b-a767-4e2e90481508/support_intelligence/images/bots/bots_service_file_inbound_message.png)
5. Select or create an ID list variable with the object type set to Content Version to store the reference to the file.
    
    ![New Id list variable with the sObject Type set to Content Version](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_intelligence-264-0-0-production-enus/dcd06a7b-b5ab-448b-a767-4e2e90481508/support_intelligence/images/bots/bots_service_file_inbound_variable.png)
6. In the Upload Success Handling section, enter a message to confirm that the end user’s file upload was successful.
    
    ![Success message field in the Step Properties panel](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_intelligence-264-0-0-production-enus/dcd06a7b-b5ab-448b-a767-4e2e90481508/support_intelligence/images/bots/bots_service_file_inbound_success.png)
7. Optionally, add upload retry attempts to prompt the end user to try again if the initial file upload fails. In the Upload Failure Handling section, include one or two retry attempts, and add details about any file type and size requirements.
    
    ![Two upload retry attempt messages in the Step Property panel](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_intelligence-264-0-0-production-enus/dcd06a7b-b5ab-448b-a767-4e2e90481508/support_intelligence/images/bots/bots_service_file_inbound_failure.png)
    
    After the bot makes these attempts, tell the bot how to resolve the issue. Specify whether the bot prompts the customer to send a file until the upload is successful or moves on to the next dialog step without filling the variable.
    
    ![Two radio buttons with the Repeat repair attempts option selected](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-service-support_intelligence-264-0-0-production-enus/dcd06a7b-b5ab-448b-a767-4e2e90481508/support_intelligence/images/bots/bots_service_file_inbound_what_next.png)
8. Save your changes. Then when you’re ready, activate your bot.

When a file upload is successful, the file is attached to the messaging session and stored in the Files page of Setup.