SIP trunking
SIP trunking is a live form of person-to-person (P2P) communication. It allows you to initiate a call from your voice platform using the Infobip infrastructure. You can have a conversation in real time with the end user who receives this call on their mobile or landline phone.
SIP Trunking configuration is also used to safelist your IP address to receive incoming calls (Forward to IP). Configure it under the Channels and Numbers module located at the bottom left > Voice > SIP Trunking.
Use cases
The SIP trunking feature enables the connection of your SIP infrastructure (PBX, SBC) to the Infobip platform.
In doing so, multiple usage scenarios can be considered:
| Global reach and connectivity |
Outbound (termination) |
You use your SIP infrastructure to send call requests to the Infobip platform that we will terminate on PSTN destinations across the world. Infobip offers the widest reach of connectivity on the planet, with more than 200 countries in its global reach and 9 geographically dispersed data center locations accepting your SIP trunk connections in self-service. |
|---|---|---|
| Inbound (origination) | You rent local DID numbers from Infobip, and calls received on these numbers are forwarded to your SIP infrastructure. |
Technical requirements
Supported software and hardware
Our SIP trunking solution works with SIP network elements such as IP PBXs and SBCs.
SIP-based hardware phones and softphones are not supported.
Supported SIP methods
The following SIP methods are currently supported:
- INVITE and reINVITE
- ACK
- BYE
- CANCEL
- OPTIONS
Supported codecs
The following codecs are currently supported:
- g711a and g711µ
- DTMF RFC2833
Inband DTMF is not supported.
Custom headers
The following custom headers will be recognized and processed by the Infobip platform when you send us requests over SIP:
| Custom header | Use case |
|---|---|
| X-Client-Message-ID | Your unique call ID, when you send us calls to terminate over PSTN destinations. You can later use this value when you want to fetch call logs. |
Setup
To start working with Infobip's SIP trunking, you need to configure at least one SIP trunk. You are free to define multiple additional trunks.
Configure SIP trunks
To use SIP trunking, you need to have a voice platform that supports the SIP protocol and is reachable over the public Internet via a static public IP address.
To add a new SIP trunk, log in to your account, navigate to the Channels and Numbers > Voice > SIP Trunking > Add new.
Enter the following parameters and click SAVE.
- IP ADDRESS – IP address of your Voice platform (SBC, PBX).
- PORT – TCP/UDP - Port used for SIP communication (usually 5060).
- DATA CENTER – Choose one of the Infobip data centers closest to your voice platform location. See the table below for a reference of allowed location names.
The following table gives you the corresponding Infobip SBC addresses for each data center:
| Location | Region | Infobip SBC address |
|---|---|---|
| FRANKFURT | Frankfurt, Germany | 62.140.31.124 |
| BOGOTA | Colombia | 81.23.252.124 |
| NEW_YORK | New York, US | 185.255.9.23 |
| SAO_POLO | Sao Paolo, Brazil | 81.23.253.104 |
| SINGAPORE | Singapore | 81.23.254.103 |
| JOHANNESBURG | Johannesburg, South Africa | 202.22.162.104 |
| MOSCOW | Moscow, Russia | 202.22.163.127 |
| ISTANBUL | Istanbul, Turkey | 202.22.169.124 |
| KUALA_LUMPUR | Kuala Lumpur, Malaysia | 202.22.165.100 |
INFO
You can only use the same IP address and port combination for ONE SIP trunk.
Authentication
Once you save your SIP trunk configuration, your IP address is safelisted on our SIP infrastructure. Note that you should also safelist the corresponding Infobip SBC's IP address on your infrastructure to ensure the traffic can be processed on both sides. You can find this SBC address in the reference table above.
You are now ready to start sending call requests over this SIP trunk for Infobip to terminate it toward PSTN destinations.
Configure call forwarding to SIP trunk
You can forward calls received on DID numbers you are renting from Infobip to a SIP trunk. To do so, log in to your account, and navigate to Channels and Numbers > Voice > Numbers. Select the number that you wish to forward incoming calls to your SIP infrastructure, and select the Forward to IP action. You can select the predefined SIP trunk that you wish to use for this configuration.
Search logs
You can get your call logs either from the web interface or via API. More details on each are below.
Via the web interface
Log in to your account, and navigate to Analyze > Logs.
Via API
To search SIP trunking logs using API, send us your unique call ID in an X-Client-Message-ID SIP header when initiating outbound Voice calls. Use this value as messageId to search for call details when you use SIP Trunking call logs.