380 Alternative Service

Overview

SIP response code 380 Alternative Service is defined in RFC 3261. SIP servers may send this response to INVITE request in case they for some reason don’t want to connect the call as requested, but prefer some other way how to dial the number.

For example, the SIP server may refuse to make a SIP call and instead instruct Acrobits client to complete the call using call-through or web callback service, via cellular network.

Usage

When Acrobits SIP client receives 380 Alternative Service response to INVITE request, it checks for a custom header named X-Acro-DialAction. The value of this header contains a new dialAction to perform with this number.

In case the X-Acro-DialAction header is missing, or contains invalid value, the response is treated as error and call is terminated.

Note

In case the X-Acro-Dialaction header contains a value which will result in another SIP call to the same number, the process would get into an infinite loop. Acrobits client detects this situation and after several attempts, it stops trying and the call fails.

For the list of all supported dial actions, see the table in Dial Actions.

Example

response to INVITE:

SIP/2.0 380 Alternative Source
Via: SIP/2.0/UDP 10.20.30.40;rport=5060;branch=z9hG4bKa00yZB01yKv1Q;received=10.20.30.41
Contact: <sip:1234560@10.71.15.20:35963;rinstance=6161886D>
From: "xxxx" <sip:xxxx@yyyy>;tag=86SDXm7FQ01er
Call-ID: cd9b102a-8a01-1233-af98-485b39895799
CSeq: 76630747 INVITE
To: <sip:yyyyyyyyy@127.0.0.1>;tag=E127A393A340EBFCEC5C7FF7F06EE079
X-Acro-DialAction: callThrough
Content-Length: 0

This response will make Acrobits client try to call the dialed number via call through.