From FreeSWITCH Wiki

Contents 1 Introduction 1.1 Information for prospective authors 2 Recipe Suggestions 2.1 Download/Installing 2.2 Billing & CDR 2.3 System Configuration 2.3.1 Security 2.3.2 Dealing with NAT 2.3.3 Configuring VoIP Accounts 2.3.4 SBC 2.3.5 Softphone 2.3.6 Presence 2.3.7 Codecs 2.4 Design 2.4.1 Clustering 2.5 Dialplan 2.5.1 LDAP integration via OpenLDAP 2.5.2 SOS Receptionist Button 2.5.3 Server Side Call Forwarding 2.5.4 Dial plan for video conference 2.6 Users/Directory 2.7 Applications 2.7.1 XML IVRs 2.7.2 ASR/TTS 2.7.2.1 Flite 2.7.2.2 Cepstral 2.7.2.3 UniMRCP 2.7.3 Conference 2.7.4 Recording 2.7.5 Queue (fifo, valet parking) 2.7.6 Fax 2.7.7 Music on Hold 2.7.8 Voicemail 2.8 Dialplan Scripting (mod_lua/mod_perl/mod_spidermonkey) 2.9 Event Socket Scripting/ESL 2.10 XML Curl 2.11 GUIs 2.12 Converting From Asterisk to FreeSWITCH 2.13 Troubleshooting 2.13.1 FS console logs 2.13.2 PCAPs 2.13.3 Evil NAT 2.13.4 Events 2.13.5 Reporting Bugs 2.14 Testing 2.14.1 SIPp 2.15 Multicast examples 2.16 Connecting to different endpoints/providers 2.16.1 SIP (connect to * or another FS box) 2.16.2 Skype 2.16.3 Google Talk 2.16.4 Apple's FaceTime 2.16.5 H.323? 2.17 Chat interface 3 Questions 4 See Also

Introduction

Recipies have already been turned in to Pact!

We are collecting the proverbial recipes for a FreeSWITCH Cookbook! Please give us your ideas for recipes. If you have a recipe already written out then contact Michael S Collins (IRC: mercutioviz) so that we can get them organized.

Information for prospective authors

Here is our list of recipes:

• Recipe List

Packt provides some information for authors:

• Cookbook Tips for Authors
• Author guidelines

Recipe Suggestions

Please place your recipe suggestions in one of the sections below. If there isn't a section for your recipe then please create one.

Download/Installing

including

• how to use FreeTDM (with Sangoma A102D, B700 cards)
• how to setup a fax-gateway (mod_spandsp in T38 Gateway / termination Mode)
• how to install on Mac OS X (Server)

Billing & CDR

including

• mod_xml_cdr for CDR in XML format
• mod_cdr_csv for CDR format in CSV
• mod_radius_cdr for Radius CDR storage
• CDR parsing and rating.
• relationships between a legs and b legs in various call scenarios

System Configuration

Security

How to best configure FreeSWITCH so that it is safe from potential attackers:

• rate limiting of calls
• sample firewalling configuration
• how to identify that you are being attacked

Dealing with NAT

Configuring VoIP Accounts

• How to ensure that the users hear the correct dialtones if extensions are configured in multiple countries.

SBC

Softphone

Presence

made BLF lamps blinking or use XMPP?

Codecs

How to make calls from / to an RTMP - phone

How to use Sangomas Voice Transcoding Cards

Design

Clustering

Dialplan

LDAP integration via OpenLDAP

I'm ghenry@OpenLDAP.org so will do this part.

SOS Receptionist Button

Nik Martin - I wrote a dialplan feature that allows a person to hit a speeddial on their phone that silently rings all phones and displays a help message. The receptionists phone does not ring, even on speaker.

Server Side Call Forwarding

mod_db + ivr to provide server side call forwarding, for use in dialplans where users are in complex dial groups, making 302 REDIRECT forwarding from an endpoint impractical. IVR would prompt user for FW number, then insert it into mod_db. Then entry point into dialplan checks for forward from DB before continuing.

Dial plan for video conference

• mod_conference changes for HD video conference.
• Explanation of MeetMe conference and dialout.

Users/Directory

Applications

XML IVRs

ASR/TTS

Flite

Cepstral

UniMRCP

Conference

Monitoring Conferences via Webservice/CGI like conference.freeswitch.org

Recording

Recording in different file formats, codec.

Recording only a particular leg.

Recording both legs separately in 2 different files.

Queue (fifo, valet parking)

Fax

Forwarding faxes to configured mail boxes.

Send faxes with text files.

Using Hylafax with mod_spandsp (there are many Hylafax Clients/Frameworks out there)

Music on Hold

Live from an audio input

Voicemail

bkw's trick to have voicemail call your phone so you can listen live while someone is leaving you a message.

Add a method for vm user to leave a message for another vm user via bind_meta_app

Howto configure voicemail so that it works in different languages according to incoming call source, or the configuration of a specific extension.

Dialplan Scripting (mod_lua/mod_perl/mod_spidermonkey)

Event Socket Scripting/ESL

How to make scheduled calls with inbound event socket.

Interactive dialer - Get the digits from caller and put him to listen some music when bridging to the dialed number.

Multi users conference initiated by one button on the phone (like the local conference on Polycom phones, but not limited to 3-4 users).

Howto integrate with Windows (TAPI/Outlook/Click2Dial/Pop-Up on incoming Calls/...)

XML Curl

GUIs

Converting From Asterisk to FreeSWITCH

• AGI
• AMI

Troubleshooting

FS console logs

PCAPs

Evil NAT

Events

Reporting Bugs

Testing

SIPp

Multicast examples

Connecting to different endpoints/providers

SIP (connect to * or another FS box)

• How to send < and > characters in SIP messages
• How to send/modify P-parameters e.g. P-Asserted-Identity

Skype

Google Talk

Apple's FaceTime

H.323?

Chat interface

Questions

Gang - what do you think of the converting from Asterisk to FreeSWITCH cookbook section? Is it a good idea? Are we biting off more than we can chew? Let me know what you think. Also, please jot down your thoughts on what to include in such a conversion chapter.

See Also