From 0d2c8c75792419503ddfd55aeb897877405758da Mon Sep 17 00:00:00 2001 From: Mehayla <68716877+Mehayla@users.noreply.github.com> Date: Mon, 14 Sep 2026 07:11:06 -0500 Subject: [PATCH] docs(sip-telnyx): document Telnyx PCMA/PCMU codec mismatch causing audio corruption --- fern/advanced/sip/sip-telnyx.mdx | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/fern/advanced/sip/sip-telnyx.mdx b/fern/advanced/sip/sip-telnyx.mdx index 96d60713b..5f78d666c 100644 --- a/fern/advanced/sip/sip-telnyx.mdx +++ b/fern/advanced/sip/sip-telnyx.mdx @@ -2,6 +2,7 @@ title: Telnyx SIP integration subtitle: How to integrate SIP Telnyx to Vapi slug: advanced/sip/telnyx +description: Connect a Telnyx SIP trunk to Vapi for inbound and outbound calls, walking through the full setup so your AI voice assistants can handle calls. --- Integrate your Telnyx SIP trunk with Vapi to enable your AI voice assistants to handle calls efficiently. This guide walks you through the complete setup process for both inbound and outbound calls. @@ -158,3 +159,13 @@ Integrate your Telnyx SIP trunk with Vapi to enable your AI voice assistants to By following these steps, your Telnyx SIP trunk will be fully integrated with Vapi, allowing your AI voice assistants to manage calls effectively. + +## Known issues + +- **PCMA/PCMU codec mismatch can corrupt call audio.** Vapi's WebSocket media stream expects G.711 ยต-law (PCMU). Some Telnyx trunks, most commonly those carrying European numbers, send inbound audio as G.711 A-law (PCMA) instead. When the codecs don't match, the resulting transcoding can muffle or clip the caller's audio, add clicking artifacts, and fragment speech-to-text transcripts. + - In the Telnyx portal, check which codec your trunk is configured to send for the affected number (Voice / SIP Trunking / your trunk / codec or media settings). + - If you can set the trunk's codec preference in Telnyx, set it to PCMU to avoid the transcoding hop entirely. + - If your number must send PCMA (for example, a European DID where PCMA is the carrier default), contact Vapi support with your affected call IDs and SIP trunk/credential ID so they can confirm whether PCMA passthrough or codec auto-negotiation can be enabled on your media stream. + + Audio quality symptoms caused by a codec mismatch (muffled or clipped audio, clicking, broken transcripts) look similar to a noisy line, but they don't have a network-loss or jitter cause. Confirm the trunk's codec before troubleshooting network quality. +