دریافت صوت تماس هوش مصنوعی

دریافت صوت تماس

وب‌سرویس دریافت صوت تماس Telefonchy امکان دریافت فایل‌های صوتی تفکیک‌شده و ترکیبی تماس را فراهم می‌کند. با این API می‌توانید صوت خام کانال دریافت، کانال ارسال یا یک فایل ترکیبی قابل پخش از هر دو کانال را در CRM یا سامانهٔ اختصاصی خود دریافت کنید.

اطلاعات اتصال

https://panel.telefonchy.com

هدر الزامی:

webservice-token: YOUR_WEBSERVICE_TOKEN

در هر سه مسیر، پارامترهای زیر در Query String الزامی‌اند:

service_id از حساب صاحب توکن استخراج می‌شود و در این درخواست‌ها ارسال نمی‌شود. سرور مالکیت تماس، cuid و record_id را بررسی می‌کند.

تفاوت فایل‌ها

RX و TX نام کانال‌های فنی‌اند و لزوماً همیشه معادل اپراتور یا مشتری نیستند. برای نگاشت معنایی، از transcript_by_role در API تحلیل هوشمند استفاده کنید.

دریافت RX

GET /webservice/v1/calls/record-quality/rx?cuid=CALL_CUID&record_id=RECORD_ID

curl --fail --location \
  --header "webservice-token: YOUR_WEBSERVICE_TOKEN" \
  --output call-rx.wav \
  "https://panel.telefonchy.com/webservice/v1/calls/record-quality/rx?cuid=CALL_CUID&record_id=RECORD_ID"

دریافت TX

GET /webservice/v1/calls/record-quality/tx?cuid=CALL_CUID&record_id=RECORD_ID

curl --fail --location \
  --header "webservice-token: YOUR_WEBSERVICE_TOKEN" \
  --output call-tx.wav \
  "https://panel.telefonchy.com/webservice/v1/calls/record-quality/tx?cuid=CALL_CUID&record_id=RECORD_ID"

دریافت فایل ترکیبی Merged

GET /webservice/v1/calls/record-quality/merged?cuid=CALL_CUID&record_id=RECORD_ID

curl --fail --location \
  --header "webservice-token: YOUR_WEBSERVICE_TOKEN" \
  --output call-merged.wav \
  "https://panel.telefonchy.com/webservice/v1/calls/record-quality/merged?cuid=CALL_CUID&record_id=RECORD_ID"

نوع پاسخ

پاسخ موفق فایل Binary است و JSON برنمی‌گرداند. مقدار دقیق Content-Type و نام فایل از CDR به پاسخ منتقل می‌شود. بهتر است پسوند نهایی فایل را مطابق Content-Type یا Content-Disposition پاسخ ذخیره کنید.

نمونهٔ پاسخ ناموفق

{
  "status": "Failed",
  "code": 400,
  "message": "شرح خطا",
  "data": null
}

دسترسی و مصرف

• توکن باید فعال باشد و دسترسی دریافت صوت تماس برای آن فعال شده باشد.

• محدودیت IP تعریف‌شده برای توکن، در صورت وجود، اعمال می‌شود.

• هر درخواست صوت یک واحد از remains وب‌سرویس مصرف می‌کند.

• آماده‌سازی یا Stream فایل بزرگ ممکن است چند ثانیه زمان ببرد؛ Timeout سمت مصرف‌کننده را متناسب تنظیم کنید.

خطاهای رایج

بهترین روش استفاده

• توکن وب‌سرویس را فقط در Backend نگه‌داری کنید.

• پیش از دریافت فایل، cuid و record_id را با اطلاعات تماس خود تطبیق دهید.

• Content-Type و Content-Disposition را برای نام و پسوند صحیح فایل بررسی کنید.

• برای فایل‌های بزرگ، Connect Timeout و Read Timeout مناسب تنظیم کنید.

• در پاسخ 429، پیش از درخواست دوباره مقدار Retry-After را رعایت کنید.

• برای تشخیص نقش اپراتور و مشتری، RX و TX را تفسیر نکنید؛ از transcript_by_role استفاده کنید.

برای دریافت این آموزش اینجا کلیک نمایید