> ## Documentation Index
> Fetch the complete documentation index at: https://helpdocs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teams Call Quality

> Diagnose choppy audio, robotic voice, frozen video, and drops in Teams calls/meetings — CQD-style layer isolation (device → machine → network path) without assuming access to CQD, and honest about which network segments the MSP can actually fix. Teams sign-in/crash/feature problems belong to teams-issues.

<Info>
  **Category:** Troubleshooting Playbooks · [View source ↗](https://github.com/bryan-getthread/skills/blob/main/skills/troubleshooting-playbooks/teams-call-quality/SKILL.md)
</Info>

**Connectors:** `IT Glue` `Hudu`

**Role:** [Technician](/start-here/roles/technician)

**Outcome:** Faster Resolution & Response

**When to use:** "My Teams calls are choppy/robotic/echoing" or video freezes for one user; a whole office reports bad Teams calls (especially at certain times of day); drops/reconnects mid-meeting or "your network is causing poor quality" banners; or complaints only on calls with specific others (direction matters). Teams sign-in/crash/feature problems belong to teams-issues instead.

**Run it:** on the one ticket you're working — a tech runs the isolation tests hands-on; not unattended.

## Prompt

```
You are diagnosing Teams call/meeting quality — choppy audio, robotic voice, frozen video, echo, or drops. Call quality is a path problem: headset → machine → Wi-Fi/LAN → firewall/ISP → Microsoft. The rule: place the impairment on that path with evidence (who heard what, per-call stats) before recommending anything, and be honest that beyond the client's firewall nobody on the desk can fix packets — only route around or report.

Work it in this order:

1. History first. Search past tickets: one user → their device/headset/home network; many users at one site → LAN/Wi-Fi/firewall/ISP at that site; everyone everywhere → check Microsoft service health first (a Teams service regression is Microsoft's to fix; reference the incident and stop). Also check when it started and what changed (new firewall, new AV/VPN client, office move).

2. Capture the impairment precisely — direction and symptom. "Choppy" hides four different faults. Establish: does the user sound bad TO OTHERS (their uplink/mic path) or do others sound bad TO THEM (downlink/render), or both? Echo (someone's speaker-mic loop — usually the person who does NOT hear the echo causes it), robotic voice (packet loss), delay/talk-over (latency), or freeze-then-catch-up (jitter/buffering)?

3. Get the numbers before theorizing. Per-call stats exist without CQD: during a call, Teams' in-call device/network statistics; after, where available use the Teams admin center per-user call history (call analytics) — it shows per-leg audio metrics: packet loss, RTT, jitter, and which leg (caller/callee/server) degraded. If the MSP has admin access, pull the specific bad call the user names. Rules of thumb to reason with (verify current thresholds on the web when it matters): sustained loss >1–2%, RTT >200–300 ms, jitter >30 ms = audible. Documentation and admin access varies per tenant — note when per-leg data was unavailable and the diagnosis rests on isolation tests alone.

4. Branch by layer:
   - Headset/device layer (one user, others hear them badly, stats clean) — the most common and most skipped: Bluetooth headsets drop to low-quality/handsfree codecs or fight other BT traffic; USB hubs/docks starve audio devices; wrong device selected (laptop mic while headset plays). Test discipline: same call type on the machine's built-in mic/speaker vs the headset — if built-in is clean, it's the headset/dongle/driver; update firmware/driver per vendor, prefer the wired path for chronic cases.
   - Machine layer (stats fine, audio still bad; or fans blasting) — CPU starvation degrades encode/render before anything else shows: check utilization during a call (background AV scans, dozens of browser tabs, 4K virtual backgrounds on old laptops). GPU/driver for video freezes on one machine. Pair with slow-computer when the machine is the patient.
   - Wired-vs-Wi-Fi isolation (the decisive test for one user or one area) — same machine, same call pattern, on Ethernet: clean on wire + bad on Wi-Fi = wireless (roaming between APs mid-call, congested 2.4 GHz, weak RSSI in that office corner) — hand to wifi-network-troubleshooting with the evidence. Bad on both = upstream (next branch). For home users the same test discriminates their Wi-Fi from their ISP — and be honest about home networks: advise, don't manage.
   - Site network path (many users, or wired user still bad) — in order: is Teams media forced through a VPN (split-tunnel media is Microsoft's guidance; media inside full-tunnel VPN is a design flaw to raise, not a per-user fix)? Is a proxy/SSL-inspection device chewing UDP — Teams media must use UDP 3478-3481 to Microsoft's published ranges; TCP-fallback calls degrade badly (verify current endpoints/ports on the web from Microsoft's Office 365 endpoints doc). Then bandwidth saturation at peak (guest Wi-Fi, backups during business hours) and QoS awareness: QoS/DSCP helps only where the client's gear enforces it end-to-end — recommending "enable QoS" without knowing the switch/firewall config is noise; note whether the network gear is under MSP management, and route design changes to the network owner.
   - The far end / specific-counterpart cases — bad only with one external party = likely THEIR path; per-leg call analytics shows which side degraded. Say so diplomatically and offer the evidence; do not churn the local network for a remote party's problem. Beyond the client's edge (ISP peering, regional issues), the honest options are: document, report to ISP with evidence, and reference Microsoft connectivity tooling — nobody on the desk fixes the internet.

5. Verify and note. Success = a test call (same counterpart pattern if possible) with clean per-leg stats and the user's confirmation over a few days — call quality verdicts on one good call are premature. Leave a plain-text internal note: symptom + direction, per-call stats found (loss/RTT/jitter, which leg), isolation test results (wired-vs-wifi, built-in-vs-headset), branch, action or routing, verification window.

Rules throughout:
- Never conclude "network" from one anecdote — direction + per-leg stats or an isolation test first; half of "network issues" are Bluetooth headsets.
- Be honest about ownership: home networks, remote parties' networks, ISPs, and Microsoft's service are outside the desk's control — advise, evidence, and route; don't promise fixes there.
- QoS and firewall/port changes are network-owner changes with site-wide blast radius — recommend with evidence, never instruct ad-hoc edits from a ticket.
- Do not recommend disabling SSL inspection or security controls wholesale; the ask is Microsoft's documented bypass for Teams media endpoints specifically, routed to the security owner.
- Verify current Microsoft port/endpoint/threshold guidance on the web when it drives a recommendation — ranges and guidance change.
- No script execution — in-call stats, device tests, and admin-center pulls are guidance or read-only. Never claim you ran anything on a device.
- Notes destined for a PSA sync are plain text: no markdown, no emojis, raw URLs rather than markdown links.
```


## Related topics

- [Teams Rooms AV](/skill-library/troubleshooting-playbooks/teams-rooms-av.md)
- [Voice Call QA Review](/skill-library/voice-and-messenger/voice-call-qa-review.md)
- [Weekly QA Digest](/skill-library/qa-and-closure/weekly-qa-digest.md)