Understanding the use of Secondary Caller ID

Secondary Caller ID is a form a SIP Redundancy feature provided to customers who require more stability in their voice calls. In case the preferred network provider is not reachable, or network is unstable/unavailable, Unifonic will rout calls via the secondary network provider instead.

In order to do so, Unifonic need to use a caller ID provided by the secondary network provider. Hence, the use of Secondary Caller ID.

The Secondary Caller ID is currently available only in the Kingdom of Saudi Arabia (KSA).

There is a monthly subscription fee associated to secondary caller IDs.

Upon subscribing for one, you can now utilize it in your API payload.

curl --location 'https://voice.unifonic.com/v1/calls' \
--header 'AppsId: XXXXXXXXXXXXXXXXXXX' \
--header 'Content-Type: application/json' \
--data '{
	"recipient":["+966006939000"],
	"callerId" : "+966112231300",
    "secondaryCallerId":"+966124657888",
    "type":"ivr",
    "callRecording":true,
	"ivr":
	{
        "play":"https://objectstorage.me-jeddah.com/promissory_note_voiceOptions%20-%20Ar-%20promissory%20notes%20EM-5188.m4a",
        "loop":3
	}
}'

Our system will automatically route the calls via the secondary carrier in case there is a network failure with the Primary carrier.

📘

All calls will be received from the Secondary Caller ID instead in case an automatic failover is triggered.