IVR的全稱的Interactive Voice Response，就是我們經(jīng)常說的電話語音菜單。FreeSWITCH支持非常強大的語音菜單──你可以寫簡單的XML，或更靈活的Lua，當(dāng)然還有Event Socket，Erlang Socket等等。

　　這里，簡單介紹一下XML。其實語音菜單說來也簡單，說難也難。讓我們先來一個感性的認(rèn)識--其實，F(xiàn)reeSWITCH默認(rèn)的配置已包含了一個功能齊全的例子，隨便拿起一個分機，撥5000，就可以聽到菜單提示了，當(dāng)然，默認(rèn)的提示是英文的，大意是說歡迎來到FreeSWITCH，撥1進入FreeSWITCH會議；撥2進入回音（echo）程序，這時候可以聽到自己的回音；撥3聽等待音樂（MOH，Music on Hold），撥4會轉(zhuǎn)到FreeSWITCH開發(fā)者Brian West的SIP電話上；撥5你會聽到一只尖叫的猴子；撥6進入下級菜單；撥9重聽，撥1000-1019之間的號碼則會轉(zhuǎn)到對應(yīng)分機。

　　最簡單的菜單

　　感受這些之后，讓我們先來配置一種最簡單的情形。一些廉價的企業(yè)小交換機通常只能提供這點功能──“您好，歡迎致電XX公司，請直撥分機號，查號請撥0”。在此，我們假定使用FreeSWITCH的默認(rèn)配置，分機號為1000-1019，前臺分機號為0，撥0則轉(zhuǎn)人工臺，查號或轉(zhuǎn)接其它分機。

　　系統(tǒng)默認(rèn)的配置文件存放在/usr/local/freesiwtch/conf/autoload_configs/ivr.conf，配置文件是XML格式，菜單放到 中，而每一個即是一個菜單。并且，每個menu應(yīng)該有一個唯一的名字（name），以便在撥號計劃（dialplan）中引用。

<configuration name="ivr.conf" description="IVR menus">
  <menus>
    <menu name="demo_ivr">
    </menu>
  </menus>
</configuration>

好，我們先來實現(xiàn)上述最簡單的menu：

<menu name="welcome"
    greet-long="custom/welcome.wav"
    greet-short="custom/welcom_short.wav"
    invalid-sound="ivr/ivr-that_was_an_invalid_entry.wav"
    exit-sound="voicemail/vm-goodbye.wav"
    timeout="15000"
    max-failures="3"
    max-timeouts="3"
    inter-digit-timeout="2000"
    digit-len="4">

    <entry action="menu-exec-app" digits="0" param="transfer 1000 XML default"/>
    <entry action="menu-exec-app" digits="/^(10[01][0-9])$/" param="transfer $1 XML default"/>

</menu>

　　我們指定菜單的名字是welcome，greet-long即為最開始播放的語音--“您好，歡迎致電XX公司，請直撥分機號，查號請撥0”，該語音文件默認(rèn)的位置應(yīng)該是/usr/local/freeswitch/sounds/，所以，您應(yīng)該事先把聲音文件錄好，放到custom/welcome.wav（當(dāng)然，你也可以使用其它路徑，如/home/your_name/ivr/welcome.wav）。并且，由于PSTN交換機都是使用PCM編碼，所以，welcome.wav文件的格式應(yīng)為單聲道，8000HZ。

　　如果用戶長時間沒有按鍵，剛應(yīng)重新提示撥號，但重新提示應(yīng)該簡短，如“請直撥分機號，查號請撥0”。所以，可以錄制這么一個聲音文件放到custom/welcome_short.wav。

　　invalid-sound：如果用戶按錯了鍵，則會使用該提示。如果你安裝時指定了make sounds-install，則該文件應(yīng)該用默認(rèn)存在的，只是它是英文的，如果你需要中文的提示，可以自己錄一個放到custom中。

　　exit-sound：不說也知道，最后菜單退出時（一般時超時），會提示Good Bye。

　　timeout指定超時時間；max-failures容忍用戶按鍵錯誤的次數(shù)。max-timeouts即最大超時次數(shù)。inter-digit-timeout為兩次按鍵的最大間隔（毫秒），如用戶撥分機號1001時，如果撥了10，等2秒，然后再按01，這時系統(tǒng)收到的號碼為10，則會提示錯誤 invalid-sound。

　　digit-len說明菜單項的長度，在本例中，用戶分機號為4位。

　　該menu中有兩個選項，第一個是在用戶按0時, menu-exec-app執(zhí)行一個命令（參見mod_command），在此處它執(zhí)行transfer，將來話轉(zhuǎn)到分機1000。

　　如果來電用戶知道分機號，則可以直接撥分機號，而不用經(jīng)過前臺轉(zhuǎn)接，節(jié)約時間。在該例中，正則表達式"/^(10[01][0-9])$/" 會匹配用戶輸入1000-1019之間的分機，

　　以上菜單設(shè)定好后，需要在控制臺中執(zhí)行 reloadxml （或按F6）才可以配置生效。

　　配置完成后就可以在控制臺上進行測試：

　　FS> originate user/1001 &ivr(welcome)

　　測試成功后，當(dāng)然，你可能需要先把用戶來話轉(zhuǎn)到語音菜單。根據(jù)配置不同，用戶來話的接聽有多種配置方式，一般來說，來話會先到達public dialplan，所以，你可以在conf/dialplan/public.xml中加入一個extension:

    <extension name="incoming_call">
      <condition field="destination_number" expression="^你的DID號碼$">
 <action application="answer" data=""/>
 <action application="sleep" data="1000"/>
 <action application="ivr" data="welcome"/>
      </condition>
    </extension>

　　這樣，如果有外部呼叫進來，就可以聽到語音菜單了。

　　默認(rèn)菜單簡介

　　明白了以上簡單的菜單，就很容易理解更復(fù)雜一點的配置了。系統(tǒng)默認(rèn)提供了一個名字demo_ivr的菜單。最初的語音提示greet-long/greet-short是用phrase實現(xiàn)的。phrase是用XML定義的一些短語，最終也是播放聲音文件，但在多語言系統(tǒng)中會更靈活。在此，我們不討論phrase，你可以簡單的認(rèn)為它就是一個聲音文件。

　　菜單選項大多都是根據(jù)用戶按鍵使用menu-exec-app執(zhí)行相應(yīng)的命令，上面已經(jīng)講到了。menu-sub表示會執(zhí)行一個下級菜單，這樣，在下級菜單中（此外是demo_ivr_submenu）便可以用menu-top來返回上級菜單。

　　基本上就這么多。通過設(shè)置多級菜單，以及與dialplan配合，根據(jù)不同的情況進行跳轉(zhuǎn)，可以實現(xiàn)相當(dāng)復(fù)雜的一些功能。如果這些還不夠，可以嘗試一下更高級的LUA菜單或Event Socket。

　　調(diào)試

　　打開控制臺或fs_cli，按F8將loglevel調(diào)到debug狀態(tài)，能看到詳細的執(zhí)行過程。如果看到紅色的（如果你的控制臺不支持彩色，看ERROR的吧），可能是配置錯誤，不過一般會是聲音文件找不到之類的，檢查相應(yīng)路徑下是否有對應(yīng)的聲音文件。