)
Asterisk 的撥號計劃Dialplan是所有 VoIP 管理員遲早要啃的硬骨頭。我第一次接觸它的時候面對/etc/asterisk/extensions.conf里那一堆exten 的行腦子里全是問號這到底是在寫腳本還是在配電話交換機(jī)后來靜下心逐個應(yīng)用去試才發(fā)現(xiàn)真正的入門鑰匙根本不是Dial()那類復(fù)雜應(yīng)用而是最不起眼的三個基礎(chǔ)應(yīng)用Answer()、Playback()、Hangup()。毫不夸張地說把這三個應(yīng)用吃透Dialplan 的骨架就立起來了后面再學(xué)路由、排隊、IVR 只是往骨架上添肌肉。這篇文章就圍繞這三個應(yīng)用展開講清楚它們各自干什么、為什么需要它們、組合起來能搭建什么再給出一套可以直接照著抄的完整配置和調(diào)試方法。適合剛接觸 Asterisk 的運維新人、準(zhǔn)備做電話機(jī)器人的開發(fā)者以及想系統(tǒng)梳理流程細(xì)節(jié)的入門者。我把原理、語法、踩坑經(jīng)歷全部揉在一起你跟著走一遍至少能獨立寫出第一個能跑通的自動應(yīng)答流程。1. 先把地圖攤開Dialplan 到底在解決什么問題1.1 從一次電話通話看 Asterisk 的角色想象一次最普通的呼叫用戶拿起話筒撥了個號碼。這通電話到了 Asterisk 之后會發(fā)生什么Asterisk 本身不會平白無故知道“該放語音”“該轉(zhuǎn)給誰”“該掛斷”它只有一套機(jī)制把通話交給 Dialplan 去執(zhí)行。Dialplan 就是 Asterisk 的劇本每一通進(jìn)來的呼叫都要按劇本往下走。這個劇本寫在extensions.conf里由一個個“上下文context”組成。每個上下文相當(dāng)于一個權(quán)限邊界或一個功能場景比如[internal]管內(nèi)部電話、[incoming]管外線來電。上下文里面躺著若干“分機(jī)extension”但這里的 extension 不只是電話號碼它也可以是失配時的兜底標(biāo)簽s、超時標(biāo)簽t、無效按鍵標(biāo)簽i。每個 extension 后面跟一串優(yōu)先級priority優(yōu)先級從 1 開始用n表示“下一條”。Asterisk 按照“上下文 → 分機(jī) → 優(yōu)先級”的順序逐條執(zhí)行像是讀一張寫滿指令的卡片。為什么理解這個模型很重要因為后續(xù)所有業(yè)務(wù)邏輯IVR、隊列、語音信箱、外呼計劃本質(zhì)上都是在往這張卡片上添加指令行。如果你連最基本的執(zhí)行順序都搞不清后面一旦出現(xiàn)“明明寫了播放卻聽不到聲音”“電話一接就斷”這類問題排查起來會特別痛苦。先把這個運行模型刻進(jìn)腦子里再看具體應(yīng)用就順多了。1.2 為什么這仨應(yīng)用是“最小開場組合”先問一個問題一通電進(jìn)來Asterisk 最少要做哪幾件事才算“有意義地處理”了答案是三件接通Answer→ 干點事Playback→ 收尾Hangup。接通用Answer()干的事先用最樸素的“放一段語音”也就是Playback()最后用Hangup()把通話資源釋放掉。這三步拼起來就是所有電話流程的最小閉環(huán)。有朋友可能會說“我不用 Answer 直接 Playback 也能放聲音啊。” 這種情況確實存在但結(jié)果不可控在某些通道上未接通時播放會導(dǎo)致音頻路徑?jīng)]有完全建立撥號方聽到的是半截話或者壓根沒聲音更重要的是沒有 Answer 時通道狀態(tài)沒有正確切換計費、話單、后續(xù)轉(zhuǎn)接都會出問題。所以規(guī)范做法永遠(yuǎn)是先 Answer再操作最后 Hangup。這也是為什么官方示例幾乎都是這個套路。再看Hangup()。很多人會覺得“掛斷還需要專門寫一個應(yīng)用” 其實需要尤其是你要控制掛斷原因碼、要在掛斷前執(zhí)行清理操作的時候。就算不寫它Dialplan 走到結(jié)尾 Asterisk 也會自動掛斷但顯式調(diào)用能讓你掌握主動權(quán)話單上的原因碼也更干凈。這個三件套組合本質(zhì)上是讓你用最少的語法建立對通道生命周期——建立、使用、釋放——的完整感知。1.3 配置文件的三個組成部分general、globals 與上下文打開extensions.conf通常會看到三個區(qū)域[general]全局設(shè)置區(qū)比如staticyes表示只允許通過文件修改撥號計劃禁止在 CLI 里動態(tài)改。[globals]全局變量定義區(qū)可以定義類似EXT1000的變量后面用${EXT}引用。各業(yè)務(wù)上下文[incoming]、[default]、[internal]這類方括號片段真正放執(zhí)行指令的地方。新手最容易犯的一個錯是把[general]和[globals]當(dāng)成普通上下文往里寫路由結(jié)果發(fā)現(xiàn)怎么都不執(zhí)行。正確理解是前兩個是“元信息”只有業(yè)務(wù)上下文才是通道真正會進(jìn)入的劇本。一個通道最終會進(jìn)入哪個上下文通常由上游通道配置決定。比如 SIP 分機(jī)或中繼配置里會指定contextincomingPBX 收到來電后就把呼叫交給[incoming]處理。如果這個映射沒配好Dialplan 寫得再漂亮也不會被觸發(fā)。這也是很多人“配置了卻沒反應(yīng)”的第一大原因——腳本沒問題但通道根本就沒走進(jìn)來。2. 三個基礎(chǔ)應(yīng)用逐個拆開看2.1 Answer()接通動作背后的信號順序Answer()的語法極簡就是exten s,1,Answer()沒有參數(shù)。它做的事情是把當(dāng)前通道從未應(yīng)答狀態(tài)切換到已應(yīng)答狀態(tài)。對于 SIP 通道而言這一步等價于向?qū)Χ嘶厮?00 OK響應(yīng)同時建立雙向媒體流對于模擬 FXS/FXO 通道則是真正摘機(jī)。這里有個關(guān)鍵點Answer 不是瞬間完成的也不會阻塞很長時間。執(zhí)行完后Dialplan 立刻執(zhí)行下一行。如果需要給對方一點反應(yīng)時間常規(guī)做法是接一行Wait(1)或Wait(2)這在播放提示音之前尤其常用。Answer()還有返回值的概念成功返回 0失敗返回 -1。雖然多數(shù)場景下你不需要關(guān)心返回值但在調(diào)試時通過core show application answer看幫助文檔能確認(rèn)細(xì)節(jié)。實際操作里要注意如果通道已經(jīng)處于應(yīng)答狀態(tài)再次調(diào)用Answer()不會報錯只會安靜地立即返回。所以別擔(dān)心多寫一行 Answer 會把通話搞壞它是個冪等性很好的操作。另一個實際經(jīng)驗?zāi)承┩夂魣鼍跋翨 端電話振鈴后由 Asterisk 發(fā)起呼叫并等待被叫應(yīng)答這時候“接通”發(fā)生在被叫通道上而不是主叫通道。如果你在 Dialplan 里對主叫先執(zhí)行 Answer行為會和來電場景略有差異。這也是為什么建議先跑通一個最簡單的來電場景再考慮外呼。2.2 Playback()播音員的工作方式Playback()的核心作用就是播放一個或多個語音文件語法是exten s,n,Playback(/路徑/文件名)需要注意Playback()執(zhí)行期間不做任何按鍵收集。也就是說如果對方在播放中途按了數(shù)字鍵這些 DTMF 信號要么被忽略要么被暫存到通道里但 Dialplan 不會因此跳轉(zhuǎn)。這和后面要講的Background()有本質(zhì)區(qū)別Background()是邊放音邊監(jiān)聽按鍵Playback()是只顧著放完為止。它還支持一次播多個文件用連接Playback(hello-worldbeep)Asterisk 會順序播放。返回值同樣是 0 或 -1放完正常返回 0在播放過程中通道掛斷則返回 -1。這個返回值在做“掛斷檢測”時有用比如播放中途用戶掛斷你想立刻停止后續(xù)流程。文件路徑上有個容易踩的坑不要隨便加擴(kuò)展名也不要寫錯路徑基準(zhǔn)。Asterisk 會基于系統(tǒng)聲音目錄/var/lib/asterisk/sounds去查找文件。比如寫Playback(hello-world)它會嘗試在聲音目錄下找hello-world.gsm、hello-world.wav、hello-world.ulaw等格式中的一種并選一個與當(dāng)前通道編碼匹配的進(jìn)行播放。如果你自己放了一個/opt/mysounds/promo.wav路徑要寫完整且權(quán)限必須讓 Asterisk 運行用戶能讀。個人經(jīng)驗是先用系統(tǒng)自帶的hello-world、beep這類文件跑通鏈路再換自定義音頻這樣能把“配置問題”和“素材問題”分開排查。2.3 Hangup()如何優(yōu)雅地結(jié)束通話Hangup()語法為exten s,n,Hangup(16)括號里的數(shù)字是掛斷原因碼cause code16表示“正常掛斷Normal Clearing”這是最常用的值。如果你不傳參數(shù)Asterisk 會使用默認(rèn)原因碼最終體現(xiàn)在話單或?qū)Χ诵帕钐崾纠锟赡懿粔蚓_。為什么要手動指定原因碼因為在真實的對接場景里中繼對端比如運營商或?qū)Ψ?IP-PBX會依據(jù)原因碼判斷通話是“正常結(jié)束”“被叫忙”“被叫無應(yīng)答”還是“號碼不存在”。如果你把一通報了忙的音的呼叫掛斷原因碼寫成 16對端可能誤以為用戶已經(jīng)正常說完掛了反過來如果明明是正常咨詢轉(zhuǎn)接結(jié)束卻給了個 “17用戶忙”對方話單統(tǒng)計就會很混亂。所以業(yè)務(wù)側(cè)一旦出現(xiàn)狀態(tài)區(qū)分需求顯式掛斷原因碼就很有價值。另外Asterisk 還支持h擴(kuò)展hangup handler也就是“掛斷處理”上下文。當(dāng)通話掛斷時無論它是在 Dialplan 什么位置結(jié)束的Asterisk 都會執(zhí)行當(dāng)前上下文里h擴(kuò)展下的指令。常見用途是記錄通話時長、清除資源、寫日志。注意h擴(kuò)展的優(yōu)先級從 1 開始寫里面一般不放 Answer 或 Playback而是放記錄類應(yīng)用。這能讓你把“掛斷后的清理動作”統(tǒng)一收口代碼結(jié)構(gòu)會清爽很多。2.4 三個應(yīng)用常用的可選參數(shù)與返回值細(xì)節(jié)Answer()本身沒有參數(shù)但配合它的常用應(yīng)用是Wait()。Wait()的多寡靠手感測試環(huán)境 1 秒足夠真機(jī)環(huán)境考慮到鏈路建立時間2 到 3 秒更穩(wěn)但也不要過長否則用戶會覺得“接通了沒動靜”。Playback()帶一個可選的第二個參數(shù)options在實際生產(chǎn)里比較有用的是skip如果通道尚未應(yīng)答則跳過播放。適合某些優(yōu)先放音再應(yīng)答的廣告場景。noanswer播放時不改變通道的應(yīng)答狀態(tài)也就是“前置播放”模式。這兩個選項背后的思路是有時候你想在真正接通前先放一段“來電彩鈴”或者品牌語音這時noanswer和skip就能靈活控制。Hangup()的可選參數(shù)就是原因碼。常用原因碼我整理成一張速查表原因碼含義典型場景16正常掛斷通話自然結(jié)束17用戶忙被叫占線18用戶無應(yīng)答振鈴超時無人接21呼叫被拒絕對方主動拒接27目的地不可達(dá)中繼/號碼不可用31未指定錯誤通用異常把原因碼寫對能省下很多和對方技術(shù)對接時“你們掛斷碼是啥”的扯皮時間。3. 實操搭建從零寫一個能跑起來的 Dialplan3.1 環(huán)境準(zhǔn)備和文件基本盤先交代一下環(huán)境。我這邊用的是社區(qū)常見發(fā)行版里的 Asterisk版本號在 16 到 20 之間均可本文語法適用配置主文件統(tǒng)一在/etc/asterisk/目錄。Dialplan 文件就是extensions.conf如果發(fā)行版默認(rèn)把它拆分成多個*.conf通常在文件頭部有#include語句你只需要往對應(yīng)片段里加內(nèi)容。在動手前建議先確認(rèn) Asterisk 服務(wù)狀態(tài)。命令行執(zhí)行sudo systemctl status asterisk正常情況下能看到服務(wù)處于 active 狀態(tài)。如果你是從源碼編譯安裝的那更熟悉一些直接用asterisk -c前臺跑也行。為了調(diào)試方便我強(qiáng)烈建議在配置階段直接連上 CLI 控制臺sudo asterisk -rvv-r表示連接運行中的實例-vv提高詳細(xì)程度。這一步后面排查問題時幾乎天天用。3.2 第一個完整流程接聽-播放-掛斷先在extensions.conf里新增一個上下文我習(xí)慣起名叫[lab]表示測試實驗區(qū)避免動到生產(chǎn)上下文[lab] exten s,1,Answer() same n,Wait(1) same n,Playback(hello-world) same n,Playback(beep) same n,Hangup(16)這段腳本的意思非常直白進(jìn)來就接聽等 1 秒播一句“hello world”問候再播一聲“beep”提示音然后正常掛斷。這里用到的是s擴(kuò)展也就是無論呼叫方撥了什么號碼只要進(jìn)了[lab]上下文都執(zhí)行這段流程。適合做“來電總機(jī)測試”。如果你的場景是“用戶撥某個特定分機(jī)號才觸發(fā)”就把s換成具體號碼比如6001[cnlab] exten 6001,1,Answer() same n,Playback(hello-world) same n,Hangup(16)兩種寫法的區(qū)別只在匹配條件s是最強(qiáng)兜底6001則要求呼叫匹配到對應(yīng)分機(jī)號。用哪個取決于業(yè)務(wù)入口后續(xù)做 IVR 時兩種都會用到。寫完保存文件后必須重新加載 Dialplan才能生效CLI dialplan reload再驗證一下上下文是否加載成功CLI dialplan show cnlab看到輸出里列出6001和對應(yīng)優(yōu)先級說明配置已經(jīng)被 Asterisk 接受。這時候用軟電話呼入綁定的上下文配成cnlab撥打6001應(yīng)該就能聽到完整流程。3.3 語音文件準(zhǔn)備與格式選擇系統(tǒng)自帶語音在/var/lib/asterisk/sounds/下里面分en/、zh_CN/等語言目錄大部分發(fā)行版會裝默認(rèn)的英文提示音。你可以先列一下ls /var/lib/asterisk/sounds/en/ | head如果要用中文提示音有些發(fā)行版需要額外安裝語言包或者直接自己錄音轉(zhuǎn)格式。我個人常用的方案是用任意錄音工具錄一段 WAV16bit、PCM、采樣率 8kHz 或 16kHz 均可Asterisk 能自動轉(zhuǎn)碼放到/var/lib/asterisk/sounds/zh/目錄然后在 Dialplan 里寫exten s,n,Playback(zh/歡迎致電)注意文件名不要帶中文也可以ASCII 命名更穩(wěn)比如zh/welcome-msg。文件權(quán)限要為 asterisk 用戶可讀否則播放時會報 “Unable to open” 的日志。格式上Asterisk 會在多個編碼之間挑一個最合適的來播所以如果你的系統(tǒng)里有wav、gsm兩種版本它能按當(dāng)前通話編碼自動選擇。我的建議是至少保留一份wav16bit PCM和一份gsm前者音質(zhì)好、后者體積小覆蓋絕大多數(shù)通道。3.4 用 CLI 驗證和應(yīng)用信息查詢想確認(rèn)一個應(yīng)用具體有什么參數(shù)與其翻文檔不如直接在 CLI 里查CLI core show application answer CLI core show application playback CLI core show application hangup日常調(diào)試?yán)镞€有兩個命令很重要dialplan show 上下文名列出該上下文的所有分機(jī)和優(yōu)先級。core set verbose 3臨時把日志級別調(diào)高配合-vvv連接能看到 Dialplan 每一行執(zhí)行的詳細(xì)過程。舉一個排查現(xiàn)場的例子。有一次我寫了個流程明明已經(jīng)dialplan reload但呼入后就是靜音。連上 CLI 用-rvvv觀察發(fā)現(xiàn)日志里根本沒有走到Answer()而是卡在 “No application answr found” 這樣的報錯上?；乜次募虐l(fā)現(xiàn)拼寫少了個 e。這種問題靠肉眼看配置幾乎不可能發(fā)現(xiàn)直接在 CLI 里跑一遍立即原形畢露。所以我的習(xí)慣是改完配置先 reload再開 verbose再呼入測試三步一氣呵成。3.5 進(jìn)階一步用 Background 和 DTMF 拼出最小 IVR掌握了三件套后最自然的下一步就是做一個能讓用戶按鍵選擇的最小 IVR。這里把Playback()換成Background()[ivr] exten s,1,Answer() same n,Background(zh/press-1-for-sales) same n,WaitExten(3) exten 1,1,Playback(zh/sales-line) same n,Hangup(16) exten 2,1,Playback(zh/support-line) same n,Hangup(16) exten i,1,Playback(zh/invalid-option) same n,Goto(s,1) exten t,1,Playback(zh/please-try-again) same n,Goto(s,1)Background()在播放的同時監(jiān)聽按鍵用戶按 1 或 2 后Dialplan 跳到對應(yīng)分機(jī)1、2繼續(xù)執(zhí)行。WaitExten(3)的意思是等待按鍵最長 3 秒。i是用戶按了無效鍵的處理t是等待超時的處理。這已經(jīng)是生產(chǎn)級 IVR 的骨架了而它的底層邏輯依然建立在 Answer、Playback、Hangup 的生命周期上。4. 常見問題與排查技巧實錄4.1 不寫 Answer 直接播放為什么會出現(xiàn)“接聽沒聲音”這個問題我遇到不止一次。有些場景下比如從某些 SIP 中繼進(jìn)來的來電通道在進(jìn)入 Dialplan 前可能已經(jīng)處于“部分建立”狀態(tài)這時候直接Playback()偶爾也能出聲音但更多情況下你會看到軟電話顯示已接通喇叭里卻一片寂靜。原因在于媒體流的方向和編碼協(xié)商需要通道進(jìn)入應(yīng)答狀態(tài)后才算完全就緒。Answer()會觸發(fā)后續(xù)的信令和媒體協(xié)商讓雙方都進(jìn)入可以發(fā)送音頻的狀態(tài)跳過這一步Asterisk 可能在單工或半?yún)f(xié)商狀態(tài)下嘗試播放聲音就丟了。遇到這類問題第一件事不是換編碼、調(diào)參數(shù)而是回到基礎(chǔ)補(bǔ)上Answer()并在它后面加 1 秒左右Wait()讓鏈路穩(wěn)定。八成問題直接解決。4.2 語音文件“找不到”或格式不匹配典型的日志片段是Unable to open ... (No such file or directory)或者 “format not supported”。排查順序確認(rèn)文件在聲音目錄下路徑寫對。注意Playback(zh/welcome-msg)對應(yīng)的是/var/lib/asterisk/sounds/zh/welcome-msg.*。確認(rèn)文件有至少一種 Asterisk 支持的聲音格式比如wav、gsm、ulaw、alaw。如果只有 MP3那多半不行因為版權(quán)和專利原因Asterisk 默認(rèn)不帶 MP3 解碼強(qiáng)烈建議統(tǒng)一轉(zhuǎn)成 WAV 或 GSM。確認(rèn)權(quán)限sudo chown asterisk:asterisk /var/lib/asterisk/sounds/zh/welcome-msg.wav權(quán)限不對會導(dǎo)致“能列出文件但讀不了內(nèi)容”。改完格式或路徑不需要 reload Dialplan因為聲音文件是按需讀取的但建議清一下緩存記憶。4.3 優(yōu)先級順序和擴(kuò)展名沖突Dialplan 的優(yōu)先級如果亂寫容易出現(xiàn)“執(zhí)行不到預(yù)期位置”。老式寫法允許跳號比如exten 6001,1,Answer()后直接exten 6001,5,Playback(...)Asterisk 也能執(zhí)行但中間的 2 到 4 是空的語義混亂?，F(xiàn)代寫法推薦exten 6001,1,Answer() same n,Playback(hello-world) same n,Hangup()same n是“延續(xù)前一個擴(kuò)展名”的簡寫只要當(dāng)前還屬于6001這個擴(kuò)展就一路n下去。如果中間換了擴(kuò)展名就必須重新寫exten 新號碼,1,...。我見過有人把它和s混用導(dǎo)致匹配錯亂——比如在[ivr]里用s,1起頭然后某一行突然same n換到了別的擴(kuò)展上下文結(jié)果按鍵跳轉(zhuǎn)全部失效。記住一條同一個擴(kuò)展內(nèi)才能用same n連續(xù)跨擴(kuò)展必須另起爐灶。4.4 重點檢查清單日志、權(quán)限與上下文映射最后給一張我自己的“毛病速查表”照著走一遍能解決九成問題現(xiàn)象可能原因排查方法呼入后完全沒反應(yīng)通道綁定上下文錯誤檢查 SIP/PJSIP 通道配置里的context有反應(yīng)但沒聲音缺少 Answer加 Answer 和 Wait(1)報文件找不到路徑/語言目錄/權(quán)限ls 聲音目錄、chown 文件按鍵無效用了 Playback 而非 Background換 Background 監(jiān)聽 DTMF流程不按順序優(yōu)先級混用、same 跨擴(kuò)展回歸exten與same n寫法話單原因碼異常Hangup 未指定 cause使用Hangup(16)等顯式原因碼日志總?cè)肟谠?var/log/asterisk/full。調(diào)試時用tail -f /var/log/asterisk/full配合呼入能實時看到每一行 Dialplan 的執(zhí)行軌跡。Verbose 級別越低輸出越少建議臨時開到 4 甚至 5問題解決后再調(diào)回 3避免日志刷爆磁盤。最后聊一點我自己的體會。很多人學(xué) Asterisk 一上來就搜“怎么實現(xiàn)自動外呼”“怎么對接話務(wù)機(jī)器人”結(jié)果被一堆高級應(yīng)用繞暈。我走過的彎路是高級功能玩得飛起但一次簡單的“響一聲就播放”反而排查了半個多小時原因就是通道沒 Answer。后來我把 Answer、Playback、Hangup 當(dāng)成調(diào)試三件套任何新環(huán)境、新通道、新版本都先用這三件套跑通一條最小鏈路確認(rèn)上下行媒體都正常之后再疊加業(yè)務(wù)邏輯。這套做法幾乎讓我繞開了所有“環(huán)境不確定性”帶來的假故障。你也不妨試試拿到任何一套 Asterisk 環(huán)境先不要急著寫業(yè)務(wù)先讓三件套說話。它不響說明通道沒通它響了后面的路就好走了。 Asterisk撥號計劃入門：Answer、Playback、Hangup三件套實戰(zhàn)
Asterisk 的撥號計劃Dialplan是所有 VoIP 管理員遲早要啃的硬骨頭。我第一次接觸它的時候面對/etc/asterisk/extensions.conf里那一堆exten 的行腦子里全是問號這到底是在寫腳本還是在配電話交換機(jī)后來靜下心逐個應(yīng)用去試才發(fā)現(xiàn)真正的入門鑰匙根本不是Dial()那類復(fù)雜應(yīng)用而是最不起眼的三個基礎(chǔ)應(yīng)用Answer()、Playback()、Hangup()。毫不夸張地說把這三個應(yīng)用吃透Dialplan 的骨架就立起來了后面再學(xué)路由、排隊、IVR 只是往骨架上添肌肉。這篇文章就圍繞這三個應(yīng)用展開講清楚它們各自干什么、為什么需要它們、組合起來能搭建什么再給出一套可以直接照著抄的完整配置和調(diào)試方法。適合剛接觸 Asterisk 的運維新人、準(zhǔn)備做電話機(jī)器人的開發(fā)者以及想系統(tǒng)梳理流程細(xì)節(jié)的入門者。我把原理、語法、踩坑經(jīng)歷全部揉在一起你跟著走一遍至少能獨立寫出第一個能跑通的自動應(yīng)答流程。1. 先把地圖攤開Dialplan 到底在解決什么問題1.1 從一次電話通話看 Asterisk 的角色想象一次最普通的呼叫用戶拿起話筒撥了個號碼。這通電話到了 Asterisk 之后會發(fā)生什么Asterisk 本身不會平白無故知道“該放語音”“該轉(zhuǎn)給誰”“該掛斷”它只有一套機(jī)制把通話交給 Dialplan 去執(zhí)行。Dialplan 就是 Asterisk 的劇本每一通進(jìn)來的呼叫都要按劇本往下走。這個劇本寫在extensions.conf里由一個個“上下文context”組成。每個上下文相當(dāng)于一個權(quán)限邊界或一個功能場景比如[internal]管內(nèi)部電話、[incoming]管外線來電。上下文里面躺著若干“分機(jī)extension”但這里的 extension 不只是電話號碼它也可以是失配時的兜底標(biāo)簽s、超時標(biāo)簽t、無效按鍵標(biāo)簽i。每個 extension 后面跟一串優(yōu)先級priority優(yōu)先級從 1 開始用n表示“下一條”。Asterisk 按照“上下文 → 分機(jī) → 優(yōu)先級”的順序逐條執(zhí)行像是讀一張寫滿指令的卡片。為什么理解這個模型很重要因為后續(xù)所有業(yè)務(wù)邏輯IVR、隊列、語音信箱、外呼計劃本質(zhì)上都是在往這張卡片上添加指令行。如果你連最基本的執(zhí)行順序都搞不清后面一旦出現(xiàn)“明明寫了播放卻聽不到聲音”“電話一接就斷”這類問題排查起來會特別痛苦。先把這個運行模型刻進(jìn)腦子里再看具體應(yīng)用就順多了。1.2 為什么這仨應(yīng)用是“最小開場組合”先問一個問題一通電進(jìn)來Asterisk 最少要做哪幾件事才算“有意義地處理”了答案是三件接通Answer→ 干點事Playback→ 收尾Hangup。接通用Answer()干的事先用最樸素的“放一段語音”也就是Playback()最后用Hangup()把通話資源釋放掉。這三步拼起來就是所有電話流程的最小閉環(huán)。有朋友可能會說“我不用 Answer 直接 Playback 也能放聲音啊。” 這種情況確實存在但結(jié)果不可控在某些通道上未接通時播放會導(dǎo)致音頻路徑?jīng)]有完全建立撥號方聽到的是半截話或者壓根沒聲音更重要的是沒有 Answer 時通道狀態(tài)沒有正確切換計費、話單、后續(xù)轉(zhuǎn)接都會出問題。所以規(guī)范做法永遠(yuǎn)是先 Answer再操作最后 Hangup。這也是為什么官方示例幾乎都是這個套路。再看Hangup()。很多人會覺得“掛斷還需要專門寫一個應(yīng)用” 其實需要尤其是你要控制掛斷原因碼、要在掛斷前執(zhí)行清理操作的時候。就算不寫它Dialplan 走到結(jié)尾 Asterisk 也會自動掛斷但顯式調(diào)用能讓你掌握主動權(quán)話單上的原因碼也更干凈。這個三件套組合本質(zhì)上是讓你用最少的語法建立對通道生命周期——建立、使用、釋放——的完整感知。1.3 配置文件的三個組成部分general、globals 與上下文打開extensions.conf通常會看到三個區(qū)域[general]全局設(shè)置區(qū)比如staticyes表示只允許通過文件修改撥號計劃禁止在 CLI 里動態(tài)改。[globals]全局變量定義區(qū)可以定義類似EXT1000的變量后面用${EXT}引用。各業(yè)務(wù)上下文[incoming]、[default]、[internal]這類方括號片段真正放執(zhí)行指令的地方。新手最容易犯的一個錯是把[general]和[globals]當(dāng)成普通上下文往里寫路由結(jié)果發(fā)現(xiàn)怎么都不執(zhí)行。正確理解是前兩個是“元信息”只有業(yè)務(wù)上下文才是通道真正會進(jìn)入的劇本。一個通道最終會進(jìn)入哪個上下文通常由上游通道配置決定。比如 SIP 分機(jī)或中繼配置里會指定contextincomingPBX 收到來電后就把呼叫交給[incoming]處理。如果這個映射沒配好Dialplan 寫得再漂亮也不會被觸發(fā)。這也是很多人“配置了卻沒反應(yīng)”的第一大原因——腳本沒問題但通道根本就沒走進(jìn)來。2. 三個基礎(chǔ)應(yīng)用逐個拆開看2.1 Answer()接通動作背后的信號順序Answer()的語法極簡就是exten s,1,Answer()沒有參數(shù)。它做的事情是把當(dāng)前通道從未應(yīng)答狀態(tài)切換到已應(yīng)答狀態(tài)。對于 SIP 通道而言這一步等價于向?qū)Χ嘶厮?00 OK響應(yīng)同時建立雙向媒體流對于模擬 FXS/FXO 通道則是真正摘機(jī)。這里有個關(guān)鍵點Answer 不是瞬間完成的也不會阻塞很長時間。執(zhí)行完后Dialplan 立刻執(zhí)行下一行。如果需要給對方一點反應(yīng)時間常規(guī)做法是接一行Wait(1)或Wait(2)這在播放提示音之前尤其常用。Answer()還有返回值的概念成功返回 0失敗返回 -1。雖然多數(shù)場景下你不需要關(guān)心返回值但在調(diào)試時通過core show application answer看幫助文檔能確認(rèn)細(xì)節(jié)。實際操作里要注意如果通道已經(jīng)處于應(yīng)答狀態(tài)再次調(diào)用Answer()不會報錯只會安靜地立即返回。所以別擔(dān)心多寫一行 Answer 會把通話搞壞它是個冪等性很好的操作。另一個實際經(jīng)驗?zāi)承┩夂魣鼍跋翨 端電話振鈴后由 Asterisk 發(fā)起呼叫并等待被叫應(yīng)答這時候“接通”發(fā)生在被叫通道上而不是主叫通道。如果你在 Dialplan 里對主叫先執(zhí)行 Answer行為會和來電場景略有差異。這也是為什么建議先跑通一個最簡單的來電場景再考慮外呼。2.2 Playback()播音員的工作方式Playback()的核心作用就是播放一個或多個語音文件語法是exten s,n,Playback(/路徑/文件名)需要注意Playback()執(zhí)行期間不做任何按鍵收集。也就是說如果對方在播放中途按了數(shù)字鍵這些 DTMF 信號要么被忽略要么被暫存到通道里但 Dialplan 不會因此跳轉(zhuǎn)。這和后面要講的Background()有本質(zhì)區(qū)別Background()是邊放音邊監(jiān)聽按鍵Playback()是只顧著放完為止。它還支持一次播多個文件用連接Playback(hello-worldbeep)Asterisk 會順序播放。返回值同樣是 0 或 -1放完正常返回 0在播放過程中通道掛斷則返回 -1。這個返回值在做“掛斷檢測”時有用比如播放中途用戶掛斷你想立刻停止后續(xù)流程。文件路徑上有個容易踩的坑不要隨便加擴(kuò)展名也不要寫錯路徑基準(zhǔn)。Asterisk 會基于系統(tǒng)聲音目錄/var/lib/asterisk/sounds去查找文件。比如寫Playback(hello-world)它會嘗試在聲音目錄下找hello-world.gsm、hello-world.wav、hello-world.ulaw等格式中的一種并選一個與當(dāng)前通道編碼匹配的進(jìn)行播放。如果你自己放了一個/opt/mysounds/promo.wav路徑要寫完整且權(quán)限必須讓 Asterisk 運行用戶能讀。個人經(jīng)驗是先用系統(tǒng)自帶的hello-world、beep這類文件跑通鏈路再換自定義音頻這樣能把“配置問題”和“素材問題”分開排查。2.3 Hangup()如何優(yōu)雅地結(jié)束通話Hangup()語法為exten s,n,Hangup(16)括號里的數(shù)字是掛斷原因碼cause code16表示“正常掛斷Normal Clearing”這是最常用的值。如果你不傳參數(shù)Asterisk 會使用默認(rèn)原因碼最終體現(xiàn)在話單或?qū)Χ诵帕钐崾纠锟赡懿粔蚓_。為什么要手動指定原因碼因為在真實的對接場景里中繼對端比如運營商或?qū)Ψ?IP-PBX會依據(jù)原因碼判斷通話是“正常結(jié)束”“被叫忙”“被叫無應(yīng)答”還是“號碼不存在”。如果你把一通報了忙的音的呼叫掛斷原因碼寫成 16對端可能誤以為用戶已經(jīng)正常說完掛了反過來如果明明是正常咨詢轉(zhuǎn)接結(jié)束卻給了個 “17用戶忙”對方話單統(tǒng)計就會很混亂。所以業(yè)務(wù)側(cè)一旦出現(xiàn)狀態(tài)區(qū)分需求顯式掛斷原因碼就很有價值。另外Asterisk 還支持h擴(kuò)展hangup handler也就是“掛斷處理”上下文。當(dāng)通話掛斷時無論它是在 Dialplan 什么位置結(jié)束的Asterisk 都會執(zhí)行當(dāng)前上下文里h擴(kuò)展下的指令。常見用途是記錄通話時長、清除資源、寫日志。注意h擴(kuò)展的優(yōu)先級從 1 開始寫里面一般不放 Answer 或 Playback而是放記錄類應(yīng)用。這能讓你把“掛斷后的清理動作”統(tǒng)一收口代碼結(jié)構(gòu)會清爽很多。2.4 三個應(yīng)用常用的可選參數(shù)與返回值細(xì)節(jié)Answer()本身沒有參數(shù)但配合它的常用應(yīng)用是Wait()。Wait()的多寡靠手感測試環(huán)境 1 秒足夠真機(jī)環(huán)境考慮到鏈路建立時間2 到 3 秒更穩(wěn)但也不要過長否則用戶會覺得“接通了沒動靜”。Playback()帶一個可選的第二個參數(shù)options在實際生產(chǎn)里比較有用的是skip如果通道尚未應(yīng)答則跳過播放。適合某些優(yōu)先放音再應(yīng)答的廣告場景。noanswer播放時不改變通道的應(yīng)答狀態(tài)也就是“前置播放”模式。這兩個選項背后的思路是有時候你想在真正接通前先放一段“來電彩鈴”或者品牌語音這時noanswer和skip就能靈活控制。Hangup()的可選參數(shù)就是原因碼。常用原因碼我整理成一張速查表原因碼含義典型場景16正常掛斷通話自然結(jié)束17用戶忙被叫占線18用戶無應(yīng)答振鈴超時無人接21呼叫被拒絕對方主動拒接27目的地不可達(dá)中繼/號碼不可用31未指定錯誤通用異常把原因碼寫對能省下很多和對方技術(shù)對接時“你們掛斷碼是啥”的扯皮時間。3. 實操搭建從零寫一個能跑起來的 Dialplan3.1 環(huán)境準(zhǔn)備和文件基本盤先交代一下環(huán)境。我這邊用的是社區(qū)常見發(fā)行版里的 Asterisk版本號在 16 到 20 之間均可本文語法適用配置主文件統(tǒng)一在/etc/asterisk/目錄。Dialplan 文件就是extensions.conf如果發(fā)行版默認(rèn)把它拆分成多個*.conf通常在文件頭部有#include語句你只需要往對應(yīng)片段里加內(nèi)容。在動手前建議先確認(rèn) Asterisk 服務(wù)狀態(tài)。命令行執(zhí)行sudo systemctl status asterisk正常情況下能看到服務(wù)處于 active 狀態(tài)。如果你是從源碼編譯安裝的那更熟悉一些直接用asterisk -c前臺跑也行。為了調(diào)試方便我強(qiáng)烈建議在配置階段直接連上 CLI 控制臺sudo asterisk -rvv-r表示連接運行中的實例-vv提高詳細(xì)程度。這一步后面排查問題時幾乎天天用。3.2 第一個完整流程接聽-播放-掛斷先在extensions.conf里新增一個上下文我習(xí)慣起名叫[lab]表示測試實驗區(qū)避免動到生產(chǎn)上下文[lab] exten s,1,Answer() same n,Wait(1) same n,Playback(hello-world) same n,Playback(beep) same n,Hangup(16)這段腳本的意思非常直白進(jìn)來就接聽等 1 秒播一句“hello world”問候再播一聲“beep”提示音然后正常掛斷。這里用到的是s擴(kuò)展也就是無論呼叫方撥了什么號碼只要進(jìn)了[lab]上下文都執(zhí)行這段流程。適合做“來電總機(jī)測試”。如果你的場景是“用戶撥某個特定分機(jī)號才觸發(fā)”就把s換成具體號碼比如6001[cnlab] exten 6001,1,Answer() same n,Playback(hello-world) same n,Hangup(16)兩種寫法的區(qū)別只在匹配條件s是最強(qiáng)兜底6001則要求呼叫匹配到對應(yīng)分機(jī)號。用哪個取決于業(yè)務(wù)入口后續(xù)做 IVR 時兩種都會用到。寫完保存文件后必須重新加載 Dialplan才能生效CLI dialplan reload再驗證一下上下文是否加載成功CLI dialplan show cnlab看到輸出里列出6001和對應(yīng)優(yōu)先級說明配置已經(jīng)被 Asterisk 接受。這時候用軟電話呼入綁定的上下文配成cnlab撥打6001應(yīng)該就能聽到完整流程。3.3 語音文件準(zhǔn)備與格式選擇系統(tǒng)自帶語音在/var/lib/asterisk/sounds/下里面分en/、zh_CN/等語言目錄大部分發(fā)行版會裝默認(rèn)的英文提示音。你可以先列一下ls /var/lib/asterisk/sounds/en/ | head如果要用中文提示音有些發(fā)行版需要額外安裝語言包或者直接自己錄音轉(zhuǎn)格式。我個人常用的方案是用任意錄音工具錄一段 WAV16bit、PCM、采樣率 8kHz 或 16kHz 均可Asterisk 能自動轉(zhuǎn)碼放到/var/lib/asterisk/sounds/zh/目錄然后在 Dialplan 里寫exten s,n,Playback(zh/歡迎致電)注意文件名不要帶中文也可以ASCII 命名更穩(wěn)比如zh/welcome-msg。文件權(quán)限要為 asterisk 用戶可讀否則播放時會報 “Unable to open” 的日志。格式上Asterisk 會在多個編碼之間挑一個最合適的來播所以如果你的系統(tǒng)里有wav、gsm兩種版本它能按當(dāng)前通話編碼自動選擇。我的建議是至少保留一份wav16bit PCM和一份gsm前者音質(zhì)好、后者體積小覆蓋絕大多數(shù)通道。3.4 用 CLI 驗證和應(yīng)用信息查詢想確認(rèn)一個應(yīng)用具體有什么參數(shù)與其翻文檔不如直接在 CLI 里查CLI core show application answer CLI core show application playback CLI core show application hangup日常調(diào)試?yán)镞€有兩個命令很重要dialplan show 上下文名列出該上下文的所有分機(jī)和優(yōu)先級。core set verbose 3臨時把日志級別調(diào)高配合-vvv連接能看到 Dialplan 每一行執(zhí)行的詳細(xì)過程。舉一個排查現(xiàn)場的例子。有一次我寫了個流程明明已經(jīng)dialplan reload但呼入后就是靜音。連上 CLI 用-rvvv觀察發(fā)現(xiàn)日志里根本沒有走到Answer()而是卡在 “No application answr found” 這樣的報錯上?；乜次募虐l(fā)現(xiàn)拼寫少了個 e。這種問題靠肉眼看配置幾乎不可能發(fā)現(xiàn)直接在 CLI 里跑一遍立即原形畢露。所以我的習(xí)慣是改完配置先 reload再開 verbose再呼入測試三步一氣呵成。3.5 進(jìn)階一步用 Background 和 DTMF 拼出最小 IVR掌握了三件套后最自然的下一步就是做一個能讓用戶按鍵選擇的最小 IVR。這里把Playback()換成Background()[ivr] exten s,1,Answer() same n,Background(zh/press-1-for-sales) same n,WaitExten(3) exten 1,1,Playback(zh/sales-line) same n,Hangup(16) exten 2,1,Playback(zh/support-line) same n,Hangup(16) exten i,1,Playback(zh/invalid-option) same n,Goto(s,1) exten t,1,Playback(zh/please-try-again) same n,Goto(s,1)Background()在播放的同時監(jiān)聽按鍵用戶按 1 或 2 后Dialplan 跳到對應(yīng)分機(jī)1、2繼續(xù)執(zhí)行。WaitExten(3)的意思是等待按鍵最長 3 秒。i是用戶按了無效鍵的處理t是等待超時的處理。這已經(jīng)是生產(chǎn)級 IVR 的骨架了而它的底層邏輯依然建立在 Answer、Playback、Hangup 的生命周期上。4. 常見問題與排查技巧實錄4.1 不寫 Answer 直接播放為什么會出現(xiàn)“接聽沒聲音”這個問題我遇到不止一次。有些場景下比如從某些 SIP 中繼進(jìn)來的來電通道在進(jìn)入 Dialplan 前可能已經(jīng)處于“部分建立”狀態(tài)這時候直接Playback()偶爾也能出聲音但更多情況下你會看到軟電話顯示已接通喇叭里卻一片寂靜。原因在于媒體流的方向和編碼協(xié)商需要通道進(jìn)入應(yīng)答狀態(tài)后才算完全就緒。Answer()會觸發(fā)后續(xù)的信令和媒體協(xié)商讓雙方都進(jìn)入可以發(fā)送音頻的狀態(tài)跳過這一步Asterisk 可能在單工或半?yún)f(xié)商狀態(tài)下嘗試播放聲音就丟了。遇到這類問題第一件事不是換編碼、調(diào)參數(shù)而是回到基礎(chǔ)補(bǔ)上Answer()并在它后面加 1 秒左右Wait()讓鏈路穩(wěn)定。八成問題直接解決。4.2 語音文件“找不到”或格式不匹配典型的日志片段是Unable to open ... (No such file or directory)或者 “format not supported”。排查順序確認(rèn)文件在聲音目錄下路徑寫對。注意Playback(zh/welcome-msg)對應(yīng)的是/var/lib/asterisk/sounds/zh/welcome-msg.*。確認(rèn)文件有至少一種 Asterisk 支持的聲音格式比如wav、gsm、ulaw、alaw。如果只有 MP3那多半不行因為版權(quán)和專利原因Asterisk 默認(rèn)不帶 MP3 解碼強(qiáng)烈建議統(tǒng)一轉(zhuǎn)成 WAV 或 GSM。確認(rèn)權(quán)限sudo chown asterisk:asterisk /var/lib/asterisk/sounds/zh/welcome-msg.wav權(quán)限不對會導(dǎo)致“能列出文件但讀不了內(nèi)容”。改完格式或路徑不需要 reload Dialplan因為聲音文件是按需讀取的但建議清一下緩存記憶。4.3 優(yōu)先級順序和擴(kuò)展名沖突Dialplan 的優(yōu)先級如果亂寫容易出現(xiàn)“執(zhí)行不到預(yù)期位置”。老式寫法允許跳號比如exten 6001,1,Answer()后直接exten 6001,5,Playback(...)Asterisk 也能執(zhí)行但中間的 2 到 4 是空的語義混亂?，F(xiàn)代寫法推薦exten 6001,1,Answer() same n,Playback(hello-world) same n,Hangup()same n是“延續(xù)前一個擴(kuò)展名”的簡寫只要當(dāng)前還屬于6001這個擴(kuò)展就一路n下去。如果中間換了擴(kuò)展名就必須重新寫exten 新號碼,1,...。我見過有人把它和s混用導(dǎo)致匹配錯亂——比如在[ivr]里用s,1起頭然后某一行突然same n換到了別的擴(kuò)展上下文結(jié)果按鍵跳轉(zhuǎn)全部失效。記住一條同一個擴(kuò)展內(nèi)才能用same n連續(xù)跨擴(kuò)展必須另起爐灶。4.4 重點檢查清單日志、權(quán)限與上下文映射最后給一張我自己的“毛病速查表”照著走一遍能解決九成問題現(xiàn)象可能原因排查方法呼入后完全沒反應(yīng)通道綁定上下文錯誤檢查 SIP/PJSIP 通道配置里的context有反應(yīng)但沒聲音缺少 Answer加 Answer 和 Wait(1)報文件找不到路徑/語言目錄/權(quán)限ls 聲音目錄、chown 文件按鍵無效用了 Playback 而非 Background換 Background 監(jiān)聽 DTMF流程不按順序優(yōu)先級混用、same 跨擴(kuò)展回歸exten與same n寫法話單原因碼異常Hangup 未指定 cause使用Hangup(16)等顯式原因碼日志總?cè)肟谠?var/log/asterisk/full。調(diào)試時用tail -f /var/log/asterisk/full配合呼入能實時看到每一行 Dialplan 的執(zhí)行軌跡。Verbose 級別越低輸出越少建議臨時開到 4 甚至 5問題解決后再調(diào)回 3避免日志刷爆磁盤。最后聊一點我自己的體會。很多人學(xué) Asterisk 一上來就搜“怎么實現(xiàn)自動外呼”“怎么對接話務(wù)機(jī)器人”結(jié)果被一堆高級應(yīng)用繞暈。我走過的彎路是高級功能玩得飛起但一次簡單的“響一聲就播放”反而排查了半個多小時原因就是通道沒 Answer。后來我把 Answer、Playback、Hangup 當(dāng)成調(diào)試三件套任何新環(huán)境、新通道、新版本都先用這三件套跑通一條最小鏈路確認(rèn)上下行媒體都正常之后再疊加業(yè)務(wù)邏輯。這套做法幾乎讓我繞開了所有“環(huán)境不確定性”帶來的假故障。你也不妨試試拿到任何一套 Asterisk 環(huán)境先不要急著寫業(yè)務(wù)先讓三件套說話。它不響說明通道沒通它響了后面的路就好走了。