Skip to content
This site is under construction. Content, screenshots, and workflows may change at any time.

Attachments

Attachments let visitors and agents send files to each other while a person on your team is handling the conversation. Use them for screenshots, invoices, or short screen recordings.

Agents attach files with Attach files in the inbox composer. Visitors attach files from the chat window once they’re talking to your team.

Before you start

  • Visitors can only attach files during human support, after they’ve connected to your team. See Human handoff.
  • Agents need a role that can reply in live chat: Owner, Team Admin, Bot Admin, Bot Editor, or Chat Agent.

Turn visitor attachments on or off

Visitor attachments are on by default. The Chat bubble always allows them. The Center stage and Help page channels each have a switch.

  1. Open the channel. Go to Bot > Channels and open Center stage or Help page.

  2. Find the setting. On the Display tab, under Capabilities, find Attachments. On Center stage it reads “Allow visitors to upload files during human support.”

  3. Save. Turn the switch on or off, then select Save changes.

On the Help page, attachments are “Available for human-only chat. Send any written question before opening the attachment composer.”

Supported files

TypeFormats
Images.jpg, .png, .gif, .webp
Video.mp4, .webm, .mov
Documents.pdf, .doc, .docx, .txt
Spreadsheets.xls, .xlsx, .csv

FluentChat checks the file’s actual content, not just its extension. A file that’s renamed to look like a supported type is rejected.

Limitations

  • Each file can be up to 5 MB. Larger files are rejected. Compress or split them first.
  • A message can carry up to 5 attachments. Send more in a second message.
  • File names can be up to 255 characters. Rename longer files before uploading.
  • Visitors can’t attach files while talking to the bot. The upload works only after the visitor has connected to your team.

Troubleshooting

”Attachments are disabled.”

Possible cause: The Attachments switch is off for this channel.

Solution: Turn it on in the channel’s Display tab, under Capabilities, and select Save changes.

”No active escalation for this chat.”

Possible cause: The visitor tried to upload while the bot was handling the conversation.

Solution: The visitor connects to your team first and sends a message. Then the upload works.

A file won’t upload

Possible cause: The file is over 5 MB, isn’t a supported type, or has an empty or very long name.

Solution: Check the supported files, reduce the size, or rename the file.

Next steps