A Caller ID is the calling number presented to the person you're calling.
Outbound calls made using Aculab's Outbound Call Providers must specify a validated Caller ID as its calling number (in the call_from parameter). Outbound calls placed through your own call providers may have different restrictions on using validated Caller IDs.
Aculab Cloud maintains a list of Caller IDs on your account (you can set this in the Cloud Console's Settings / Caller IDs page) that have been validated to ensure they are genuine and accessible by you. All inbound telephone numbers purchased on your account will be added automatically to this list. The validation process calls the number and displays a PIN code which then needs to be entered on the call.
In order to ensure appropriate use of the Caller ID, the value you provide is checked and, if necessary, modified before the outbound call is placed.
Caller ID for outbound calls to SIP addresses
For regular outbound calls, call_from should be a SIP username - for example 'manage_account'. If call_from also contains an address - for example 'email@example.com' - the '@' and all characters to its right are ignored. If call_from is empty, the default SIP username aculabcloud is used.
For outbound transfer calls, call_from is usually left empty and, in that case, the call_from of the outgoing call will be that of the original call if it was incoming, or its dialled number if it was outgoing. If the resulting call_from remains empty, the default SIP username aculabcloud is used. If call_from is populated then it is handled as for regular outbound calls.
Caller ID for outbound calls to telephone numbers
For regular outbound calls, call_from should be a full international number without the leading '+' or '0' - for example '441908273800' for Aculab's UK Headquarters. It is an error for call_from to be empty in this case.
For outbound transfer calls, call_from is usually left empty and, in that case, the call_from of the outgoing call will be that of the original call if it was incoming, or its dialled number if it was outgoing. However, if the resulting call_from is not a valid number - for example if the original inbound call was not from the telephone network and had a Caller ID of firstname.lastname@example.org - the transfer attempt will fail since telephony Caller IDs must be valid E.164 numbers. If call_from is populated then it is handled as for regular outbound calls.
In order to ensure appropriate use of Aculab's outbound telephony providers, for all outbound telephone calls placed through them with a populated call_from, we check that it's one of the following and will fail call attempts where it isn't:
- in your list of validated Caller ID numbers (when logged in, click Manage, then Caller ID)
- one of your inbound numbers purchased through Aculab Cloud
- the full international number taken from call_from of the latest primary channel call if that call is incoming
- the full international number taken from the call_to of the latest primary channel call if that call is outgoing
Finally for Caller ID, once these checks have been done, the address of the Cloud is appended to the call_from. So, for example, on the EU Cloud, a call with call_to starting with 'sip:' and a call_from of 'manage_account', will result in a call being placed with Caller ID email@example.com