Skip to content

Commit 9dddf83

Browse files
committed
updated general sip instruction
Signed-off-by: sahil suman <[email protected]>
1 parent 5457a4b commit 9dddf83

File tree

1 file changed

+34
-1
lines changed

1 file changed

+34
-1
lines changed

fern/advanced/sip/sip-trunk.mdx

Lines changed: 34 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,19 @@ SIP trunking replaces traditional phone lines with a virtual connection over the
1010

1111
Vapi supports multiple SIP trunk configurations, including:
1212

13-
- **Telnyx**: Uses SIP gateway domain (e.g., sip.telnyx.com) with IP-based authentication. May require a tech prefix for outbound calls.
13+
- **Telnyx**: Uses SIP gateway domain (e.g., sip.telnyx.com) with IP-based authentication.
1414
- **Zadarma**: Uses SIP credentials (username/password) with its SIP server (e.g., sip.zadarma.com).
1515
- **Custom "BYO" SIP Trunk**: Allows integration with any SIP provider. You simply provide the SIP gateway address and the necessary authentication details.
1616

17+
<Warning>
18+
Our IP Addresses are:
19+
20+
- 44.229.228.186/32
21+
- 44.238.177.138/32
22+
23+
However, we generally don't recommend IP-based authentication for SIP trunks as it can lead to routing issues. Since our servers are shared by many customers, if your telephony provider has multiple customers using IP-based authentication, calls may be routed incorrectly. IP-based authentication works reliably only when your SIP provider offers a unique termination URI or a dedicated SIP server for each customer, as is the case with Plivo and Twilio integrations.
24+
</Warning>
25+
1726
## 2. Setup Process Overview
1827

1928
To set up a SIP trunk in Vapi, follow these steps:
@@ -92,3 +101,27 @@ POST https://api.vapi.ai/call/phone
92101
#### Inbound Call Test
93102

94103
If inbound routing is configured, call your phone number from an external line. Ensure your provider forwards calls to the correct SIP URI (e.g., `{phoneNumber}@sip.vapi.ai` for Zadarma).
104+
105+
#### SIP REFER (Call Transfer)
106+
107+
If you need to transfer a call to another number, you will need to add a SIP Transfer based call forwarding where transfer number will look like this: sip:[email protected]
108+
109+
Example: sip:[email protected]
110+
111+
Example tool configuration required for SIP REFER:
112+
113+
```json
114+
{
115+
"type": "transferCall",
116+
"destinations": [
117+
{
118+
"type": "sip",
119+
"sipUri": "sip:[email protected]"
120+
}
121+
]
122+
}
123+
```
124+
125+
<Info>You might need to enable SIP REFER in your SIP provider to allow this.</Info>
126+
127+

0 commit comments

Comments
 (0)