Network Intelligence/Restcomm Configuration: Difference between revisions
No edit summary |
No edit summary |
||
| Line 2: | Line 2: | ||
=Introduction= | =Introduction= | ||
This document provides instructions on how to configure | This document provides instructions on how to configure FreeSBC to interoperate with the [https://www.restcomm.com/ Restcomm] Communications platform as a service (CPaaS) system. <br/> | ||
Restcomm CPaaS platform provides programmable voice like IVR service, | Restcomm CPaaS platform provides programmable voice like IVR service, progammable SMS service, mail, chat services and more, for service provider and enterprise customers. <br/> | ||
[[ | [[FreeSBC]] acts as a Session Border Controller to protect the Restcomm CPaaS platform and provides many essential protection features for voice communications over SIP and RTP traffic. <br/> | ||
With the example below, a softphone - PhonerLite, and a real mobile phone are used to provide | With the example below, a softphone - PhonerLite, and a real mobile phone are used to provide originating end point that will call through [[FreeSBC]] to Restcomm platform. <br/> | ||
Furthermore, in this example, [[ | Furthermore, in this example, [[FreeSBC]] AWS is used, but in fact, any [[FreeSBC]] platform will be able to achieve the same setup. <br/> | ||
=Network Diagram and Call Scenarios= | =Network Diagram and Call Scenarios= | ||
This section provides the simplified network diagram containing Softphone, Mobile phone, service provider, | This section provides the simplified network diagram containing Softphone, Mobile phone, service provider, FreeSBC, Restcomm system, and the call flow scenarios. | ||
# '''Restcomm welcome announcement''' - PhonerLite sends 'direct call' to | # '''Restcomm welcome announcement''' - PhonerLite sends 'direct call' to FreeSBC with called information 1234@52.60.132.155 where 52.60.132.155 is the public Elastic IP used for voip interface in this FreeSBC AWS. FreeSBC makes a mapping of called number to 1234@netg2.restcomm.com before making outgoing call to Restcomm platform. PhonerLite hears welcome greeting from Restcomm platform. Configuration steps (available in different sections of PhonerLite Configuration, FreeSBC Configuration below):[[File:Restcomm_welcome_announcement.PNG|1000px]] | ||
##[[Network_Intelligence/Restcomm_Configuration#PhonerLite_direct_call_setting|PhonerLite direct call setting]] | ##[[Network_Intelligence/Restcomm_Configuration#PhonerLite_direct_call_setting|PhonerLite direct call setting]] | ||
##[[Network_Intelligence/Restcomm_Configuration# | ##[[Network_Intelligence/Restcomm_Configuration#FreeSBC Local NAT Traversal setting|FreeSBC Local NAT Traversal setting]] | ||
##[[Network_Intelligence/Restcomm_Configuration# | ##[[Network_Intelligence/Restcomm_Configuration#FreeSBC NAPs setting|FreeSBC NAPs setting]] | ||
##[[Network_Intelligence/Restcomm_Configuration# | ##[[Network_Intelligence/Restcomm_Configuration#FreeSBC routes setting|FreeSBC routes setting]] | ||
##[[Network_Intelligence/Restcomm_Configuration# | ##[[Network_Intelligence/Restcomm_Configuration#FreeSBC route called remapping|FreeSBC route called remapping]] | ||
# '''IVR DTMF acknowledgement''' - PhonerLite sends 'direct call' to | # '''IVR DTMF acknowledgement''' - PhonerLite sends 'direct call' to FreeSBC with called information 1234@52.60.132.155. FreeSBC makes a mapping of called number to 1234@netg2.restcomm.com before making outgoing call to Restcomm platform. PhonerLite hears welcome greeting from Restcomm platform with IVR to acknowledge the DTMF tones pressed. Same configuration steps as in call flow 1 with addition of [[Network_Intelligence/Restcomm_Configuration#PhonerLite_direct_call_setting|PhonerLite DTMF setting]] :[[File:IVR_DTMF_acknowledgement.PNG|1000px]] | ||
# '''IVR DID full number''' - PhonerLite sends 'direct call' to | # '''IVR DID full number''' - PhonerLite sends 'direct call' to FreeSBC with called information 1234@52.60.132.155. FreeSBC makes a mapping of called number to 13105894010@netg2.restcomm.com before making outgoing call to Restcomm platform. PhonerLite hears welcome greeting from Restcomm platform with IVR to acknowledge the DTMF tones pressed. Same configuration steps as in call flow 1 with addition of [[Network_Intelligence/Restcomm_Configuration#PhonerLite_direct_call_setting|PhonerLite DTMF setting]] :[[File:IVR_DID_full_number.PNG|1000px]] | ||
# '''Calling DID registered called number with IVR''' - Mobile phone is calling an international number 902129550330 through Mobile | # '''Calling DID registered called number with IVR''' - Mobile phone is calling an international number 902129550330 through Mobile opertaor and SIP provider. 902129550330 is a registered number in SIP provider. FreeSBC registering to this SIP provider (NAP) as a user for this 90212955033 and act as a termination point for this number. Once Mobile phone calling 902129550330, FreeSBC detecting this called number and forward it out, with remapping called number of 13105894010@netg2.restcomm.com to Restcomm platform. This call will also get IVR DTMF acknowledgement for DTMF tones pressed. Same configuration steps as in call flow 3 with addition of [[Network_Intelligence/Restcomm_Configuration#FreeSBC register to NAP with username and password|FreeSBC register to NAP with username and password]] :[[File:Calling_DID_registered_called_number_with_IVR.PNG|1000px]] | ||
# '''IVR DID full number outside call''' - PhonerLite sends 'direct call' to | # '''IVR DID full number outside call''' - PhonerLite sends 'direct call' to FreeSBC with called information 1234@52.60.132.155. FreeSBC makes a mapping of called number to 13105894010@netg2.restcomm.com before making outgoing call to Restcomm platform. PhonerLite hears welcome greeting from Restcomm platform with IVR to ask caller to press '1', which will enable a separate call back from Restcomm platform. This separate call back is then routed through FreeSBC to the SIP provider and Telecom operator and onto an outside number of a Telecobridges office phone number set. Same configuration steps as in call flow 4. | ||
[[File:IVR_DID_full_number_outside_call.PNG|1000px]] | [[File:IVR_DID_full_number_outside_call.PNG|1000px]] | ||
| Line 48: | Line 48: | ||
[[File:PhonerLite_direct_call_Codecs_and_DTMF.png|500px]] | [[File:PhonerLite_direct_call_Codecs_and_DTMF.png|500px]] | ||
For dialout, we can specify the called number as 1234@52.60.132.155 where 52.60.132.155 is the public Elastic IP used for voip interface in this | For dialout, we can specify the called number as 1234@52.60.132.155 where 52.60.132.155 is the public Elastic IP used for voip interface in this FreeSBC AWS. | ||
= | =FreeSBC Configuration= | ||
This section provides | This section provides FreeSBC configurations for the solution. | ||
== | ==FreeSBC Local NAT Traversal setting== | ||
* See NAT section in [[Toolpack:Tsbc IP Network Settings 3.0]] | * See NAT section in [[Toolpack:Tsbc IP Network Settings 3.0]] | ||
== | ==FreeSBC NAPs setting== | ||
* See [[Toolpack:Allocating a SIP Network Access Point (NAP) SBC A|Create SIP NAP]] and [[Toolpack:Allocating a SIP Open Network Access Point (NAP) SBC A|Create Open NAP]] | * See [[Toolpack:Allocating a SIP Network Access Point (NAP) SBC A|Create SIP NAP]] and [[Toolpack:Allocating a SIP Open Network Access Point (NAP) SBC A|Create Open NAP]] | ||
** Here, SIP NAP will be Restcomm NAP and Service Provider NAP, and Open NAP will be from PhonerLite | ** Here, SIP NAP will be Restcomm NAP and Service Provider NAP, and Open NAP will be from PhonerLite | ||
== | ==FreeSBC register to NAP with username and password== | ||
* The following sections need to be set, as in | * The following sections need to be set, as in example below, | ||
[[File: | [[File:FreeSBC register to NAP with username and password.png|700px]] | ||
* In this example, | * In this example, FreeSBC is behind NAT, so local NAT method is set | ||
== | ==FreeSBC routes setting== | ||
* See [[Toolpack:Creating a First Call Route E|Create a Static Route]] | * See [[Toolpack:Creating a First Call Route E|Create a Static Route]] | ||
** Here, we set the SIP | ** Here, we set the SIP end points (NAP) to and from as required in each call flow scenario | ||
== | ==FreeSBC route called remapping== | ||
* The following section needs to be set, and depending | * The following section needs to be set, and depending what called number remapping required as in each call flow scenario, | ||
[[File: | [[File:FreeSBC route called remapping.png|700px]] | ||
Revision as of 03:48, 25 January 2021
Introduction
This document provides instructions on how to configure FreeSBC to interoperate with the Restcomm Communications platform as a service (CPaaS) system.
Restcomm CPaaS platform provides programmable voice like IVR service, progammable SMS service, mail, chat services and more, for service provider and enterprise customers.
FreeSBC acts as a Session Border Controller to protect the Restcomm CPaaS platform and provides many essential protection features for voice communications over SIP and RTP traffic.
With the example below, a softphone - PhonerLite, and a real mobile phone are used to provide originating end point that will call through FreeSBC to Restcomm platform.
Furthermore, in this example, FreeSBC AWS is used, but in fact, any FreeSBC platform will be able to achieve the same setup.
Network Diagram and Call Scenarios
This section provides the simplified network diagram containing Softphone, Mobile phone, service provider, FreeSBC, Restcomm system, and the call flow scenarios.
- Restcomm welcome announcement - PhonerLite sends 'direct call' to FreeSBC with called information 1234@52.60.132.155 where 52.60.132.155 is the public Elastic IP used for voip interface in this FreeSBC AWS. FreeSBC makes a mapping of called number to 1234@netg2.restcomm.com before making outgoing call to Restcomm platform. PhonerLite hears welcome greeting from Restcomm platform. Configuration steps (available in different sections of PhonerLite Configuration, FreeSBC Configuration below):
- IVR DTMF acknowledgement - PhonerLite sends 'direct call' to FreeSBC with called information 1234@52.60.132.155. FreeSBC makes a mapping of called number to 1234@netg2.restcomm.com before making outgoing call to Restcomm platform. PhonerLite hears welcome greeting from Restcomm platform with IVR to acknowledge the DTMF tones pressed. Same configuration steps as in call flow 1 with addition of PhonerLite DTMF setting :
- IVR DID full number - PhonerLite sends 'direct call' to FreeSBC with called information 1234@52.60.132.155. FreeSBC makes a mapping of called number to 13105894010@netg2.restcomm.com before making outgoing call to Restcomm platform. PhonerLite hears welcome greeting from Restcomm platform with IVR to acknowledge the DTMF tones pressed. Same configuration steps as in call flow 1 with addition of PhonerLite DTMF setting :
- Calling DID registered called number with IVR - Mobile phone is calling an international number 902129550330 through Mobile opertaor and SIP provider. 902129550330 is a registered number in SIP provider. FreeSBC registering to this SIP provider (NAP) as a user for this 90212955033 and act as a termination point for this number. Once Mobile phone calling 902129550330, FreeSBC detecting this called number and forward it out, with remapping called number of 13105894010@netg2.restcomm.com to Restcomm platform. This call will also get IVR DTMF acknowledgement for DTMF tones pressed. Same configuration steps as in call flow 3 with addition of FreeSBC register to NAP with username and password :
- IVR DID full number outside call - PhonerLite sends 'direct call' to FreeSBC with called information 1234@52.60.132.155. FreeSBC makes a mapping of called number to 13105894010@netg2.restcomm.com before making outgoing call to Restcomm platform. PhonerLite hears welcome greeting from Restcomm platform with IVR to ask caller to press '1', which will enable a separate call back from Restcomm platform. This separate call back is then routed through FreeSBC to the SIP provider and Telecom operator and onto an outside number of a Telecobridges office phone number set. Same configuration steps as in call flow 4.
PhonerLite Configuration
This section provides PhonerLite configurations for the solution.
PhonerLite direct call setting
Below are sections required to setup outbound direct call on PhonerLite,
Server setting: All Proxy/Registrar and Domain/Realm are empty
User setting
Network setting
Codecs and DTMF setting
For dialout, we can specify the called number as 1234@52.60.132.155 where 52.60.132.155 is the public Elastic IP used for voip interface in this FreeSBC AWS.
FreeSBC Configuration
This section provides FreeSBC configurations for the solution.
FreeSBC Local NAT Traversal setting
- See NAT section in Toolpack:Tsbc IP Network Settings 3.0
FreeSBC NAPs setting
- See Create SIP NAP and Create Open NAP
- Here, SIP NAP will be Restcomm NAP and Service Provider NAP, and Open NAP will be from PhonerLite
FreeSBC register to NAP with username and password
- The following sections need to be set, as in example below,
- In this example, FreeSBC is behind NAT, so local NAT method is set
FreeSBC routes setting
- See Create a Static Route
- Here, we set the SIP end points (NAP) to and from as required in each call flow scenario
FreeSBC route called remapping
- The following section needs to be set, and depending what called number remapping required as in each call flow scenario,
