Book Image

FreeSWITCH Cookbook

Book Image

FreeSWITCH Cookbook

Overview of this book

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.
Table of Contents (12 chapters)
FreeSWITCH Cookbook
Credits
About the Authors
About the Reviewers
www.PacktPub.com
Preface
Index

Receiving faxes


The preceding recipe described the process of sending a fax. This recipe will describe the process of receiving a fax.

Getting ready

In its simplest format, receiving a fax requires only that you route an incoming call to an extension that then executes the rxfax dialplan application. As with the previous recipe, we can use our FreeSWITCH server to be both the sender and receiver of the fax. For our test we will use the same file we used in the Sending faxes recipe: /tmp/txfax-sample.tiff.

How to do it...

Execute these steps to do a simple fax transmission and reception:

  1. Launch fs_cli.

  2. Execute this command:

    originate loopback/9178 &txfax(/tmp/txfax-sample.tiff)
    

Watch the console and eventually the fax transmission should successfully finish.

How it works...

We use the fax_receive extension in the default dialplan to receive the fax transmission. This extension is quite simple:

<extension name="fax_receive">
  <condition field="destination_number" expression="^9178$...