> For the complete documentation index, see [llms.txt](https://docs.maker.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maker.co/maker-greatstore/storefront/voice-chat.md).

# Voice chat

The shopper talks to the assistant hands-free: how a voice call starts, what it looks like, and how the transcript lands back in the thread.

A shopper can talk to the assistant instead of typing. Voice runs on the same conversation as text chat (it isn't a separate mode with its own history), and it works on both desktop and mobile.

## Starting a call

When the composer is empty, the send button becomes a **microphone**. Tapping it asks the browser for microphone permission, then connects. The text composer is replaced by a voice bar with a live waveform, a microphone picker, and an **End call** button.

The assistant can take the first turn, so the shopper may be greeted before they say anything. A short chime plays when the call connects and again when it ends.

## During the call

* The status moves through **Connecting → Listening → Thinking → Speaking**, and shows **Reconnecting…** if the network stalls.
* Everything said, by both sides, is **transcribed live into the chat thread** as normal message bubbles. When the call ends, that transcript is simply part of the conversation.
* The shopper can switch microphones mid-call; their choice is remembered for next time.
* Because it's one continuous conversation, the assistant can still show product cards and other results, and the shopper can pick up in text where the call left off.

## Ending a call

The shopper taps **End call**. The assistant can also wrap up the call itself when the conversation is done. Either way, the voice bar closes back to the text composer, and a short feedback prompt may appear.

## Availability

Voice is on by default for a resolved store, on both desktop and mobile; the microphone button appears automatically. There's no shopper toggle; availability follows your store configuration.

{% hint style="info" %}
Voice and text share one assistant, one persona, and one memory of the shopper. Nothing you set up for text needs to be redone for voice.
{% endhint %}


---

# 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.maker.co/maker-greatstore/storefront/voice-chat.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.
