Transfer File to Agent

Give users the ability to transfer files during a chat so they can share information about their issues.

The legacy chat product is scheduled for retirement on February 14, 2026, and is in maintenance mode until then. During this phase, you can continue to use chat, but we no longer recommend that you implement new chat channels. To avoid service interruptions to your customers, migrate to Messaging for In-App and Web before that date. Messaging offers many of the chat features that you love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in Help.

The agent can request that the user transfer a file by clicking the Attach File button from the Service Cloud Console.

Attach file in Service Cloud

See Transfer Files During a Chat in Salesforce Help for details about setting up this functionality in the Service Cloud Console.

With the default UI, the user sees a FILE TRANSFER REQUESTED message in the app and can then send a file using the camera button.

Attach file from app

If you’re using the default UI, no coding is necessary in your app to get this behavior.

However, if you’re using the Core API, you must present your own file transfer UI based on file transfer events. Create a FileTransferRequestListener and pass it to the ChatClient using the addFileTransferRequestListener method. This listener gives you access to two events.

onFileTransferRequest: The SDK calls this method when an agent requests a file transfer. You're given a FileTransferAssistant object, which lets you upload a file with the uploadFile method.
onFileTransferStatusChanged: The SDK calls this method when the status of a file transfer has changed. You're given a FileTransferStatus enumerated type that describes the status of the file transfer.

You can use the following code sample as a starting point for your listener implementation.

In Java:

In Kotlin: