Call Us Today! 877.742.2583




Page tree
Skip to end of metadata
Go to start of metadata

SignalWire CLOUD | FreeSWITCH Connector

        Product Description


Table of Contents


SignalWire CLOUD | FreeSWITCH Connector

Table of Contents

Overview

Capabilities

Voice

Messaging (Not yet available.)

Components

SignalWire Module (mod_signalwire)

SignalWire CLOUD Resources

CLOUD APIs

CLOUD Connector UI/UX

Connector navigation & main page

Create a Connector

In FreeSWITCH

For new installations

For existing installations

List of Connectors

Connector Settings & Caller ID

Associating Phone Numbers with Connectors

Pricing and Fees

Support



Overview


SignalWire CLOUD - FreeSWITCH Connector


Introducing SignalWire Cloud “Connectors”! Connectors enable external service connections to SignalWire CLOUD. They can do a varied number of things that range from configuring service to enabling new capabilities.


Since our open source FreeSWITCH product is a standalone communications platform that is already widely deployed, it only made sense that we create a Connector for FreeSWITCH.

Capabilities

FreeSWITCH Connector enables several valuable functions that will automate configuration and connect services. Without any additional configuration in the FreeSWITCH instance, FreeSWITCH can be connected to SignalWire CLOUD. When doing so the FreeSWITCH configuration will be automagically modified based on what CLOUD services are assembled under the Connector.

Voice

Voice resources including DIDs, Toll Free numbers can be purchased through CLOUD and directed to your FreeSWITCH Connector, which will automatically configure your FreeSWITCH instance to work with the Voice resources.

Messaging (Not yet available.)


Components

SignalWire Module (mod_signalwire)

This is a module that is part of FreeSWITCH v 1.8.3 (or later), check this link for latest release and STACK v 20.18.2 which can be obtained from SignalWire STACK repositories. Contact SignalWire Sales (sales@signalwire.com) for more information. Mod_signalwire installs as part of the default package and windows installs, and will loaded by default on new installs. See below for installation / loading instructions on existing installations.





SignalWire CLOUD Resources

The CLOUD APIs and dashboard can be used together to enable a FreeSWITCH Connector for voice. The intuitive dashboard will allow users to create the Connector that is associated with your FreeSWITCH. APIs take it to another level and allow for quite a bit of flexibility.

CLOUD APIs

SignalWire Cloud APIs are defined here: https://docs.signalwire.com/ 

RELAY APIs can be found here: https://docs.signalwire.com/relay-rest/

CLOUD Connector UI/UX

Here are some concepts for Connector UI, not likely the final concept, just a place to get started.

Connector navigation & main page


  • Click on Connectors, on left navigation bar

  • Above is the landing page for Connectors, where none have been configured.

  • Create new Connector





Create a Connector


  • Name, give the connector a name.

  • Select Connector type, from a dropdown you can select which connector you want to associate with this project.

  • To attain your token inside FreeSWITCH, read the following instructions.


NOTE
You will need to be running at least FreeSWITCH 1.8.3, or STACK 20.18.2 in order to load the SignalWire module.









In FreeSWITCH

For new installations


  • Open the FreeSWITCH CLI (console / command line interface)

  • Once installed, you should see the above token present itself.

  • Type “signalwire token”, and press enter.

  • The Connection Token will be presented below the SignalWire ASCII logo.

  • Insert that token into the create a Connector screen, shown above.


For existing installations

  • Open the FreeSWITCH CLI (console / command line interface)

  • You must add the module to your modules.conf.xml configuration file by adding the following  line: <load module="mod_signalwire"/>

  • Type “load mod_signalwire

  • The Connection Token will be presented below the SignalWire ASCII logo.

  • Insert that token into the create a Connector screen, shown above.

List of Connectors

  • Connection Name and Type


Connector Settings & Caller ID

  • Once the setup is complete, you can now enter the outbound Caller ID for this Connector which DID / Phone Number you would like to send calls as.


Associating Phone Numbers with Connectors

  • Select Phone Numbers from the left navigation bar

  • Then select the Number you wish to associate with your Connector.

  • Select Connector, and the Connector type you wish to associate with your SignalWire service.



Dialplan

 

/etc/freeswitch/dialplan/default.xml

 

 



Pricing and Fees


SignalWire Cloud fees are based on what our customers consume. There is no cost associated with the mod_signalwire module itself.

https://signalwire.com/disruptive-pricing

Support


API Documentation

https://docs.signalwire.com/relay-rest  


Slack Community

https://slack.signalwire.community 


instructions for setting up mod_signalwire on FreeSWITCH and creating a CLOUD Connector (private)

https://freeswitch.org/confluence/display/FREESWITCH/mod_signalwire 


Wiki (private)

https://github.com/signalwire/mod_gcloud/wiki