前言

A2Billing 是目前社群開發(fā)最熱門的計費系統(tǒng)套件，因為是開放原始碼授權(quán)所以可以合法免費使用。

本篇主要在是教導(dǎo)如何使用這套件，若還沒完成安裝的朋友，請先前往閱讀 A2Billing 安裝篇。

初始化設(shè)定

系統(tǒng)在完成安裝後，第一個所要做的設(shè)定有：

// FreePBX UI > Trunks

新增 Outbound Trunk，本篇以 Voxalot 為例。

Outgoing Settings
Trunk Name = voxalot

host=us.voxalot.com
username=<sip_number>
fromuser=<sip_number>
secret=<sip_pass>
fromdomain=voxalot.com
nat=yes
insecure=port,invite
qualify=yes
canreinvite=yes
dtmfmode=auto
disallow=all
allow=ulaw&alaw
type=peer
context=from-trunk

新增 Inbound Trunk，這個主要在展示國際電話卡及 DID 轉(zhuǎn)接的應(yīng)用，本篇以 iptel 為例。

Outgoing Settings
Trunk Name: iptel

username=<sip_username>
type=friend
secret=<sip_pass>
qualify=yes
insecure=port,invite
host=iptel.org
fromuser=osslab
fromdomain=iptel.org
context=a2billing

Register String: <sip_username>:<sip_pass>@iptel.org/<sip_number>

注意：context 必須是 a2billing

// A2Billing Admin UI > Trunk > Create Provider

provider name = VOXALOT_PROVIDER
description = Voxalot Provider

// A2Billing Admin UI > Trunk > Add Trunk

voip-provider = VOXALOT_PROVIDER
label = VOXALOT_TRUNK
add prefix = 空白
provider tech = SIP
provider ip = voxalot
status = Active

TIPs:

provider ip 必須與 FreePBX 的 trunk name 相同

// A2Billing Admin UI > Ratecard > Create call plan

name = VOXALOT_CALLPLAN
remove inter prefix = YES

TIPs:

remove inter prefix = YES 若撥號有包含 00 或 011 開頭的國際冠碼，在套用 ratecard 的規(guī)則前會被去除。

// A2Billing Admin UI > Ratecard > Create new ratecard

tariffname = VOXALOT_RATECARD
trunk = VOXALOT_TRUNK
description = through voxalot trunk

// A2Billing Admin UI > Ratecard > Add Rate

ratecard = VOXALOT_RATECARD
dialprefix = 1800
destination = US-Tollfree
buying rate = 1
buyrate min duration = 6
buyrate billing block = 6
selling rate = 1.5
sellrate min duration = 60
sellrate billing block = 60
trunk = VOXALOT_TRUNK

TIPs:

＊ dialprefix 若撥號規(guī)則符合，會以此費率計算
＊ destination 用來敘述此費率的區(qū)域

//新增 rate 後要再回到 call plan 將 rate card 加入到 call plan
A2Billing Admin UI > Ratecard > List Call Plan > Edit: VOXALOT_CALLPLAN

ratecard = 選擇 VOXALOT_RATECARD, Add Ratecard

應(yīng)用一：國際電話卡模式

客戶操作流程：
① 使用手機(jī)或一般電話機(jī)撥打系統(tǒng)號碼(Access Number)

② 語音提示：輸入電話卡號＋＃

③ 語音提示餘額，輸入目的地電話號碼（00＋國碼＋區(qū)碼＋電話號碼＋＃）

// A2Billing Admin UI > Customers > Create Customers

card number = <隨機(jī)產(chǎn)生>
card alias = <隨機(jī)產(chǎn)生>；web 登入帳號
webui password = <隨機(jī)產(chǎn)生>；web 登入密碼
balance = 50.0；不可為零，且必須以 USD 計算
call plan = VOXALOT_CALLPLAN
activated = YES
simultaneous access = INDIVIDUAL ACCESS
card type = PREPAID CARD
country = TAIWAN
sip account = NO
iax account = NO

實際操作：

因為本篇實做是以 iptel 的號碼作為系統(tǒng)號碼，所以用其他 IPTel 帳號撥入系統(tǒng)號碼，系統(tǒng)會提示語音：請輸入 card number，將剛剛新增的卡號輸入，完成後按＃，若正確，系統(tǒng)會提示餘額及可用通話時間，並提示：請輸入目的地電話號碼，將完整電話號碼 011 + 國碼 + 區(qū)碼 + 電話號碼 輸入，完成後按＃。

TIPs:

＊ 新增電話卡(Customer)，有一些主要的設(shè)定，例如 card number, card alias, password，這些是由系統(tǒng)隨機(jī)產(chǎn)生，且沒有任何規(guī)則，hacker 無法事先計算出這些資訊。
＊ 附加在 card number 的 另一組代號 alias，這個號碼或 email 地址都可以用來登入用戶的網(wǎng)頁，密碼就是 webui password。
＊ 若用戶撥號時有加 00，請注意 Call Plan 的 REMOVE INTER PREFIX 建議設(shè)為 YES，以避免 outbound 路由錯誤。

應(yīng)用二：DID 轉(zhuǎn)接業(yè)務(wù)

A2Billing 提供 DID 接駁至經(jīng)由 outbound trunk 的外部號碼、SIP URI、

// A2Billing Admin UI > DID > Add DID Group

name = DID TWN

// A2Billing Admin UI > DID > Add DID

DID = 99474
billing = only dialout rate
DID group = DID TWN
country = TAIWAN
activated = YES
monthly rate = 0

// A2Billing Admin UI > Customers > Create Customers

balance = 50.0
call plan = VOXALOT_CALLPLAN
didgroup = DID TWN
activated = YES
card type = PREPAID CARD
country = TAIWAN
sip account = NO
iax account = NO

設(shè)定轉(zhuǎn)接的目的號碼，可以透過 Admin UI 或 Customer UI 來作
客戶自行購買 DID 號碼
// A2Billing Customer UI > DID

select country = TAIWAN
select virtual phone number = 99474
voip call = NO
destination = 8864123456

TIPs:

＊ select country 這裡內(nèi)容會與 DID 的 country 相同
＊ 若沒有出現(xiàn) DID number 可選擇，請檢查所登入的 customer 帳號的 DIDGROUP 是否正確
＊ voip call 若是 NO，輸入外部的 PSTN/SIP 號碼；若是 YES，輸入 SIP URI。

管理員分配 DID 號碼給指定的客戶
// A2Billing Admin UI > INBOUND DID > Destination

destination = 8864123456
customer ID = 選擇適當(dāng)?shù)?customer
DID = 選擇適當(dāng)?shù)?DID
activated = yes
validated = 皆可
voip_call = no

TIPs:

＊ voip call 若是 NO，輸入外部的 PSTN/SIP 號碼；若是 YES，輸入 SIP URI。

＊ 若需 DID 接入內(nèi)部分機(jī)號碼(不經(jīng)過 A2B 的 trunk)，可以這樣設(shè)
-- destination = Local/101@from-internal (適用 FreePBX 的分機(jī) 101)
-- destination = SIP/123456 (適用 A2Billing card number 123456)
-- voip_call = yes

* 如果 destination number 要走 A2B 的 trunk，不管該 trunk 是 SIP 或 Zaptel，voip_call 必須是 no。

相關(guān)文章連結(jié)：

• Elastix Forum :: Inbound DID Billing for A2Billing

應(yīng)用三：預(yù)付制、月付制會員模式

用戶操作流程：
① 用戶使用 X-Lite 或 ATA 設(shè)備透過網(wǎng)路註冊為分機(jī)。

② 直接撥目的地電話號碼，例如 886+XXXXXXXX，886 是國碼。
過程中不會有任何額外的提示音，就像一般的 SIP 分機(jī)操作相同。

// A2Billing Admin UI > Customers > Create Customers

card number = <隨機(jī)產(chǎn)生>
card alias = <隨機(jī)產(chǎn)生>；web 登入帳號
webui password = <隨機(jī)產(chǎn)生>；web 登入密碼
balance = 50.0；不可為零，且必須以 USD 計算
call plan = VOXALOT_CALLPLAN
activated = YES
simultaneous access = INDIVIDUAL ACCESS
card type = PREPAID CARD
country = TAIWAN
sip account = YES
iax account = YES

TIPs:

＊ 這裡與(應(yīng)用一)模式設(shè)定相同，只差在 sip/iax account 為 YES。
＊ 新增 customer 後，要 reload Asterisk 後，SIP 用戶端才能註冊使用。

// 取消 "輸入目的地號碼" 及其他提示音
// A2Billing Admin UI > System Settings > Global List
如果這裡的所有項目沒有 GROUP 為 agi-conf2 的(可善用 GROUP 搜尋功能)，請先前往 Add agi-conf > CREATE AGI-CONF2。

回到 Global List 找到 GROUP 為 agi-conf2 且 KEY/VALUE 按以下所述修改：

use_dnid = yes

這個SIP帳號除了要撥外部的路由外，如果還要撥內(nèi)部的其他 SIP 分機(jī)號，需要繼續(xù)下面的修改：

sip_iax_friends = yes
sip_iax_pstn_direct_call_prefix = 555
sip_iax_pstn_direct_call = yes

※是否要提示餘額的語音

say_balance_after_auth = no
say_timetocall = no

如果電話不通，不要提示輸入目的地號碼的語音

number_try = 1

TIPs:

＊ 參數(shù)說明：

- Use DNID : YES 表示使用 DNID，並且不會提示 輸入目的地電話號碼的語音
- SIP Call = yes, SIP Call Prefix, Direct Call: 這三個參數(shù)是用來使 SIP 註冊帳號後，也能撥其他分機(jī)號碼，撥法為 555+SIP Extension
- Say Balance After Auth: 認(rèn)證後是否提示餘額
- Say Duration: 是否提示剩餘通話時間

- 另一種比較快速的設(shè)定是：play_audio = no, use_dnid=yes, number_try=1。

//為此模式新增 dialplan
//編輯 /etc/asterisk/extensions_a2billing.conf，在底下加入：

[custom-a2billing-sipclient]
exten => _X.,1,Answer
exten => _X.,n,Wait(1)
exten => _X.,n,deadAGI(a2billing.php|2)
exten => _X.,n,Hangup

// 在 A2Billing 套用新增的 dialplan
// A2Billing Admin UI > Customer > VoIP Settings
找到 SIP 分機(jī)項目，按編輯

Context = custom-a2billing-sipclient

// 最後，執(zhí)行指令套用所有的修改

# asterisk -rx "reload"

TIPs:

由於版本 1.7.x 的 bug 關(guān)係，在 UI 做完操作後，並不會同步修改 asterisk 的設(shè)定檔，所以請依照方式作手動修改：
編輯 /etc/asterisk/additional_a2billing_sip.conf ，修改 context 的內(nèi)容。
要避免每次都要作手動修改，可以參考 F.A.Q 的方法。

應(yīng)用四：整合 FreePBX 的應(yīng)用

用途：FreePBX 的分機(jī)用戶，在 Outbound Calling 時可以透過 A2Billing 來計費，但其他原有PBX的功能都不會有影響。

// 編輯 /etc/asterisk/extensions_custom.conf

[macro-dialout-trunk-predial-hook]
exten => s,1,GotoIf($["${OUT_${DIAL_TRUNK}:4:4}" = "A2B/"]?custom-freepbx-a2billing,${OUTNUM},1:2)
exten => s,2,MacroExit

[custom-freepbx-a2billing]
exten => _X.,1,DeadAGI(a2billing.php,${OUT_${DIAL_TRUNK}:8})
exten => _X.,n,Hangup()

// FreePBX UI > Trunks > Add Custom Trunk

Custom Dial String = A2B/2

Tips:

2 代表是 agi-conf 2

// FreePBX UI > Outbound Routes
自行設(shè)定需要的參數(shù)，並導(dǎo)向剛剛的 Trunk。

// FreePBX UI > Extensions
在需要計費的分機(jī)設(shè)定裡，參數(shù) accountcode 填入 A2Billing 的 Card Number。

Tips:

分機(jī)在外撥的路由規(guī)則，除了 outbound route 外，還要考慮 A2Billing 的，也就是 RATES 的相關(guān)設(shè)定。

延伸閱讀

• Using A2Billing to account for extension calls in Elastix (A2Billing 1.3.x)

應(yīng)用五：Caller ID 認(rèn)證模式

用途：設(shè)定電話卡時除了使用輸入卡號的認(rèn)證方式以外，還能以來電號碼(Caller ID) 辨識來認(rèn)證。

• 啟用 Caller ID 後，用戶不需要先輸入卡號，就可以直接撥目的地號碼。
• 一個卡號可以設(shè)定一組或多組的來電號碼。
• 使用 Admin UI 來管理來電號碼。
• 一旦啟用後，當(dāng)用戶的來電號碼並非系統(tǒng)所允許時，系統(tǒng)會提示卡號的認(rèn)證的方式。

// 啟用方式
A2Billing Admin UI > Syetem Settings >

以 agi-conf 的方式來設(shè)，可以很容易啟用/關(guān)閉這功能，需要用到的參數(shù)(Key)如下：

• cid_enable = yes ；yes 啟用，no 關(guān)閉，預(yù)設(shè)是關(guān)閉的
• cid_askpincode_ifnot_callerid = yes ; 預(yù)設(shè) yes，若 CID 認(rèn)證失敗，系統(tǒng)會提示輸入 Card Number。
• cid_auto_assign_card_to_cid = yes ; 預(yù)設(shè) yes，用戶撥入系統(tǒng)後，如果 CID 認(rèn)證失敗，系統(tǒng)會提示輸入 Card Number，一旦用戶輸入資訊正確，系統(tǒng)會自動新增 CID，以致於該用戶下次再撥入時，就可以通過 CID 認(rèn)證，且不會再提示輸入 Card Number。
• cid_auto_create_card = no

// 新增 Caller ID

A2Billing Admin UI > Customers > Caller-ID

CallerID = <用戶的來電號碼>
Activated = yes
ID Card = <選擇卡號>

F.A.Q