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

> ## Agent Instructions
> Use Stable documentation by default. Honor an explicit Beta request or a URL under /docs/beta/. If the requested version conflicts with the installed CLI package or API origin, clarify the target before writing integration code.
> Pages under /docs/beta/ document Beta; other product pages document Stable. Keep the CLI package, commands, API origin, and credentials within the selected version. State the documentation version in your answer.
> For MCP search, always pass version: Stable or version: Beta. Unfiltered search mixes both versions. For filesystem reads, keep Beta queries under /beta/ and exclude /beta/ from Stable queries; discover paths before reading them.
> The public docs base is https://photon.codes/docs. Convert MCP page paths to public URLs under that base, preserving /beta/ when present. Read https://photon.codes/docs/skill.md for version selection and https://photon.codes/docs/llms.txt for the version indexes.

# Voice call troubleshooting

> Common audio problems on Spectrum voice calls, what causes them, and how to fix them.

If calls connect but the audio is wrong and you've ruled out your own endpoint, this page is organized by the symptom you're hearing. Find it in the headings below and follow the fix. Each section is self-contained, so you can land here from a search result and still get what you need.

If your symptom isn't listed, jump to [Still stuck?](#still-stuck) for what to send us so we can trace it on our side.

## Callers hear choppy or distorted AI audio

The caller hears the AI voice as choppy or warbly, but the other direction
is clean — the AI platform's transcription and its own recording sound fine.

Spectrum uses G.711 for call audio to keep quality consistent. It's the
codec the phone network itself runs on, and it holds up on the mobile
networks most callers are on.

If your AI audio is choppy anyway, check the codec in your endpoint's
`200 OK`. It should say `PCMU/8000` or `PCMA/8000` — if it says anything
else, or it's choppy even on those, jump to [Still stuck?](#still-stuck)
and include the codec in your report.

## Audio sounds like a regular phone call, not HD

That's expected — G.711 is standard telephone quality. Consistent audio on
every call beats HD on some and garbled audio on the rest.

## One-way or missing audio

Spectrum only handles signaling. The audio itself (RTP) flows directly
between the carrier and your SIP endpoint, so when sound is missing in one
direction the problem is usually at one of those two ends:

* Make sure your endpoint (or its cloud provider) accepts inbound RTP from
  the carrier's media IPs, not just SIP signaling.
* If your endpoint sits behind NAT, it needs to advertise a publicly
  reachable address in its SDP, not a private one.
* Check your endpoint's media logs for RTP timeouts or packet-receive errors
  on the affected call.

## Still stuck?

Send us:

* Your project id (from `photon projects show`).
* The SIP Call-ID, or the call time, caller number, and dialed number so we
  can find it.
* The direction (inbound or outbound) and which side hears the problem.
* The negotiated codec from the `200 OK`, if you can capture it.
* Your downstream SIP endpoint vendor (ElevenLabs, Retell, self-hosted, …).

We'll trace the call on our side, including the exact SDP each leg saw. Email
us at [help@photon.codes](mailto:help@photon.codes) or ping us in the Discord
linked in the footer.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.