تحلیل هوشمند تماس

تحلیل هوشمند تماس

وب‌سرویس تحلیل هوشمند تماس Telefonchy به شما اجازه می‌دهد با استفاده از cuid یک تماس، درخواست تحلیل هوش مصنوعی ثبت کنید، وضعیت پردازش را پیگیری کنید و پس از تکمیل، خلاصه، نتیجه، متن مکالمه، احساس مشتری و کلیدواژه‌های تشخیص‌داده‌شده را دریافت نمایید.

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

https://panel.telefonchy.com

هدر الزامی همهٔ درخواست‌ها:

webservice-token: YOUR_WEBSERVICE_TOKEN

service_id و cuid باید متعلق به صاحب همین توکن باشند.

ثبت درخواست تحلیل

POST /webservice/v1/calls/analysis/request
Content-Type: application/json

بدنهٔ درخواست

{
  "service_id": "SERVICE_ID",
  "cuid": "CALL_CUID"
}

نمونهٔ cURL

curl --request POST \
  --header "Content-Type: application/json" \
  --header "webservice-token: YOUR_WEBSERVICE_TOKEN" \
  --data '{"service_id":"SERVICE_ID","cuid":"CALL_CUID"}' \
  "https://panel.telefonchy.com/webservice/v1/calls/analysis/request"

record_id را ارسال نکنید؛ سرور آن را با cuid و پس از بررسی مالکیت تماس استخراج می‌کند.

رفتار درخواست تکراری

• تحلیل تکمیل‌شده با HTTP 200 برمی‌گردد.

• تحلیل جدید یا درحال‌پردازش با HTTP 202 برمی‌گردد.

• برای تحلیل موجود، Job و هزینهٔ تحلیل مجدد ایجاد نمی‌شود.

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

• تماس باید پاسخ‌داده‌شده، دارای صوت مناسب و داخل مهلت مجاز تحلیل باشد.

دریافت وضعیت یا نتیجه

GET /webservice/v1/calls/analysis/show?service_id=SERVICE_ID&cuid=CALL_CUID

curl \
  --header "webservice-token: YOUR_WEBSERVICE_TOKEN" \
  "https://panel.telefonchy.com/webservice/v1/calls/analysis/show?service_id=SERVICE_ID&cuid=CALL_CUID"

این GET از remains کم نمی‌کند. تا رسیدن به completed یا failed، هر ۳ تا ۵ ثانیه وضعیت را بررسی کنید.

وضعیت‌های پردازش

فیلد progress عددی بین صفر تا صد است و میزان پیشرفت تحلیل را مشخص می‌کند.

نتیجهٔ تحلیل تکمیل‌شده

پس از تکمیل، داده‌های زیر در پاسخ قابل دریافت هستند:

• summary: خلاصهٔ تماس

• outcome: نتیجهٔ تماس

• report_text: گزارش کامل تحلیل

• coaching_tip: پیشنهاد عملی برای اپراتور

• coaching_reason: دلیل پیشنهاد

• customer_sentiment: احساس تشخیص‌داده‌شدهٔ مشتری

• sentiment_reason: دلیل تشخیص احساس مشتری

• active_keywords: کلیدواژه‌های فعال فعلی سرویس

• matched_keywords: کلیدواژه‌های پیدا‌شده در مکالمه

• transcript: متن خام کانال‌های RX و TX

• transcript_by_role: متن تفکیک‌شدهٔ اپراتور و مشتری

متن و نگاشت نقش‌ها

• transcript.rx و transcript.tx متن خام دو کانال هستند.

• transcript_by_role.operator و transcript_by_role.customer فقط زمانی پر می‌شوند که نگاشت نقش‌ها قابل اعتماد باشد.

• در تماس داخلی یا نگاشت نامطمئن، API نقش‌ها را حدس نمی‌زند و مقدار mapping=unknown برمی‌گرداند.

{
  "operator": null,
  "customer": null,
  "unknown": {
    "rx": "متن RX",
    "tx": "متن TX"
  },
  "mapping": "unknown"
}

کلیدواژه‌ها

active_keywords فهرست کلیدواژه‌های فعال فعلی تنظیمات سرویس و matched_keywords فهرست کلیدواژه‌های پیدا‌شده در مکالمه است.

هنگام دریافت تحلیل تکمیل‌شده، کلیدواژه‌های فعال فعلی Backfill می‌شوند؛ بنابراین کلیدواژه‌هایی که بعداً به تنظیمات اضافه شده‌اند نیز در خروجی ارزیابی خواهند شد.

محدودیت درخواست

پاسخ GET شامل هدرهای محدودیت است:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42

در صورت عبور از سقف:

HTTP/1.1 429 Too Many Requests
Retry-After: 24

خطاهای رایج

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

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

• پس از POST، cuid و service_id را ذخیره کنید.

• وضعیت را هر ۳ تا ۵ ثانیه بررسی کرده و پس از completed یا failed متوقف شوید.

• در رابط کاربری، وضعیت تحلیل درحال‌پردازش را نمایش دهید تا درخواست تکراری ثبت نشود.

• فقط زمانی به تفکیک نقش‌ها اعتماد کنید که mapping برابر verified باشد.

• نتیجهٔ تحلیل را همراه زمان دریافت در سامانهٔ خود نگه‌داری کنید.

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