دریافت اطلاعات یک تماس
برای دریافت لیست تماس ها بهمراه اطلاعات کامل هر تماس میتوانید با فراخوانی آدرس زیر اقدام نمایید:
`[GET]` https://panel.telefonchy.com/webservice/v1/call
Header
| نام | اجباری بودن | نوع داده | توضیحات |
|---|---|---|---|
webservice-token |
بله | String | توکن وبسرویس خود را میتوانید از پنل کاربری دریافت نمایید |
body
| نام | اجباری بودن | نوع داده | توضیحات |
|---|---|---|---|
call_id |
yes |
String | مقدار id که در رسپانس خروجی تماس ها و لیست گزارشات تماس موجود است |
نمونه کد و خروجی
نمونه کد درخواست
# curl shell code
# Get method calling
curl -i -H "webservice-token: {YOUR_TOKEN}" 'https://panel.telefonchy.com/webservice/v1/call?call_id={YOUR_CALL_ID}'
// php curl code
#GET method calling
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://panel.telefonchy.com/webservice/v1/call?call_id={YOUR_CALL_ID}");
curl_setopt($ch, CURLOPT_POST, 0);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$headers = [
'webservice_token: {YOUR_TOKEN}',
];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$server_output = curl_exec ($ch);
curl_close ($ch);
// dd code 😉
dump(json_decode($server_output));
die(1);
نمونه خروجی درخواست
{
"status": "Ok",
"code": 200,
"message": null,
"data": [
{
"object_id": "674efa77f22s655597d7b70",
"node": "2",
"record_id": null,
"file_id": null,
"file_saved": "0",
"service_id": "3Ev15-782bp77d8-3d4b-****-98bc-4e7c2cca4231",
"cuid": "1733889127.549821",
"type": "outgoing",
"trunk": "219***5458",
"status": "NO ANSWER",
"note": null,
"call_source": "93**45",
"call_dest": "91****4035",
"call_number": null,
"time_wait": "18",
"time_talk": "0",
"updated_at": "2024-12-03 16:10:39",
"created_at": "2024-12-03 16:02:37",
"ended_at": "2024-12-03 16:02:55"
}
]
}
توضیحات فیلد های خروجی
status:- نوع پاسخ دریافتی از سرور را مشخص میکند.
- در اینجا
"status": "Ok"نشاندهنده این است که درخواست با موفقیت پردازش شده است.
code:- کد وضعیت پاسخ است که در اینجا برابر با
200است، که نشاندهنده موفقیت آمیز بودن درخواست میباشد.
- کد وضعیت پاسخ است که در اینجا برابر با
message:- پیام اضافی از سمت سرور برای توضیح بیشتر (در اینجا null است که به این معناست که پیام خاصی وجود ندارد).
data:- آرایهای از دادههایی که شامل اطلاعات تماس است.
- هر شیء در این آرایه نمایانگر یک تماس است.
هر تماس شامل فیلدهای زیر است:
object_id: شناسه منحصر به فرد شیء در پایگاه داده (شناسه تماس).node: شناسه نود سرور که تماس از آنجا ثبت شده است.record_id: شناسه رکورد تماس، در صورتی که ثبت صوتی وجود داشته باشد. این فیلد در اینجاnullاست، که نشان میدهد تماس هیچ رکورد صوتی ندارد.file_id: شناسه فایل صوتی ذخیره شده از تماس (در اینجاnullاست، که نشان میدهد فایلی ذخیره نشده است).file_saved: نشاندهنده اینکه آیا فایل صوتی ذخیره شده است یا نه. مقدار0به این معناست که فایل ذخیره نشده است.service_id: شناسه سرویس که تماس به آن مربوط میشود. این شناسه با مقدار مخفیشده (****) نمایش داده شده است.cuid: شناسه یکتا برای تماس که برای شناسایی آن استفاده میشود.type: نوع تماس، که میتواندincoming(ورودی) یاoutgoing(خروجی) باشد. در اینجا نوع تماسoutgoingاست.trunk: شماره ترانک (خط ارتباطی) که تماس از آن برقرار شده است. بخشی از شماره ترانک بهطور مخفی با***نمایش داده شده است.status: وضعیت تماس، که میتواند شامل مقادیر مختلفی باشد (مثلاًANSWERED,NO ANSWER,BUSYو غیره). در اینجا، وضعیت تماس"NO ANSWER"است که به این معناست که تماس برقرار نشده است.note: یادداشت یا توضیحات اضافی برای تماس. این فیلدnullاست که نشاندهنده نبود یادداشتی است.call_source: شماره تماس منبع (تماسگیرنده). در اینجا بخشی از شماره تماس بهطور مخفی با**نمایش داده شده است.call_dest: شماره تماس مقصد (تماسگیرنده). در اینجا بخشی از شماره تماس بهطور مخفی با****نمایش داده شده است.call_number: شمارهای که تماس از آنجا انجام شده یا به آن انجام شده است. این فیلد در اینجاnullاست.time_wait: زمان انتظار قبل از پاسخ تماس به ثانیه. در اینجا18ثانیه است.time_talk: زمان مکالمه (زمانی که تماس برقرار شده است) به ثانیه. در اینجا0است که نشاندهنده عدم برقراری تماس است.updated_at: زمان آخرین بهروزرسانی اطلاعات تماس.created_at: زمان ایجاد (ثبت) تماس.ended_at: زمان پایان تماس.
