ContactivityDocs
Bring your own carrierMarkdown

Bring your own carrier

Bring your own carrier (BYOC) lets you use a voice carrier you already have with Contactivity. Calls to and from your carrier's numbers use your SIP trunks and voice apps and go out through your carrier.

BYOC needs Tier 2 or higher. It is under Voice > BYOC Carriers.

BYOC calls are billed a per-minute platform fee. Your carrier bills you for its own service. See Pricing in the portal.

Add a carrier

  1. Select Add carrier.
  2. Enter a Name.
  3. Add your Outbound gateways.
  4. Add your Inbound source IPs.
  5. Save.

Outbound gateways

Gateways are where we send your outbound calls. Each gateway has:

  • Host: a public IP address or hostname, without a port.
  • Port: default 5060.
  • Transport: UDP, TCP or TLS. Set the port your carrier uses for TLS, often 5061.
  • Username and Password, if your carrier needs them.

Add 1 to 10 gateways. They are tried top to bottom until one answers. Use Try earlier and Try later to set the order.

The next gateway is tried after no answer, a timeout, a server error or a refused login. Busy, not found or declined ends the call.

Inbound source IPs

Enter the addresses your carrier sends calls from, one IP or CIDR per line. Calls from other addresses are refused.

  • 1 to 50 public IPv4 addresses or ranges, each no wider than /24.
  • Addresses used by a SIP trunk cannot be added.

Add numbers

  1. Open the carrier.
  2. In Numbers, enter a Phone number in international format and select Add.
  3. Select Edit routing to set where its calls go. See Route a number.
  4. To send failed calls on to the route's fallback, turn on Use fallback route. It is off by default.

Notes:

  • A number bought from Contactivity cannot be added to a carrier.
  • Carrier numbers are listed on the carrier, not under Numbers.
  • Calls you forward from a carrier number go out through the same carrier.
  • Your carrier signs your outbound calls for caller ID, not Contactivity.
  • Archiving a carrier archives its numbers too.