> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/dynamic-components/components/microphone.md).

# Microphone

The Avonni Microphone component lets users record audio directly within a Dynamic Component page or Flow. Use it to capture voice notes, meeting summaries, audio feedback, or any other spoken input — with optional file storage as Salesforce ContentDocument objects.

## Overview

The Microphone supports single or multiple recordings, an optional real-time audio visualizer, and flexible file-saving options. Typical use cases include:

* Capture voice notes for customer interactions on Account or Contact pages.
* Record meeting summaries linked to project records.
* Collect audio feedback in support cases or surveys.
* Log verbal instructions for field service tasks.
* Store training session recordings linked to custom objects.

## Configuration

To configure the Microphone, select it on the canvas. The **Edit Microphone** panel opens on the right with two tabs: **Properties** and **Interactions**. The sections below mirror the Properties tab.

### Properties

#### Save as Content Document

Enable **Save as Content Document** to allow recordings to be saved as ContentDocument files in Salesforce. When this is on, three additional settings become available:

* **Auto Save Content Document** — When enabled, recordings are automatically saved as a ContentDocument without requiring the user to click a save button. Requires: **Save as Content Document** enabled.
* **Content Document Title** — The title assigned to the saved file. Defaults to `Untitled`. Requires: **Save as Content Document** enabled.
* **Content Document Linked Entity Id** — The record ID to link the saved file to (for example, a Case or Account ID). Requires: **Save as Content Document** enabled.

#### Allow Multiple Recordings

Enable **Allow Multiple Recordings** to let users record several audio clips in a single session instead of just one.

* **Value** — Stores the recorded audio data for a single recording. Available when **Allow Multiple Recordings** is off.
* **Value Collection** — Stores the collection of recorded audio data when multiple recordings are enabled. Available when **Allow Multiple Recordings** is on.

#### Show Visualizer

Enable **Show Visualizer** to display a real-time audio waveform while the user is recording or playing back audio. Disabled by default.

### Labels

The **Labels** section (collapsed by default) lets you customize the text of every UI element in the Microphone. All labels have sensible defaults.

| Setting                   | Default     | Description                                 |
| ------------------------- | ----------- | ------------------------------------------- |
| **Ready Label**           | `Ready`     | Label for the ready state indicator.        |
| **Recording Label**       | `Recording` | Label shown while recording is in progress. |
| **Paused Button Label**   | `Paused`    | Label for the paused state indicator.       |
| **Cancel Button Label**   | `Cancel`    | Label for the cancel button.                |
| **Start Button Label**    | `Start`     | Label for the start recording button.       |
| **Done Button Label**     | `Done`      | Label for the done button.                  |
| **Save Button Label**     | `Save`      | Label for the save button.                  |
| **Delete Button Label**   | `Delete`    | Label for the delete button.                |
| **New Button Label**      | `New`       | Label for the new recording button.         |
| **Rename Button Label**   | `Rename`    | Label for the rename button.                |
| **Pause Button Label**    | `Pause`     | Label for the pause button.                 |
| **Resume Button Label**   | `Resume`    | Label for the resume button.                |
| **Download Button Label** | `Download`  | Label for the download button.              |

### Set Component Visibility

All components support conditional visibility — see [Component Visibility](/dynamic-components/core-concepts/component-visibility.md).

## Interactions

[Interactions](/dynamic-components/component-builder/interactions.md) define what happens when users interact with the Microphone. Configure them from the **Interactions** tab of the Edit Microphone panel.

### Save As Button Click

Fires when the user clicks the save button on a recording. Use this to react after a recording is saved — for example, show a confirmation toast, navigate to another page, or update a record using the recorded audio value.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/dynamic-components/components/microphone.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.