Programmable Voice

  1. Home
  2. Docs
  3. Programmable Voice
  4. SIP
  5. Setting the SIP Response Code to return when all your lines are busy

Setting the SIP Response Code to return when all your lines are busy

When the carrier sends in a request to start a new call, and there are no more licenses to fill that request, the system responds to the INVITE with a “486 Busy Here”.

This can be configured to return any other SIP response code by setting this value in the HmpElementsServer.exe.config file:

<setting name="ServerBusyResponse" serializeAs="String">
    <value>0</value>
</setting>

When this is set to zero, then the default “486 Busy Here” is sent. When this is set to some other code, like 503, then a “503 Service Unavailable” is returned. Valid Sip codes can be seen here:

https://en.wikipedia.org/wiki/List_of_SIP_response_codes#4xx.E2.80.94Client_Failure_Responses

What your carrier decides when it receives one of these codes is defined by your carrier. Some carriers will play a busy signal, others will not. Some will play a message that the number cannot be reached. Some carriers can be defined to roll the call over to a backup IP address; it all depends on your carrier.

If your carrier supports OPTIONS requests you can give the carrier a “heads-up” about your server’s status. Please see this article on our wiki: SIP Options in HMP Elements

Was this article helpful to you? Yes 8 No

How can we help?