Visitor File Attachments

Visitors can upload files (screenshots, PDFs, spreadsheets, etc.) directly in the chat widget. The AI sees the filename and type in its context, and your agents see the file as a downloadable attachment on the message in the inbox.

How to get there: Nothing to enable — file uploads are on by default in the chat widget. Visitors click the paperclip icon inside the message input.

Supported channels

Visitors can send attachments through the chat widget, email, WhatsApp, and SMS. Agents can also send attachments outbound as part of a live chat reply. Files are stored on S3 and appear on the message in the Inbox thread regardless of which channel they came in through, so an agent handling a WhatsApp thread sees attachments the same way as one working a widget thread.

What visitors can do

Inside the widget, next to where they type a message, visitors see a paperclip icon. Clicking it opens their file picker. They can:

  • Attach up to 5 files per message
  • Upload files up to 10 MB each
  • Send common document and image formats (see limits below)

Attached files appear as chips above the input before sending. Visitors can remove a file by clicking the X on its chip.

Supported file types

Category Extensions
Images .png, .jpg, .jpeg, .gif, .webp
Documents .pdf, .doc, .docx, .txt
Spreadsheets .xls, .xlsx, .csv
Archives .zip

Files outside this list are rejected client-side with an inline error.

Limits

  • Per file: 10 MB
  • Per message: up to 5 files
  • Per session: 3 uploads per 5 minutes (rate limit to prevent abuse)

If a visitor hits the rate limit, they see a "Too many uploads. Please wait a moment and try again." message. Uploaded files that stay attached to a sent message do not count against later uploads once the window expires.

How the AI handles attachments

When a visitor sends a message with attachments, the AI is told what files were attached (filename, size, MIME type) as a hint appended to their message. For example:

Can you help me with this? (the visitor also attached: error-log.pdf — 240 KB, screenshot.png — 1.2 MB)

The AI does not read the contents of the file today. It uses the filenames and types to acknowledge the upload and route the request (e.g. "Thanks for the screenshot — an agent will take a look."). If you need OCR or PDF-content extraction on visitor uploads, that's on the roadmap but not shipped yet.

For files that need a human, escalate to live chat so an agent can open the file.

How agents see attachments

In the Inbox, attached files appear as chips underneath the visitor's message. Click a chip to download the file. Attachments are shown identically whether the visitor uploaded via widget, or an agent uploaded via the inbox reply bar.

Storage & retention

  • Files are stored in Boei's private S3 bucket under inbox-attachments/inbound/.
  • Download URLs are short-lived signed URLs — safe to share inside your team but not indefinitely public.
  • When a conversation is deleted (manually or via data retention), both the attachment records in Boei's database and the underlying files in our S3 storage are removed in the same operation. Right-to-be-forgotten requests that delete the customer's conversations therefore also physically purge the files.

Turning it off

There is no per-chatbot toggle today. If you need to disable visitor uploads for a specific bot (e.g. for compliance reasons), let us know via support and we'll add a flag on our side.