> For the complete documentation index, see [llms.txt](https://phonetracker247-1.gitbook.io/support.phonetracker247.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://phonetracker247-1.gitbook.io/support.phonetracker247.com/help/troubleshooting/dashboard-website/features/ambient-voice-recording.md).

# Ambient voice recording

## Troubleshooting – Ambient Voice Recording Not Working

### A. Minimum Requirements

1. **Target device must have Internet access** (Wi-Fi, 3G/4G/5G).
2. **Your subscription package must include this feature.**
   * Free packages may not support Ambient Recording, or the policy may have changed.
3. **Daily and storage limits may apply.**
   * For example: \~100 recordings per day, or a limited total MB quota.
   * **Solution:** Delete older recordings to free up space.
4. **Missing Microphone Permission (RECORD\_AUDIO)**
   1. For example, the recording task fails immediately or shows “Permission denied” or "Missing required permission."
   2. **Solution**:
      1. Go to **Settings → Privacy → Permission Manager → Microphone**.
      2. Ensure the **Agent app** has permission.
      3. On Android 12+, confirm that **Mic access** in Quick Settings is turned ON.

> You can open the Agent app and go to menu <mark style="color:red;">More ⇒ Permission and select these permission:</mark>

<figure><img src="/files/VLIFqFWITsaY0whPnRuf" alt="" width="167"><figcaption></figcaption></figure>

5. **Battery Optimization or Background Restriction**
   1. Recording stops after a few seconds, or only works with the screen on.
   2. **Solution**:
      1. Allow **Background activity** and **Autostart** for the Agent app.
         1. Turn off **Battery optimization**:
            * Open Android OS Settings → Apps → \[Agent App Name] → Battery → *Don’t optimize*).
            * (Or you can open <mark style="color:red;">Agent App interface → menu More → Permissions ⇒ "</mark>*<mark style="color:red;">Do not optimize battery usage" like the requirement above</mark>*)
         2. On Xiaomi/OPPO/Vivo/Huawei devices, **lock the app** in Recents

***

### B. Possible Causes and Fixes

#### 1. Microphone Busy or During a Call

* **Symptom:** “Resource busy” error or empty recording file.
* **Fix:**
  * Stop other apps from using the mic (Messenger, Meet, Zalo, etc.).
  * Wait until all **calls or VOIP sessions** end.

#### 2. Privacy Settings Blocking Microphone

* **Symptom:** The Green mic indicator shows, but the file is silent.
* **Fix:**
  * Turn off the **Mic Off** toggle in Quick Settings.
  * Check **Privacy → Safety & Emergency**, and disable any “mic blocker” apps.

#### 3. Media Server Quota Full

* **Symptom:** Recording stops immediately or cannot be uploaded.
* **Fix:**
  * Delete old recordings from the server using the dashboard website where you are using this feature.

#### 4. Outdated Agent or Disabled Ambient Module

* **Symptom:** No “Ambient” option or constant failure.
* **Fix:**
  * **Update the Agent app** to the latest version.
  * Verify **DeviceSettings / FeatureControl** → *Ambient Recording = ON*.

#### 5. Consent Missing or Reset

* **Symptom:** Server refuses the task for missing consent.
* **Fix:**
  * Open **Policy/Consent inside the Agent and reconsent.**
  * Ensure consent is successfully saved.

#### 6. Cooldown Between Recordings

* **Symptom:** First recording works, next one fails instantly.
* **Fix:**
  * Wait a few minutes before retrying to avoid hitting cooldown limits.

#### 7. Bluetooth or External Audio Routing

* **Symptom:** Silent recordings while connected to a Bluetooth headset.
* **Fix:**
  * Turn off Bluetooth or disconnect the headset before recording.

#### 8. Focus / Parental Control / Digital Wellbeing

* **Symptom:** Recording is disabled at specific times or under focus mode.
* **Fix:**
  * Check **Digital Wellbeing / Focus / Parental Controls**, and exclude the Agent app.


---

# 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:

```
GET https://phonetracker247-1.gitbook.io/support.phonetracker247.com/help/troubleshooting/dashboard-website/features/ambient-voice-recording.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.