快速入門-TTS方式
IVR群呼
文本轉語音，通過指定語言和指定語言文本發送TTS語音消息，適用OTP、營銷場景。
TTS對接流程
前期準備
取得API Key、API Secret和appld的值。
需登陸客戶端取得, 具體位圖如下圖所示：
Sign簽名規則
使用API Key + API Secret + Timestamp當前系統時間戳（秒），生成MD5-32位字符串(不區分大小寫)作為簽名。
示例：
API Key：bDqJFiq9
API Secret：7bz1lzh9
Timestamp當前系統時間戳（秒）：1630468800
MD5(bDqJFiq97bz1lzh91630468800)：05d7a50893e22a5c4bb3216ae3396c7c
API對接流程
01TTS群呼
詳情可參考 TTS群呼對接文檔。
| 功能 | 參數 | 參數值 |
|---|---|---|
| 選擇不同音色，使語音更有親和力 | accent | 口音，可配置語種口音，如英語[美國口音]、英語[印度口音] 等，口音詳細內容請查詢下方表格 |
| 配合合理的語速更清晰，推薦1倍速 | speakingRate | 語速：0.25 - 4倍 |
| 文本轉語音，可在文本中插入變量，例如用戶名 | recallCount | 重呼次數，0-10數字 |
發送語音OTP示例（僅作說明參考；實際調用時請刪除所有//開頭的註釋內容，確保 JSON 格式正確）
curl --location 'https://api.laaffic.com/voice/sendCode'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: 02b484c9209a738162cdcd958e30c31c'
--header 'Timestamp: 1761550833'
--header 'Api-Key: cLMnWQhR'
--data '{
"callee":"912111111111", //被叫號碼
"language":"EN", //語言
"text":"your otp is 1 2 6 4", //otp內容
"appId":"cER2Ev2w", //語音應用ID
"loopCount":2 //循環播放次數，推薦3
}'發送語音營銷示例（僅作說明參考；實際調用時請刪除所有//開頭的註釋內容，確保 JSON 格式正確）
curl --location 'https://api.laaffic.com/voice/sendCode'
--header 'Content-Type: application/json;charset=UTF-8'
--header 'Sign: 2bb28c85f3990e2b8a657ee11089766d'
--header 'Timestamp: 1765966432'
--header 'Api-Key: Lh7vkyKSv0kTb5KvSPNdF7M67QZMvt2o'
--header 'Cookie: JSESSIONID=491C9A87E7854840E5DB4ECF6815D666'
--data '{
"callee": "918111111111",//被叫號碼
"language":"EN", //文本語言
"text":"hello,Your AAV limit has been updated! Enjoy a daily interest rate as low as 0.4%! Borrow 10,000 Naira and repay as little as 10,900 Naira in one month. Log in to your AAV app NOW to check your limited-time offer!",
"appId":"sER2Ev2w", //語音應用
"maxDuration":50, //最長通話時長,接通後50秒強制掛斷
"loopCount":2, //循環播放2次
"recallCount":3, //失敗重呼，最多重呼3次
"recallInterval":20 //間隔20min重呼
}'02狀態報告推送
當用戶在賬戶設置-語音應用管理頁面，配置了http推送地址後，平台會將http-api接入的語音，狀態報告主動推送給用戶配置地址。可登錄客戶端設置，具體位置如圖所示
當用戶在賬戶管理-語音應用管理頁面，配置了cc-http推送地址後，平台會將呼叫中心生成的通話記錄，主動推送給用戶配置地址。 我方推送失敗後，會隔30分鐘再次進行推送，最多推送3次
狀態報告推送
常見錯誤碼速查
以下是幾個常見錯誤碼原因和處理方式，全局可看 全局狀態碼
| Status | Reason | Description |
|---|---|---|
| -1 | Authentication error | 檢查API Key、API Secret和appId的參數值 |
| -18 | Port program unusual | 檢查請求格式，請求body是否是json格式 |
