Go back to dialerseat.comsales@dialerseat.com
Voice

Voice: SIP trunking

SIP trunks for your PBX, softswitch or dialer, by password, IP or hostname, with outbound profiles that cap channels and spend.


DialerSeat Voice works in the sandbox today: call it with your test key, or open Voice & SIP in the console. Live numbers and calls open by request: email dev@dialerseat.com.

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.com with 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.

An IP trunk for an office PBX
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.