Agent file sharing overview

  • Messaging

Agent file sharing enables agents and bots to share files with consumers. At this phase, photos and certain file types can be shared via Web Messaging, Apple Messages for Business, and WhatsApp Business. In the future, more file formats will be supported.

Agents will now be able to share files with consumers to answer questions that can be better explained using images. For example, a screenshot for tech support or a product photo for sales uses cases.

Enabling the feature

To enable “Agent file sharing” capability on your LivePerson Conversational Cloud account, please contact your LivePerson account team.

Night Vision setting

To enable the agent file sharing capability, brands have to enable the feature via Night Vision. Click on the Night Vision icon in the top right corner (the blue icon). From there, Go to the visitor's tab > Agent Workspace configuration > File Sharing:


Click on file sharing and enable the feature:


Consumer-side configuration

To display the attachment icon in the consumer window, select the ‘Menu elements’ dropdown in the Engagement window studio, and check the box that says ‘Send image' (Messaging only). The campaign must be republished for the icon to be displayed.




The agent file sharing capability is permission-based. New permissions have been added to both agent and agent manager profiles: “Send files to consumers from the local file browser.”

The permission is off by default. Additional permissions have been added as well in regards to custom widgets. This permission is covered more in-depth below.


Using file sharing

A new attachment icon has been added above the agent’s input message area:


The icon will be visible only to users with the appropriate permission.

If the channel from which the conversation was initiated does not support receiving files, the icon will be greyed out and will not be clickable. In this phase, the icon will be visible only in Web Messaging conversations.

Clicking on the attachment icon will open the agent local file browser dialog:


The list of files presented will be filtered to present only supported file types (“Custom files”): JPEG, JPG, PNG, GIF, PDF, DOCx, XLSx, and PPTx.

When the agent chooses a photo, a preview of the photo will be presented and the agent will be able to add a caption and send the photo.


The file will appear in the transcript:


There is no preview available for files, only photos.


Agents will be able to download the file from the transcript.


Once clicking on the file it will be opened in full-page mode:


Agents will be able to keep writing in the input area while the file browser dialog is open and navigate to other conversations. While the image is being loaded, the agent will be able to send additional messages. They will also be able to move to another conversation window while the loading process continues.

The consumer will receive the file as part of the conversation. When the consumer clicks on the file, it will pop up for a full-screen view.



File storage, retention, and encryption

  • Files are hosted by LivePerson.
  • Files will undergo sanitation by LivePerson (to check they are not malicious).
  • Files retention is set to 13 months.
  • GDPR: Files will be deleted from LivePerson’s storage in case of consumer’s right-to-be-forgotten request as described on our Developer Center: Personal data deletion API
  • Files are encrypted at rest.

This solution is not PCI compliance certified.

File Sanitation

When uploading or when receiving a file, it will be processed by a service called "MetaDefender" for sanitation. MetaDefender accomplishes various functions:

Prevent Attacks without Relying on Detection

MetaDefender deep content disarm and reconstruction capabilities do not rely on detection. The service assumes all files could be infected and rebuilds their content using a secure and efficient process. It guarantees the output of safe and usable files by rebuilding a new file from scratch and discarding the original. Deep content disarms and reconstruction (Deep CDR) is extremely effective in preventing targeted attacks, ransomware, and other types of known and unknown malware threats.

Highest Threat Detection with Multiscanning

MetaDefender multiscanning uses multiple anti-malware engines to provide superior detection rates of known and unknown threats and delivers extremely fast malware outbreak prevention. MetaDefender customers can simultaneously leverage the combined threat prevention capabilities to query more than 30 anti-malware engines using both signature heuristic scanning and machine learning capabilities.

Detect Vulnerable Software Before Installation

All applications contain vulnerabilities of different degrees of severity that threat actors can exploit. Our file-based vulnerability assessment of binaries and installers detects known vulnerabilities within files and application vulnerabilities in software programs before they are installed on endpoint devices, including IoT devices. MetaDefender supports vulnerability detection for over 1 million files and over 20,000 applications.

Photo resizing

Before uploading a photo, it will be resized so that the longer dimension of the image will be set to 800 pixels.

To set a different pixels value, please contact your LivePerson account team.


Agent Custom Widget SDK

A new ‘Send File’ command has been added to the Agent Custom Widget SDK, allowing brands to send files to consumers. The file needs to be provided as a File object or Blob object.

Once the command is sent, the preview of the file will be displayed, allowing the agent to add a caption, send, or cancel.

For this to be enabled, the user must have the following privileges enabled:

“Send files to consumers from custom widgets” (off by default)

Agent Node SDK

Bots will have the capability to send files as well. For further details and examples, please visit the Agent Node SDK Git repo: File Sharing Bot

Limitations and clarifications

  • Supported file types: JPEG, JPG, PNG, GIF, PDF, DOCx, XLSx, PPTx.
  • The capability is currently supported only on Web Messaging, Apple Messages for Business, and WhatsApp Business.
  • The file size will be limited to 5MB.
  • Authenticated consumers who receive a file from an agent over the web will see an empty line in the native app if the file was sent without a caption or only the caption.

Web experience:



App experience:


  • The permissions to use the feature will be presented once the feature has been enabled by the account team. However, the feature will only be usable after it has been turned on in the account settings.
  • If a conversation was resumed and then closed, file sharing will be disabled as a way to resume the conversation again (the agent will not be able to send a file to the conversation).
  • Custom widgets cannot send a file as a way to resume a conversation.
  • Animated gifs are not supported (will be sent as a static gif).

Configuration steps summary

  1. Enable the feature
  2. Enable the "file sharing capability" on night vision
  3. Set permissions
  4. Optional: Changing the image resolution

Missing Something?

Check out our Developer Center for more in-depth documentation. Please share your documentation feedback with us using the feedback button. We'd be happy to hear from you.