Voice: SIP trunking
SIP trunks for your PBX, softswitch or dialer, by password, IP or hostname, with outbound profiles that cap channels and spend.
A SIP connection is a trunk between your equipment and sip.dialerseat.com. Outbound, your PBX sends calls to us; inbound, calls to your numbers are sent to it.
Three ways to authenticate
- Username and password (credential): Your equipment registers to
sip.dialerseat.comwith a username and password. Works from anywhere, behind NAT. - IP address (ip): Calls from your listed IP addresses or ranges are accepted; inbound calls are sent to them.
- Hostname (FQDN) (fqdn): Like IP, by your DNS name, so your addresses can change without a ticket.
IP connections accept public addresses only, as single addresses or ranges no wider than /24, so a typo can never open a trunk to the whole internet. A username and password are made for you if you do not choose them; the password is shown once.
curl https://api.dialerseat.com/v1/voice/sip_connections \
-H "Authorization: Bearer dsk_live_..." \
-H "Content-Type: application/json" \
-d '{ "name": "Office PBX", "auth": "ip", "ips": ["203.0.113.10"], "codecs": ["G722", "PCMU"], "transport": "tls", "encryption": "srtp", "outbound_voice_profile_id": "ovp_..." }'Codecs and encryption
Codecs, in your order of preference: G722, PCMU, PCMA, OPUS, G729. Signalling over UDP, TCP or TLS; media in the clear or encrypted with SRTP. Encrypted media requires TLS signalling, since otherwise the keys would travel in the clear.
Inbound calls
Choose how numbers reach your equipment (+E164, E164 or national) and, for IP and hostname trunks, a failover order across your addresses. GET /v1/voice/sip_connections/{id}/registration_status shows whether a credential trunk is registered and from where.
Outbound profiles
An outbound profile is the guard rail on every outbound call through the connections that use it. A call that would break a rule is refused before it rings, with a hangup cause that says which rule.
- Allowed destinations: The 48 contiguous states and DC; Alaska and Hawaii; Puerto Rico, the US Virgin Islands, Guam, the Northern Mariana Islands and American Samoa; US toll-free numbers.
- Channel limit: concurrent calls; the next is refused with channel_limit.
- Daily spend limit: resets at midnight UTC; refused with spend_limit.
- Maximum rate per minute: dearer destinations are refused with max_rate_exceeded.
- Recording of every outbound call, if you want it.
Caller ID and STIR/SHAKEN
Outbound calls must use a number on your account as the caller ID. Calls are signed for STIR/SHAKEN, which tells the called network how far the caller ID can be trusted:
- A: Full: the caller is our customer and is using a number they own on DialerSeat Voice.
- B: Partial: the caller is our customer, but the number is not one we can confirm is theirs.
- C: Gateway: we passed the call on and know nothing about the caller.
Related:DialerSeat Voice: numbers, SIP and a voice API, Voice: numbers, porting and 911, Voice: the Voice API and Voice: answering-machine detection.