問1:請問電話連結服務(TAS)的計費方式?
答1:租用服務號碼及呼叫電話連結服務API是不收費的。
租用的服務號碼在「受話」時,如同一般正常號碼,由撥入方付費,租用方免費。
租用的服務號碼在「發話」時,根據現行「市內電話費率」進行收費,說明如下:
費率說明問2:請問如何申請與使用API金鑰?
答2:目前請改寄電子信箱申請,點此申請 ,主旨請打上「申請電話連結服務(TAS)」並註明以「個人用戶」或「企業用戶」角色申請使用服務,後續將由專人為您進行 API 金鑰的配發。透過 API 金鑰 ( 於 Headers 輸入X-API-Key : { X_API_KEY } ) 使用「電話連結」API。詳細 API 使用說明可參考下表的說明文件。
問3:請問可以租用多少個電話連結服務號碼及號碼分配方式?
答3:一個API金鑰至多可以申請 3 個服務號碼,號碼採取動態分配無法指定,分配的號碼範圍為 02-81920000 ~ 02-81920999。
問4:請問可以發出電話通告(call-out)可以撥入到分機中嗎?
答4:目前電話連結服務(TAS)的通告(call-out)功能,僅能撥打到一般的電話號碼,若要撥打總機後轉接到分機號碼,可以配合 MQTT 程式以及運用 playDTMF 功能,在撥打進總機電話號碼後,透過 MQTT 程式控制系統撥放電話按鍵音,轉接到分機號碼。
問5:使用發出電話通告(call-out)時,系統回應中能否區別行動電話是轉進「語音信箱」還是被用戶「接聽」嗎?
答5:目前伺服器無法判斷,因為轉進「語音信箱」的行動電話號碼,會被系統視為「已接通」,建議可以播放語音請被叫用戶按下數字按鍵回應,確定是該用戶接聽電話,而不是轉進語音信箱。另一個方式是,使用者可以在發出電話通告(call-out)時,設定 ringingTimeout 參數設定 25 秒,當被叫用戶超過 25 秒沒有接聽電話時,系統會在超過設定的時間後自動掛斷電話,並且回傳狀態為「未接通」。
問6:與伺服器連線有 TLS 加密憑證,在驗證憑證時有建議的實作方式嗎?
答6:目前伺服器端的憑證約一年更換一次,未來將配合政策縮短更新週期。實作程式時,建議可以使用作業系統上的信任憑證庫清單,並且定期更新清單,避免在 TAS 伺服器更換新憑證後無法連線。不建議在程式中直接綁定網站憑證,因為這樣會造成伺服器端憑證更新後無法正常連線。
問7:申請時設定的「掛帳電話號碼」在使用 API 發出電話通告(call-out) 時電話會被佔線而無法使用嗎?
答7:申請時設定的「掛帳電話號碼」只在每期電話費用出帳時使用,在呼叫 TAS API 發出電話通告(call-out) 時,設定的「掛帳電話號碼」可以正常發話與受話,不會受到影響。
問8:申請時設定的「掛帳電話號碼」是在使用 API 發出電話通告(call-out) 時,被叫電話上顯示的「來話號碼」嗎?
答8:在使用 TAS 服務發出電話通告(call-out)功能時,被叫電話上顯示「來話號碼」會是您透過 reg API 呼叫租用的服務號碼,而不是申請時設定的「掛帳電話號碼」。
問9:使用 API 發出電話通告(call-out) 後,若用戶可以回撥電話嗎?
答9:在使用 TAS 服務發出電話通告(call-out)功能時,被叫電話上顯示「來話號碼」會是您透過 reg API 呼叫租用的服務號碼,若用戶回撥電話,將會依 phoneConfig API 中設定的電話選單內容播音。
問10:使用 API 發出電話通告(call-out) 功能,一定要撰寫 MQTT 客戶端程式嗎?
答10:在使用 TAS 服務發出電話通告(call-out)功能時,若只是單純撥放語音,沒有要取得用戶按下的數字鍵或是進行互動操作,也不需取得被叫用戶的電話接到狀態時,不須搭配 MQTT 客戶端程式使用 TAS API。
問11:使用 API 發出電話通告(call-out) 功能,可以上傳並播放自製語音檔案嗎?
答11:在使用 TAS 服務發出電話通告(call-out)功能時,不支援上傳及播放自製語音檔案,只支援在呼叫 API 時輸入要播放在文字內容,由系統將文字轉為語音檔之後再播音。
問12:使用 API 發出電話通告(call-out) 功能,可以撥出國際電話嗎?
答12:在使用 TAS 服務發出電話通告(call-out)功能時,不支援撥出國際電話,若是呼叫 API 時電話號碼清單中包含國際電話號碼,本次 API 呼叫會失敗,不會撥出清單上的任何電話。
問13:TAS API 使用的 MQTT 協定版本與連線時是否需要加密連線?
答13:TAS API 使用的 MQTT 協定版本為 3.1.1,QoS=0 (沒有 ACK 確認訊息),連線時需使用 TLSv1.2 以上的加密協定。
問14:使用的 MQTT 客戶端程式發送訊息到 callAction 後,沒有收到後續回應?
答14:請確認發送訊息格式正確,id 值須與最近一次從 callEvent 收到的 id 值完全相同,可以訂閱 callActionDebug 看看是否系統端有回應除錯訊息。
問15:租用電話號碼時出現 reach maximum rent count: 3 是什麼意思?
答15:目前一個客戶配發的 API-KEY 限制最多只能租用 3 個服務號碼,請重複利用已經租用的服務號碼,可以透過 GET reg API 列出目前已經租用的服務號碼清單資訊。
問16:在租用的電話服務號碼上運用 phoneConfig API 設定好電話語音選單後,可以多人同時撥入這個服務號碼使用電話語音選單嗎?
答16:TAS 服務提供的電話服務號碼可以接受多人同時撥入使用電話語音選單,不會產生電話佔線問題。