Overview
Supported Features
| Feature | Support |
|---|---|
| SIP Methods | ACK, BYE, CANCEL, INVITE, OPTIONS, UPDATE |
| Authentication | IP ACL, Username/Password, or both |
| Codecs | PCMA, PCMU |
| DTMF | RFC-2833 |
| Encryption | TLS (signaling), SRTP (media) |
| E.164 Format | Required for all calls |
| Call Recording | Not supported |
| T.38 Fax | Not supported |
Not Supported
- INFO, MESSAGE, NOTIFY, PRACK, PUBLISH, REFER, REGISTER, SUBSCRIBE SIP methods
- Call recording
- T.38 fax
Points of Presence (PoPs)
Zentrunk routes calls through the nearest PoP for optimal latency.| Region | Location |
|---|---|
| North America | North California, Virginia |
| Europe | Frankfurt |
| South America | São Paulo |
| Asia Pacific | Singapore, Sydney, Mumbai |
Calls Per Second (CPS)
CPS limits control outbound call initiation rate.| Level | Default | Description |
|---|---|---|
| Account-level | 2 CPS | Total calls per second across all trunks |
| Trunk-level | Configurable | Allocated per trunk from account pool |
- 3 trunks with 25 account CPS: 10 + 10 + 5 CPS
- 10 trunks with 10 account CPS: Each trunk gets 10 CPS (first-come allocation)
- No limit on concurrent calls
- Calls exceeding trunk CPS fail; calls exceeding account CPS queue
- Contact Plivo Sales to increase CPS
Configuration
IP Addresses to Whitelist
| Region | IP Addresses | Signaling Ports | Media Ports |
|---|---|---|---|
| North California | 13.52.9.0/25, 216.120.187.128/26 | 5060 (UDP/TCP), 5061 (TLS) | 10000-30000 (UDP/TCP) |
| Virginia | 18.214.109.128/25, 18.215.142.0/26, 204.89.148.128/26 | 5060 (UDP/TCP), 5061 (TLS) | 10000-30000 (UDP/TCP) |
| Frankfurt | 3.120.121.128/26 | 5060 (UDP/TCP), 5061 (TLS) | 10000-30000 (UDP/TCP) |
| São Paulo | 18.228.70.64/26 | 5060 (UDP/TCP), 5061 (TLS) | 10000-30000 (UDP/TCP) |
| Sydney | 13.238.202.192/26 | 5060 (UDP/TCP), 5061 (TLS) | 10000-30000 (UDP/TCP) |
| Singapore | Check Zentrunk documentation | 5060 (UDP/TCP), 5061 (TLS) | 10000-30000 (UDP/TCP) |
| Mumbai | Check Zentrunk documentation | 5060 (UDP/TCP), 5061 (TLS) | 10000-30000 (UDP/TCP) |
Authentication Methods
- IP Access Control List: Whitelist your PBX IP addresses
- Credentials: Username and password authentication
- Both: IP ACL combined with credentials
Limits
| Resource | Limit |
|---|---|
| Trunks per account | 100 (recommended) |
| IP ACLs per account | Unlimited |
| Concurrent calls | Unlimited (elastic scaling) |
SIP OPTIONS Pings
Zentrunk supports OPTIONS pings for health checks. Requirements:- Send to outbound trunk URI only (not trunk IP addresses)
- Maximum frequency: 1 ping per 10-15 seconds
- Higher frequency may result in blocking
Caller ID Requirements
Plivo numbers are required as caller ID for all outbound calls. Using a non-Plivo number results inunknown_caller_id hangup cause.
Options:
- Rent numbers from Plivo
- Port existing numbers to Plivo
Domestic Caller ID Support
Plivo guarantees domestic CLI presentation in:- United States
- Canada
- United Kingdom
- Australia
- Italy
- Peru
- France (beta)
Premium and High-Risk Numbers
By default, Zentrunk blocks calls to premium-rate numbers to prevent toll fraud (IRSF - International Revenue Share Fraud).What are Premium Numbers?
Numbers that charge higher rates for special services (e.g., adult content, contest lines, directory services).Request Access
If your use case requires calling premium numbers:- Contact Plivo Support
- Provide your use case details
- Wait for validation (48+ hours)
Pricing
Origin-Based Pricing
Call rates vary by originating country, not just destination. Example: Calls to Germany from within Europe may cost less than calls from outside Europe. Check Zentrunk Pricing for current rates.Abandoned and Short Duration Call Charges
| Metric | Threshold | Surcharge |
|---|---|---|
| Abandoned calls | > 20% of monthly calls | $0.005 per excess call |
| Short duration calls | > 20% of monthly calls | $0.0025 per excess call |
- Abandoned call: Zero-second duration (unanswered, rejected, missed)
- Short duration call: ≤ 6 seconds (excluding abandoned)
Troubleshooting
Access Call Detail Records (CDRs)
- Navigate to Zentrunk > Logs in the console
- Filter CDRs as needed
- Click Export to download
Debug Logs
Available information:- Call details (basic info)
- Call stats (origination, termination, trunk info)
- SIP logs (PCAP download, last SIP response, codec)
- No charge for debug logs
- Audio quality parameters not available in debug logs
- Download SIP PCAPs from the call detail record
Common Hangup Causes
| Hangup Cause | Description | Solution |
|---|---|---|
unknown_caller_id | Non-Plivo number used as caller ID | Use Plivo number or port your number |
dno_caller_id | Number on US “Do Not Originate” list | Use a different caller ID |
destination_country_barred | Geo permissions not enabled | Enable country in console |
Country-Specific Restrictions
Australia
Per ACMA regulations, calls with these CLI prefixes are blocked:+6113+611300+611800+611900
China
Prohibited traffic:- Gambling, betting
- Financial services, cryptocurrency
- Marketing/spam calls
- Fraudulent calls (“fake police,” etc.)
- Politically sensitive topics
- Cannot use Chinese numbers as caller ID
- Maintain average call duration > 3 minutes
- Avoid high unanswered call rates
- Don’t use toll-free numbers
- Chinese numbers can only receive calls from within China
Compatible Equipment
Zentrunk works with:- IP PBX systems (FreeSWITCH, Asterisk, FreePBX, 3CX, FusionPBX)
- Session Border Controllers (SBC)
- Softphone clients (Zoiper, X-Lite/Bria)
Softphone Setup
- Create an account in your softphone
- Uncheck “register with domain and receive calls”
- Configure with your Zentrunk SIP URI
API Integration
Map Numbers to Inbound Trunks
Use the Account Phone Number API withinbound trunk_id parameter.