Search icon CANCEL
Subscription
0
Cart icon
Your Cart (0 item)
Close icon
You have no products in your basket yet
Arrow left icon
Explore Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Newsletter Hub
Free Learning
Arrow right icon
timer SALE ENDS IN
0 Days
:
00 Hours
:
00 Minutes
:
00 Seconds
FreeSWITCH Cookbook
FreeSWITCH Cookbook

FreeSWITCH Cookbook: Written by members of the FreeSWITCH team, this is the ultimate guide to getting the most out of the platform. Stuffed with over 40 recipes, just about every angle is covered, from call routing to enabling text-to-speech conversion.

eBook
$13.98 $19.99
Paperback
$32.99
Subscription
Free Trial
Renews at $19.99p/m

What do you get with Print?

Product feature icon Instant access to your digital copy whilst your Print order is Shipped
Product feature icon Paperback book shipped to your preferred address
Product feature icon Redeem a companion digital copy on all Print orders
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
OR
Modal Close icon
Payment Processing...
tick Completed

Shipping Address

Billing Address

Shipping Methods
Table of content icon View table of contents Preview book icon Preview Book

FreeSWITCH Cookbook

Chapter 2. Connecting Telephones and Service Providers

In this chapter, we will cover:

  • Configuring a SIP phone to register with FreeSWITCH

  • Connecting audio devices with PortAudio

  • Using FreeSWITCH as a softphone

  • Configuring a SIP gateway

  • Configuring Google Voice

  • Codec configuration

Introduction


As its name implies, FreeSWITCH will "switch" or "connect" various endpoints together. Part of that switching involves making semi-permanent connections to individual telephones or telephone service providers. Service providers are usually telephone companies (telcos) or ITSPs (Internet Telephony Service Providers). Read on to learn about the many ways that FreeSWITCH can connect your telephone to the world.

The recipes in this chapter will delve into the various ways to connect FreeSWITCH to telephones and service providers. FreeSWITCH can also utilize a locally installed sound card by means of the PortAudio library. The last recipe is for advanced users and discusses the subject of codec negotiation.

Configuring a SIP phone to register with FreeSWITCH


SIP phones or any SIP device with the ability to register, are essential in most FreeSWITCH installations for allowing users to communicate with each other. A registration is when a phone or other device informs FreeSWITCH that it is active and provides information (such as an IP address and port) on how to reach the phone across the network or Internet. FreeSWITCH stores this information for use later if someone wishes to contact the phone.

In this recipe, you will be registering a phone to FreeSWITCH. You will need to enter your credentials into your phone as well as into FreeSWITCH itself (both sides must match). We will cover only the FreeSWITCH server portion of registration in this book.

Getting ready

Ensure the mod_sofia module is already compiled and loaded (Sofia is the SIP stack). You may also want to ensure the IP address your registrations are being accepted on for a particular domain name.

Follow these steps:

  1. Launch the FreeSWITCH...

Connecting audio devices with PortAudio


Many of us have a USB headset or a sound card in our laptops or desktop computers. In most cases, FreeSWITCH can utilize these audio devices. Usually this is done for basic troubleshooting or to feed an external audio source into FreeSWITCH. It is also handy when you wish to use FreeSWITCH as a softphone, which is demonstrated later in this chapter.

Getting ready

The mod_portaudio module is already compiled for Windows users when using the Visual Studio 2008/2010 solution files with the FreeSWITCH source code. Linux and Mac OSX users will need to enable mod_portaudio in their FreeSWITCH installation. Follow these steps:

  1. Open modules.conf in the FreeSWITCH source directory and remove the comment on the #endpoints/portaudio line. Save the file and exit.

  2. Compile mod_portaudio using the following command:

    make mod_portaudio-install
    
  3. If you want to have mod_portaudio load automatically each time you start FreeSWITCH then edit conf/autoload_configs/modules...

Using FreeSWITCH as a softphone


The previous recipe described the process of setting up FreeSWITCH to use a local audio device such as a USB headset or a sound card. This recipe builds on the previous one by showing you how to use a custom FreeSWITCH configuration that is tailored specifically for use as a softphone (be sure to have PortAudio working before trying this recipe). Lastly, we will direct your attention to a few open source softphone projects that utilize FreeSWITCH as the VoIP engine.

Getting ready

This operation requires that we download a preconfigured FreeSWITCH configuration file. Follow these steps:

  1. Stop FreeSWITCH with this command:

    freeswitch –stop
    
  2. Back up your existing configuration (if desired). In a Linux/Unix environment a command like this would suffice:

    mv /usr/local/freeswitch/conf /usr/local/freeswith/conf.bak
    

    Windows users can use the File Manager to rename the conf folder.

  3. You can retrieve the softphone configuration from the FreeSWITCH sample configs git repository...

Configuring a SIP gateway


Configuring a SIP gateway allows you to connect with outside carriers or other SIP machines. You can connect with other FreeSWITCH or Asterisk boxes, or to upstream carrier SIP trunks.

SIP gateways have many, many options—too many to list here, so we'll review just a few.

Getting ready

First you'll need to gather some information about the remote server to which you are connecting. The list generally includes:

  • IP address or hostname of the server you are connecting to

  • Username and password (if any)

  • How the carrier/gateway expects Caller ID to be handled (which SIP header Caller ID should be placed in)

  • Whether registration is required

You'll also need to know the phone number format your carrier expects when you send calls to them, and how they'll send calls to you.

Finally, you'll need to decide which of your existing SIP interfaces to tie this gateway to. All gateways must be associated with a SIP interface (port and IP address). Note that, in most cases, a gateway can...

Configuring Google Voice


Google Voice (also known as Google Talk) is accessed via the mod_dingaling module, which provides XMPP support. (If you would like to learn more about XMPP, visit http://xmpp.org.) Mod_dingaling can act as both a XMPP server and a XMPP client, though it is generally used for its client abilities. With Google Voice, XMPP simply serves to establish sessions (much like SIP) and the audio properties and stream are otherwise merely RTP, just as in any VoIP call, using codecs you already know, like PCMU, GSM, and so on.

When using Google Voice with FreeSWITCH, your FreeSWITCH system initiates connections to or from Google Voice and can convert the audio and signaling into any other form—including SIP. This allows calls from Google Voice to your SIP phone and vice versa.

Getting ready

To get started, you're going to need your Google Voice user credentials. The process after that is straightforward.

How to do it...

You will need to modify the jingle profile's client file, which...

Codec configuration


Codec configuration is very versatile in FreeSWITCH. In IP telephony, there are several differing scenarios for negotiating and choosing codecs. To meet the varying demands, FreeSWITCH has several configurable modes of operation as well as real-time variables that can influence how codec negotiation takes place. Typically the goal should be to reduce transcoding or resampling as much as possible. Transcoding is the case where two sides of the call have different codecs and audio flowing in either direction has to be completely decoded and re-encoded to the opposite channel's format. Resampling is similar but it is required when each side of the call is running at a different sample rate and the audio has to be "resampled" to the correct rate. One or both of these can be necessary depending on where you direct your calls to and how you have your codec configuration set.

Getting ready

The biggest decision to make up front is late-negotiation or early-negotiation. This setting...

Left arrow icon Right arrow icon

Key benefits

  • Get powerful FreeSWITCH features to work for you
  • Route calls and handle call detailing records
  • Written by members of the FreeSWITCH development team

Description

FreeSWITCH is an open source telephony platform designed to facilitate the creation of voice, chat, and video applications. It can scale from a soft-phone to a PBX and even up to an enterprise-class softswitch.In the FreeSWITCH Cookbook, members of the FreeSWITCH development team share some of their hard-earned knowledge with you in the book's recipes. Use this knowledge to improve and expand your FreeSWITCH installations.The FreeSWITCH Cookbook is an essential addition to any VoIP administrator's library.The book starts with recipes on how to handle call routing and then discusses connecting your FreeSWITCH server to the outside world.It then teaches you more advanced topics like CDR handling, practical examples of controlling FreeSWITCH with the event socket, and configuring many features commonly associated with a PBX installation.

Who is this book for?

If you are a system administrator, hobbyist, or someone who uses FreeSWITCH on a regular basis, this book is for you. Whether you are a FreeSWITCH expert or just getting started, this book will take your skills to the next level.

What you will learn

  • Configure users and phones as well as connections to VoIP providers and even Google Voice
  • Control FreeSWITCH remotely with the powerful event socket interface
  • Route inbound and outbound calls
  • Handle call detail records, which includes inserting CDRs into a database
  • Enable text-to-speech conversion in your voice applications
  • Monitor calls via the FreeSWITCH Web interface
Estimated delivery fee Deliver to United States

Economy delivery 10 - 13 business days

Free $6.95

Premium delivery 6 - 9 business days

$21.95
(Includes tracking information)

Product Details

Country selected
Publication date, Length, Edition, Language, ISBN-13
Publication date : Feb 23, 2012
Length: 150 pages
Edition : 1st
Language : English
ISBN-13 : 9781849515405
Vendor :
FreeSWITCH
Languages :
Concepts :
Tools :

What do you get with Print?

Product feature icon Instant access to your digital copy whilst your Print order is Shipped
Product feature icon Paperback book shipped to your preferred address
Product feature icon Redeem a companion digital copy on all Print orders
Product feature icon Access this title in our online reader with advanced features
Product feature icon DRM FREE - Read whenever, wherever and however you want
OR
Modal Close icon
Payment Processing...
tick Completed

Shipping Address

Billing Address

Shipping Methods
Estimated delivery fee Deliver to United States

Economy delivery 10 - 13 business days

Free $6.95

Premium delivery 6 - 9 business days

$21.95
(Includes tracking information)

Product Details

Publication date : Feb 23, 2012
Length: 150 pages
Edition : 1st
Language : English
ISBN-13 : 9781849515405
Vendor :
FreeSWITCH
Languages :
Concepts :
Tools :

Packt Subscriptions

See our plans and pricing
Modal Close icon
$19.99 billed monthly
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Simple pricing, no contract
$199.99 billed annually
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts
$279.99 billed in 18 months
Feature tick icon Unlimited access to Packt's library of 7,000+ practical books and videos
Feature tick icon Constantly refreshed with 50+ new titles a month
Feature tick icon Exclusive Early access to books as they're written
Feature tick icon Solve problems while you work with advanced search and reference features
Feature tick icon Offline reading on the mobile app
Feature tick icon Choose a DRM-free eBook or Video every month to keep
Feature tick icon PLUS own as many other DRM-free eBooks or Videos as you like for just $5 each
Feature tick icon Exclusive print discounts

Frequently bought together


Stars icon
Total $51.96 $74.97 $23.01 saved
FreeSWITCH 1.0.6
$43.99
FreeSWITCH Cookbook
$32.99
FreeSWITCH 1.2
$48.99
Total $51.96$74.97 $23.01 saved Stars icon

Table of Contents

5 Chapters
Routing Calls Chevron down icon Chevron up icon
Connecting Telephones and Service Providers Chevron down icon Chevron up icon
Processing Call Detail Records Chevron down icon Chevron up icon
External Control Chevron down icon Chevron up icon
PBX Functionality Chevron down icon Chevron up icon

Customer reviews

Top Reviews
Rating distribution
Full star icon Full star icon Full star icon Full star icon Half star icon 4.5
(8 Ratings)
5 star 62.5%
4 star 25%
3 star 12.5%
2 star 0%
1 star 0%
Filter icon Filter
Top Reviews

Filter reviews by




FelixTurcotte May 20, 2015
Full star icon Full star icon Full star icon Full star icon Full star icon 5
Very good book
Amazon Verified review Amazon
Ali R. Mar 07, 2012
Full star icon Full star icon Full star icon Full star icon Full star icon 5
There are many solid reasons why FreeSWITCH is the best telephony platform but being the best comes at the cost of complexity. This book makes working with FreeSWITCH so easy. Clearly displayed in a format capable for any beginner to quickly grasp and comprehend this piece of art platform. This book is essential reference material.Ali_R
Amazon Verified review Amazon
BHUPENDRA SINGH Jun 11, 2012
Full star icon Full star icon Full star icon Full star icon Full star icon 5
This is great book for anyone trying to get hands on FreeSwitch specially newbies. This is must have book for a FreeSwitch user. Just easy to read. It starts with basic configuration and dives into detailed CDR usage, PBX functionality, mod_flite etc.. I highly recommend this book.
Amazon Verified review Amazon
SuperG Dec 06, 2014
Full star icon Full star icon Full star icon Full star icon Full star icon 5
Anthony and crew are pure genius. I'm pretty sure they changed the world more than most.
Amazon Verified review Amazon
Julio Saldivar Mar 28, 2012
Full star icon Full star icon Full star icon Full star icon Full star icon 5
freeswitch is a big application and this book is excellent. 100% recommended. this book is accurate, practical and clear in his explanations
Amazon Verified review Amazon
Get free access to Packt library with over 7500+ books and video courses for 7 days!
Start Free Trial

FAQs

What is the digital copy I get with my Print order? Chevron down icon Chevron up icon

When you buy any Print edition of our Books, you can redeem (for free) the eBook edition of the Print Book you’ve purchased. This gives you instant access to your book when you make an order via PDF, EPUB or our online Reader experience.

What is the delivery time and cost of print book? Chevron down icon Chevron up icon

Shipping Details

USA:

'

Economy: Delivery to most addresses in the US within 10-15 business days

Premium: Trackable Delivery to most addresses in the US within 3-8 business days

UK:

Economy: Delivery to most addresses in the U.K. within 7-9 business days.
Shipments are not trackable

Premium: Trackable delivery to most addresses in the U.K. within 3-4 business days!
Add one extra business day for deliveries to Northern Ireland and Scottish Highlands and islands

EU:

Premium: Trackable delivery to most EU destinations within 4-9 business days.

Australia:

Economy: Can deliver to P. O. Boxes and private residences.
Trackable service with delivery to addresses in Australia only.
Delivery time ranges from 7-9 business days for VIC and 8-10 business days for Interstate metro
Delivery time is up to 15 business days for remote areas of WA, NT & QLD.

Premium: Delivery to addresses in Australia only
Trackable delivery to most P. O. Boxes and private residences in Australia within 4-5 days based on the distance to a destination following dispatch.

India:

Premium: Delivery to most Indian addresses within 5-6 business days

Rest of the World:

Premium: Countries in the American continent: Trackable delivery to most countries within 4-7 business days

Asia:

Premium: Delivery to most Asian addresses within 5-9 business days

Disclaimer:
All orders received before 5 PM U.K time would start printing from the next business day. So the estimated delivery times start from the next day as well. Orders received after 5 PM U.K time (in our internal systems) on a business day or anytime on the weekend will begin printing the second to next business day. For example, an order placed at 11 AM today will begin printing tomorrow, whereas an order placed at 9 PM tonight will begin printing the day after tomorrow.


Unfortunately, due to several restrictions, we are unable to ship to the following countries:

  1. Afghanistan
  2. American Samoa
  3. Belarus
  4. Brunei Darussalam
  5. Central African Republic
  6. The Democratic Republic of Congo
  7. Eritrea
  8. Guinea-bissau
  9. Iran
  10. Lebanon
  11. Libiya Arab Jamahriya
  12. Somalia
  13. Sudan
  14. Russian Federation
  15. Syrian Arab Republic
  16. Ukraine
  17. Venezuela
What is custom duty/charge? Chevron down icon Chevron up icon

Customs duty are charges levied on goods when they cross international borders. It is a tax that is imposed on imported goods. These duties are charged by special authorities and bodies created by local governments and are meant to protect local industries, economies, and businesses.

Do I have to pay customs charges for the print book order? Chevron down icon Chevron up icon

The orders shipped to the countries that are listed under EU27 will not bear custom charges. They are paid by Packt as part of the order.

List of EU27 countries: www.gov.uk/eu-eea:

A custom duty or localized taxes may be applicable on the shipment and would be charged by the recipient country outside of the EU27 which should be paid by the customer and these duties are not included in the shipping charges been charged on the order.

How do I know my custom duty charges? Chevron down icon Chevron up icon

The amount of duty payable varies greatly depending on the imported goods, the country of origin and several other factors like the total invoice amount or dimensions like weight, and other such criteria applicable in your country.

For example:

  • If you live in Mexico, and the declared value of your ordered items is over $ 50, for you to receive a package, you will have to pay additional import tax of 19% which will be $ 9.50 to the courier service.
  • Whereas if you live in Turkey, and the declared value of your ordered items is over € 22, for you to receive a package, you will have to pay additional import tax of 18% which will be € 3.96 to the courier service.
How can I cancel my order? Chevron down icon Chevron up icon

Cancellation Policy for Published Printed Books:

You can cancel any order within 1 hour of placing the order. Simply contact customercare@packt.com with your order details or payment transaction id. If your order has already started the shipment process, we will do our best to stop it. However, if it is already on the way to you then when you receive it, you can contact us at customercare@packt.com using the returns and refund process.

Please understand that Packt Publishing cannot provide refunds or cancel any order except for the cases described in our Return Policy (i.e. Packt Publishing agrees to replace your printed book because it arrives damaged or material defect in book), Packt Publishing will not accept returns.

What is your returns and refunds policy? Chevron down icon Chevron up icon

Return Policy:

We want you to be happy with your purchase from Packtpub.com. We will not hassle you with returning print books to us. If the print book you receive from us is incorrect, damaged, doesn't work or is unacceptably late, please contact Customer Relations Team on customercare@packt.com with the order number and issue details as explained below:

  1. If you ordered (eBook, Video or Print Book) incorrectly or accidentally, please contact Customer Relations Team on customercare@packt.com within one hour of placing the order and we will replace/refund you the item cost.
  2. Sadly, if your eBook or Video file is faulty or a fault occurs during the eBook or Video being made available to you, i.e. during download then you should contact Customer Relations Team within 14 days of purchase on customercare@packt.com who will be able to resolve this issue for you.
  3. You will have a choice of replacement or refund of the problem items.(damaged, defective or incorrect)
  4. Once Customer Care Team confirms that you will be refunded, you should receive the refund within 10 to 12 working days.
  5. If you are only requesting a refund of one book from a multiple order, then we will refund you the appropriate single item.
  6. Where the items were shipped under a free shipping offer, there will be no shipping costs to refund.

On the off chance your printed book arrives damaged, with book material defect, contact our Customer Relation Team on customercare@packt.com within 14 days of receipt of the book with appropriate evidence of damage and we will work with you to secure a replacement copy, if necessary. Please note that each printed book you order from us is individually made by Packt's professional book-printing partner which is on a print-on-demand basis.

What tax is charged? Chevron down icon Chevron up icon

Currently, no tax is charged on the purchase of any print book (subject to change based on the laws and regulations). A localized VAT fee is charged only to our European and UK customers on eBooks, Video and subscriptions that they buy. GST is charged to Indian customers for eBooks and video purchases.

What payment methods can I use? Chevron down icon Chevron up icon

You can pay with the following card types:

  1. Visa Debit
  2. Visa Credit
  3. MasterCard
  4. PayPal
What is the delivery time and cost of print books? Chevron down icon Chevron up icon

Shipping Details

USA:

'

Economy: Delivery to most addresses in the US within 10-15 business days

Premium: Trackable Delivery to most addresses in the US within 3-8 business days

UK:

Economy: Delivery to most addresses in the U.K. within 7-9 business days.
Shipments are not trackable

Premium: Trackable delivery to most addresses in the U.K. within 3-4 business days!
Add one extra business day for deliveries to Northern Ireland and Scottish Highlands and islands

EU:

Premium: Trackable delivery to most EU destinations within 4-9 business days.

Australia:

Economy: Can deliver to P. O. Boxes and private residences.
Trackable service with delivery to addresses in Australia only.
Delivery time ranges from 7-9 business days for VIC and 8-10 business days for Interstate metro
Delivery time is up to 15 business days for remote areas of WA, NT & QLD.

Premium: Delivery to addresses in Australia only
Trackable delivery to most P. O. Boxes and private residences in Australia within 4-5 days based on the distance to a destination following dispatch.

India:

Premium: Delivery to most Indian addresses within 5-6 business days

Rest of the World:

Premium: Countries in the American continent: Trackable delivery to most countries within 4-7 business days

Asia:

Premium: Delivery to most Asian addresses within 5-9 business days

Disclaimer:
All orders received before 5 PM U.K time would start printing from the next business day. So the estimated delivery times start from the next day as well. Orders received after 5 PM U.K time (in our internal systems) on a business day or anytime on the weekend will begin printing the second to next business day. For example, an order placed at 11 AM today will begin printing tomorrow, whereas an order placed at 9 PM tonight will begin printing the day after tomorrow.


Unfortunately, due to several restrictions, we are unable to ship to the following countries:

  1. Afghanistan
  2. American Samoa
  3. Belarus
  4. Brunei Darussalam
  5. Central African Republic
  6. The Democratic Republic of Congo
  7. Eritrea
  8. Guinea-bissau
  9. Iran
  10. Lebanon
  11. Libiya Arab Jamahriya
  12. Somalia
  13. Sudan
  14. Russian Federation
  15. Syrian Arab Republic
  16. Ukraine
  17. Venezuela