ดึงไฟล์เสียงของ Call

GEThttps://api.voice-agent.gowajee.ai/api/call/:callId/record-url

ดึงลิงก์ใหม่ 2 ลิงก์สำหรับไฟล์เสียงของ call ลิงก์แรกใช้เปิดฟังในเบราว์เซอร์ อีกลิงก์ใช้ดาวน์โหลดเป็นไฟล์

ลิงก์หมดอายุภายใน 1 ชั่วโมง

ขอลิงก์ใหม่ทุกครั้งที่ต้องใช้ อย่าเก็บ URL ไว้ ถ้าต้องเก็บไฟล์เสียง ให้ดาวน์โหลดตัวไฟล์ไปเก็บแทน

Path parameters

ชื่อ	คำอธิบาย
callId	ID ของ call

Request

cURL

curl "https://api.voice-agent.gowajee.ai/api/call/fc1c320d-d133-4d48-8118-5932d93149fd/record-url" \
  -H "X-API-Key: $GOWAJEE_API_KEY"

# Download the file
curl -L -o recording.wav "<downloadUrl from the response>"

JavaScript

const res = await fetch(`https://api.voice-agent.gowajee.ai/api/call/${callId}/record-url`, {
  headers: { 'X-API-Key': process.env.GOWAJEE_API_KEY },
});
const body = await res.json();
if (res.ok) {
  const audio = await fetch(body.downloadUrl).then((r) => r.arrayBuffer());
} else if (body.code === 'RECORDING_DELETED') {
  console.log('Recording deleted at', body.expiredAt);
}

Python

res = requests.get(
    f"https://api.voice-agent.gowajee.ai/api/call/{call_id}/record-url",
    headers={"X-API-Key": os.environ["GOWAJEE_API_KEY"]},
    timeout=30,
)
info = res.json()
if res.ok:
    with open("recording.wav", "wb") as f:
        f.write(requests.get(info["downloadUrl"], timeout=120).content)
elif info["code"] == "RECORDING_DELETED":
    print("Recording deleted at", info["expiredAt"])

Response

endpoint นี้ส่ง field มาที่ชั้นบนสุด ไม่มี data ครอบ

200 OK

{
  "success": true,
  "recordUrl": "https://storage.example.com/recordings/fc1c320d.wav?X-Amz-Expires=3600&X-Amz-Signature=...",
  "downloadUrl": "https://storage.example.com/recordings/fc1c320d.wav?response-content-disposition=attachment...&X-Amz-Signature=..."
}

410 Deleted

{
  "success": false,
  "statusCode": 410,
  "code": "RECORDING_DELETED",
  "message": "Recording deleted by data retention policy",
  "errors": ["Recording deleted by data retention policy"],
  "expiredAt": "2026-12-30T02:13:58.592Z"
}

404 No recording

{
  "success": false,
  "statusCode": 404,
  "code": "RECORDING_NOT_FOUND",
  "message": "No recording available for this call",
  "errors": ["No recording available for this call"]
}

Field	Type	คำอธิบาย
success	boolean	เป็น true เมื่อได้ 200
recordUrl	string	ลิงก์สำหรับเปิดฟัง (เปิดในเบราว์เซอร์)
downloadUrl	string หรือ null	ลิงก์ดาวน์โหลด จะได้ไฟล์ชื่อ recording-<callId>.<ext>

Error

body ใช้รูปแบบ error ปกติ

Status	code	message	สาเหตุ
400	INVALID_ID	callId must be a valid UUID	ID ใน path ไม่ใช่ UUID
404	CALL_NOT_FOUND	Call not found	callId ผิด หรือ call นี้เป็นขององค์กรอื่น
404	RECORDING_NOT_FOUND	No recording available for this call	call นี้ไม่มีไฟล์เสียง เช่น NO_ANSWER, BUSY หรือ call ที่ยังคุยไม่จบ
410	RECORDING_DELETED	Recording deleted by data retention policy	ระบบลบไฟล์เสียงไปแล้วตาม data retention policy ขององค์กร หรือเพราะลบ campaign ของ call นี้ไปแล้ว expiredAt บอกเวลาที่ลบ (UTC) ถ้าไม่ทราบเวลาจะเป็น null ไฟล์ที่ลบแล้วกู้คืนไม่ได้