How to Use Voice Notes and Attachments in Live Chat Widgets
Learn how visitors can send voice notes, audio, images, PDFs, and attachments in GHL Customer Care Live Chat Widgets and manage them in Conversations.
Assistants need to reach this page over the internet. While it is only running on your machine, these two buttons will not be able to load it.
On this page
- What are Voice Notes and Attachments in Live Chat Widgets?
- Key Benefits of Voice Notes and Attachments in Live Chat Widgets
- Supported Message Types, File Types, and Limits
- Supported visitor actions
- Supported image and document file types
- Supported audio behavior
- File limits
- Uploading Files and Voice Notes From the Visitor Side
- Uploading files from website
- Recording and sending a voice note
- How To Setup Voice Notes and Attachments in Live Chat Widgets
- Reviewing Attachments and Voice Notes in Conversations
- Using Conversation AI With Images and Voice Notes
- Troubleshooting Voice Notes and Attachments
- Frequently Asked Questions
- Related Articles
Live Chat Widgets now make it easier for website visitors to share context without typing long messages. Visitors can send files, images, PDFs, audio files, and voice notes directly from the widget, including attachment-only messages. Your team can review these messages in Conversations, and Conversation AI can respond to supported images and voice notes when enabled.
TABLE OF CONTENTS
- What are Voice Notes and Attachments in Live Chat Widgets?
- Key Benefits of Voice Notes and Attachments in Live Chat Widgets
- Supported Message Types, File Types, and Limits
- Uploading Files and Voice Notes From the Visitor Side
- How To Setup Voice Notes and Attachments in Live Chat Widgets
- Reviewing Attachments and Voice Notes in Conversations
- Using Conversation AI With Images and Voice Notes
- Troubleshooting Voice Notes and Attachments
- Frequently Asked Questions
- Related Articles
What are Voice Notes and Attachments in Live Chat Widgets?
Voice notes and attachments let website visitors send more than plain text through GHL Customer Care’s Live Chat Widget. Visitors can upload supported files, send audio attachments, or record voice notes directly inside the widget. These messages appear in Conversations, where agents can review, preview, play, download, or respond based on the file type.
Key Benefits of Voice Notes and Attachments in Live Chat Widgets
- Faster visitor communication: Visitors can upload files, send audio, or record voice notes instead of typing long explanations.
- Better context for agents: Screenshots, PDFs, images, and voice notes help agents understand the issue before replying.
- Attachment-only messages: Visitors can send files or audio without being required to add text.
- Audio preview before sending: Visitors can review a recorded voice note before submitting it.
- Inline audio playback: Audio messages render as playable audio cards with controls for play, pause, seeking, mute, restart, and playback speed.
- Improved AI workflows: Conversation AI can process supported images and voice notes when the correct AI response settings are enabled.
- Cleaner widget controls: Sub-account users can choose whether the attachment and microphone icons appear in the Live Chat Widget.
Supported Message Types, File Types, and Limits
Supported file rules help protect the visitor experience and prevent unsupported or oversized files from being sent through the widget. Use the formats below to make sure visitors can share files successfully and agents can open them in Conversations.
Supported visitor actions
Visitors can:
- Record and send voice notes from the Live Chat Widget.
- Upload supported audio files.
- Upload supported image and document files.
- Send files, audio, or voice notes without adding text.
- Preview audio before sending.
- Track upload progress while files are being attached.
Supported image and document file types
.jpg.jpeg.png.heic.pdf
JPG and PNG files can show inline previews, while HEIC and PDF files may appear as downloadable filenames instead of inline previews.
Supported audio behavior
Voice notes and audio attachments display as playable audio cards in the widget and Conversations. The inline player includes:
- Play/Pause
- Waveform
- Seek controls
- Mute/Unmute
- 1×, 1.5×, and 2× playback speed
- Restart audio
Conversation AI Audio Response supports voice notes and audio file inputs. Existing Conversation AI audio documentation lists supported uploaded audio formats such as OGG, MP3, MP4 audio-only, AAC, M4A, and MPEG.
File limits
- Max files per message: Up to 5 files.
- Per-file size limit: Upto 25 MB.
- Unsupported file types, oversized files, and duplicate file selections may be blocked automatically.
Uploading Files and Voice Notes From the Visitor Side
The visitor-side upload flow is designed to be simple on desktop and mobile. Visitors can use the attachment icon to upload files, drag files into the widget on desktop, or use the microphone icon to record a voice note.
Uploading files from website
- Open the Live Chat Widget on the website.
- Click the attachment icon or drag supported files into the chat composer.
- Select the file or files to attach.
- Wait for the upload progress indicator to complete.
- Send the message.
Visitors can send attachment-only messages, so a typed message is no longer required when sending supported files or audio.
All 5 steps in this procedure
- Open the Live Chat Widget on the website.
- Click the attachment icon or drag supported files into the chat composer.
- Select the file or files to attach.
- Wait for the upload progress indicator to complete.
- Send the message.
Recording and sending a voice note
- Open the Live Chat Widget. Click or tap the microphone icon.
- Allow microphone access when the browser prompts for permission.
- Record the voice note.
- Preview the audio before sending.
- Send the voice note.
If microphone permission is denied, the widget shows an actionable toast message so visitors know how to fix the issue.
All 5 steps in this procedure
- Open the Live Chat Widget. Click or tap the microphone icon.
- Allow microphone access when the browser prompts for permission.
- Record the voice note.
- Preview the audio before sending.
- Send the voice note.
How To Setup Voice Notes and Attachments in Live Chat Widgets
Proper setup ensures visitors can send the right message types and your team can review them in Conversations. Since Live Chat must be installed and embedded on your website before messages can route into Conversations, start by confirming the widget is active, configured correctly, and available to visitors.
- Go to Sites → Chat Widget. Create or open a Live Chat Widget.
Step 1 of 7: Go to Sites → Chat Widget. Create or open a Live Chat Widget What this shows Step 1 of 7: Go to Sites → Chat Widget. What this shows Shows where to go for step 1 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". This screenshot accompanies step 1 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". At this point in the walkthrough you go to Sites → Chat Widget. Create or open a Live Chat Widget. The next step is to go to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files. Where to goGo to Sites → Chat Widget. Create or open a Live Chat Widget. Buttons and menus referenced Sites → Chat WidgetChat Window → Additional OptionsAllow sending voice notesAllow sending attachmentsConversationsNext stepGo to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files.All 7 steps in this procedure
- Go to Sites → Chat Widget. Create or open a Live Chat Widget. this image
- Go to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files.
- Save the widget.
- Embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care.
- Open the website as a visitor and test the widget.
- Send a file, an attachment-only message, and a voice note.
- Confirm each message appears correctly in Conversations.
- Go to Chat Window → Additional Options.
Confirm Allow sending voice notes is enabled if visitors should send voice notes.
Confirm Allow sending attachments is enabled if visitors should upload files.Step 2 of 7: Go to Chat Window → Additional Options. Confirm Allow sending voice… What this shows Step 2 of 7: Go to Chat Window → Additional Options. What this shows Shows where to go for step 2 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". This screenshot accompanies step 2 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". At this point in the walkthrough you go to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files. The next step is to save the widget. Where to goGo to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files. Buttons and menus referenced Chat Window → Additional OptionsAllow sending voice notesAllow sending attachmentsSites → Chat WidgetConversationsNext stepSave the widget.All 7 steps in this procedure
- Go to Sites → Chat Widget. Create or open a Live Chat Widget.
- Go to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files. this image
- Save the widget.
- Embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care.
- Open the website as a visitor and test the widget.
- Send a file, an attachment-only message, and a voice note.
- Confirm each message appears correctly in Conversations.
- Save the widget.
Step 3 of 7: Save the widget What this shows Step 3 of 7: Save the widget. What this shows Shows how to confirm for step 3 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". This screenshot accompanies step 3 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". At this point in the walkthrough you save the widget. For context, this section explains: Proper setup ensures visitors can send the right message types and your team can review them in Conversations. Since Live Chat must be installed and embedded on your website before messages can route into Conversations, start by confirming the widget is active, configured correctly, and available…. The next step is to embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care. How to confirmSave the widget. Buttons and menus referenced Sites → Chat WidgetChat Window → Additional OptionsAllow sending voice notesAllow sending attachmentsConversationsNext stepEmbed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care.All 7 steps in this procedure
- Go to Sites → Chat Widget. Create or open a Live Chat Widget.
- Go to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files.
- Save the widget. this image
- Embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care.
- Open the website as a visitor and test the widget.
- Send a file, an attachment-only message, and a voice note.
- Confirm each message appears correctly in Conversations.
- Embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care.
Step 4 of 7: Embed the widget on your website by copying the Chat Widget embed code… What this shows Step 4 of 7: Embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the… What this shows Shows what this covers for step 4 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". This screenshot accompanies step 4 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". At this point in the walkthrough you embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care. The next step is to open the website as a visitor and test the widget. What this coversEmbed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care. Buttons and menus referenced Sites → Chat WidgetChat Window → Additional OptionsAllow sending voice notesAllow sending attachmentsConversationsNext stepOpen the website as a visitor and test the widget.All 7 steps in this procedure
- Go to Sites → Chat Widget. Create or open a Live Chat Widget.
- Go to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files.
- Save the widget.
- Embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care. this image
- Open the website as a visitor and test the widget.
- Send a file, an attachment-only message, and a voice note.
- Confirm each message appears correctly in Conversations.
- Open the website as a visitor and test the widget.
- Send a file, an attachment-only message, and a voice note.
- Confirm each message appears correctly in Conversations.
Step 7 of 7: Confirm each message appears correctly in Conversations What this shows Step 7 of 7: Confirm each message appears correctly in Conversations. What this shows Shows how to confirm for step 7 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". This screenshot accompanies step 7 of 7 in the "How To Setup Voice Notes and Attachments in Live Chat Widgets" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". At this point in the walkthrough you confirm each message appears correctly in Conversations. How to confirmConfirm each message appears correctly in Conversations. Buttons and menus referenced ConversationsSites → Chat WidgetChat Window → Additional OptionsAllow sending voice notesAllow sending attachmentsAll 7 steps in this procedure
- Go to Sites → Chat Widget. Create or open a Live Chat Widget.
- Go to Chat Window → Additional Options. Confirm Allow sending voice notes is enabled if visitors should send voice notes. Confirm Allow sending attachments is enabled if visitors should upload files.
- Save the widget.
- Embed the widget on your website by copying the Chat Widget embed code and adding it to your site, or by enabling the widget through the website or funnel settings if the page is built in GHL Customer Care.
- Open the website as a visitor and test the widget.
- Send a file, an attachment-only message, and a voice note.
- Confirm each message appears correctly in Conversations. this image
Reviewing Attachments and Voice Notes in Conversations
Conversations gives agents a centralized place to review visitor messages, files, and voice notes. Since Live Chat messages route into Conversations, agents can manage visitor context without switching tools.
Agents can review inbound files and voice notes from the conversation thread:
- JPG and PNG files may show inline previews.
- HEIC and PDF files may appear as downloadable filenames.
- Audio messages render as playable audio cards instead of raw links.
- Agents can preview, play, download, or respond based on the file type.
- Files may be saved to the Media Library or added to the contact’s Documents tab when available from the message options.
All 5 steps in this procedure
- JPG and PNG files may show inline previews.
- HEIC and PDF files may appear as downloadable filenames.
- Audio messages render as playable audio cards instead of raw links.
- Agents can preview, play, download, or respond based on the file type.
- Files may be saved to the Media Library or added to the contact’s Documents tab when available from the message options.
Using Conversation AI With Images and Voice Notes
Conversation AI can respond to richer visitor messages when image and voice note response settings are enabled for the AI Agent. Based on your workflow, you can allow the bot to respond to images, voice notes, or both. This helps the bot use visual or audio context from the visitor’s message instead of relying only on typed text.
To enable Conversation AI responses for images, voice notes, or both:
- Go to AI Agents → Conversation AI → Agent List.
- Click the three dots next to the bot you want to configure. Select Edit.
Step 2 of 4: Click the three dots next to the bot you want to configure. Select Edit What this shows Step 2 of 4: Click the three dots next to the bot you want to configure. What this shows Shows what to choose for step 2 of 4 in the "Using Conversation AI With Images and Voice Notes" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". This screenshot accompanies step 2 of 4 in the "Using Conversation AI With Images and Voice Notes" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". At this point in the walkthrough you click the three dots next to the bot you want to configure. Select Edit. This part of the guide covers 2 fields, listed below. The next step is to enable one or both options under Bot Settings → Also allow this bot to respond to. What to chooseClick the three dots next to the bot you want to configure. Select Edit. Fields in this part of the guide ImagesVoice NotesButtons and menus referenced EditAI Agents → Conversation AI → Agent ListBot Settings→Also allow this bot to respond toImagesVoice NotesNext stepEnable one or both options under Bot Settings → Also allow this bot to respond to:All 4 steps in this procedure
- Go to AI Agents → Conversation AI → Agent List.
- Click the three dots next to the bot you want to configure. Select Edit. this image
- Enable one or both options under Bot Settings → Also allow this bot to respond to:
- Save your changes.
- Enable one or both options under Bot Settings → Also allow this bot to respond to:
- Images
- Voice Notes
- Save your changes.
Step 4 of 4: Save your changes What this shows Step 4 of 4: Save your changes. What this shows Shows how to confirm for step 4 of 4 in the "Using Conversation AI With Images and Voice Notes" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". This screenshot accompanies step 4 of 4 in the "Using Conversation AI With Images and Voice Notes" section of "How to Use Voice Notes and Attachments in Live Chat Widgets". At this point in the walkthrough you save your changes. For context, this section explains: Conversation AI can respond to richer visitor messages when image and voice note response settings are enabled for the AI Agent. Based on your workflow, you can allow the bot to respond to images, voice notes, or both. This helps the bot use visual or audio context from the visitor’s message…. This part of the guide covers 2 fields, listed below. How to confirmSave your changes. Fields in this part of the guide ImagesVoice NotesButtons and menus referenced AI Agents → Conversation AI → Agent ListEditBot Settings→Also allow this bot to respond toImagesVoice NotesAll 4 steps in this procedure
- Go to AI Agents → Conversation AI → Agent List.
- Click the three dots next to the bot you want to configure. Select Edit.
- Enable one or both options under Bot Settings → Also allow this bot to respond to:
- Save your changes. this image
When Images is enabled, Conversation AI can analyze supported customer-shared images and reply with context-aware messages. Supported image types currently include JPG, JPEG, and PNG. HEIC files may be uploaded as Live Chat attachments, but HEIC support for AI image response may be limited.
When Voice Notes is enabled, Conversation AI can process supported audio by transcribing the voice note, passing the transcript to the bot, and generating a context-aware reply. If Conversation AI voice note handling is enabled, the bot can process and reply to voice notes automatically. If it is disabled, the configured fallback messaging is shown.
Note: PDFs are not supported for Conversation AI image response.
Troubleshooting Voice Notes and Attachments
Troubleshooting upload and recording issues helps visitors complete the conversation without abandoning the chat. Most issues are caused by unsupported file types, large files, duplicate attachments, browser permissions, or slow network connections.
- File is too large: Compress the file or choose a smaller version.
- File type is not supported: Convert the file to a supported format before uploading.
- Duplicate file warning appears: Remove the duplicate and attach a different file.
- Upload is slow: Wait for the progress indicator to complete or try again on a stronger connection.
- Drag-and-drop does not work: Drag the file from the computer’s file explorer or use the attachment icon instead.
- Microphone permission is denied: Allow microphone access in the browser settings and try recording again.
- AI does not respond to an image or voice note: Confirm the correct AI Agent setting is enabled for Images or Voice Notes.
Frequently Asked Questions
Q: Can visitors send attachments without typing a message?
Yes. Visitors can send attachment-only messages from the Live Chat Widget.
Q: Can visitors record voice notes inside the Live Chat Widget?
Yes. When Allow sending voice notes is enabled, visitors can record, preview, and send voice notes directly from the widget.
Q: Can I turn off file uploads but keep voice notes enabled?
Yes. The attachment and voice note options are controlled separately, so you can enable or disable each one based on the experience you want visitors to have.
Q: Can visitors send PDFs?
Yes. PDFs are supported as Live Chat attachments, but they may appear as downloadable filenames instead of inline previews.
Q: Can Conversation AI read PDFs sent through Live Chat?
No. Conversation AI image response is for supported image formats. PDFs are not currently supported for AI image response.
Q: Can Conversation AI respond to voice notes?
Yes, when voice note response is enabled for the bot. GHL Customer Care transcribes the audio and passes the transcript to the bot so it can respond.
Q: Will the bot reply with an audio message?
No. Conversation AI typically replies using standard channel messages, usually text, for compatibility.
Q: Why do HEIC files not preview inline?
HEIC files may be uploaded as Live Chat attachments, but they may not preview inline depending on browser support. Download the file and open it locally if preview is unavailable.
Related Articles
Frequently asked questions
What are Voice Notes and Attachments in Live Chat Widgets?
Was this guide helpful?