تماس دوطرفه
با استفاده از این سرویس تماس دوطرفه (Number Masking) ایجاد میشود. تماس گیرنده میتواند هم داخلی باشد و هم شماره مخابراتی.چنانکه تماس گیرنده شماره مخابراتی باشد، نام ترانک نیز باید وارد شود. مقدار time_out اختیاری است و در صورت عدم تخصیص بصورت پیشفرض 30 ثانیه در نظر گرفته میشود.
نکته مهم
در تماس دوطرفه در صورتی که نفر اول پاسخ ندهد و تماس را قطع کند اطلاعات مربوط به تماس(CDR) به سمت وبسرویس شما ارسال نمیشود.اگر این موضوع برای شما اهمیت بالایی دارد میتوانید از APIهای مربوط به ساخت کمپین به همراه کامپوننت autodialer route
برای ایجاد تماس دوطرفه استفاده کنید.برای توضیحات بیشتر به این قسمت مراجعه فرمایید.
پارامترها
توضیحات | داده های تعریف شده | داده های نمونه | پارامترهای ضروری[**]/منطقی[*] | پارامترها |
---|---|---|---|---|
(نفر اول در تماس)تماس گیرنده | - | 557 | ** | caller |
(نفر دوم در تماس)شماره مخاطب | - | 552 | ** | callee |
مسیر تماس نفر اول را مشخص میکند(به همراه کامپوننت Outgoing_Route) | - | main_routing | ** | context |
557 | - | 557 | ** | caller_id |
مسیر تماس نفر دوم را مشخص میکند | - | * | trunk_name | |
مدت زمان انتظار برای پاسخگویی | - | 30 | timeout | |
مدت زمان تماس تلفنی | - | 30 | call_limit |
نمونه فراخوانی
- نمونه کد استفاده
- نمونه خروجی
- PHP
- JS
- Curl
نمایش کامل کد PHP
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'http://192.168.51.20/api/v4/call/originate/act',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_POSTFIELDS =>'{
"caller":"557",
"callee":"552",
"context":"main_routing",
"caller_id":"557",
"trunk_name":"cisco",
"timeout":"30",
"call_limit":"30"
}',
CURLOPT_HTTPHEADER => array(
'X-APIKEY: vZKtIKWsld0egNlkzHo8i5LVBqLNBSWARCQsPOSgDjFmAHM3tG',
'Authorization: Basic dGVzdDpBYTEyMzQ1Ng==',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
if (!curl_errno($curl)) {
$httpcode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
echo 'response code:'.$httpcode, '<br/>';
}
curl_close($curl);
echo $response;
?>
نمایش کامل کد JS
<html>
<head>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
</head>
<body>
<script>
var settings = {
"url": "http://192.168.51.20/api/v4/call/originate/act",
"method": "PUT",
"timeout": 0,
"headers": {
"X-APIKEY": "vZKtIKWsld0egNlkzHo8i5LVBqLNBSWARCQsPOSgDjFmAHM3tG",
"Authorization": "Basic dGVzdDpBYTEyMzQ1Ng==",
"Content-Type": "application/json"
},
"data": JSON.stringify({
"caller": "557",
"callee": "552",
"context": "main_routing",
"caller_id": "557",
"trunk_name": "cisco",
"timeout": "30",
"call_limit":"30"
}),
};
$.ajax(settings).always(function (jqXHR) {
console.log("response code: " + jqXHR.status + " " + jqXHR.statusText);
console.log("response body: " + jqXHR.responseText);
});
</script>
</body>
</html>
نمایش کامل کد Curl
curl --location --request PUT 'http://192.168.51.20/api/v4/call/originate/act' \
--header 'X-APIKEY: vZKtIKWsld0egNlkzHo8i5LVBqLNBSWARCQsPOSgDjFmAHM3tG' \
--header 'Authorization: Basic dGVzdDpBYTEyMzQ1Ng==' \
--header 'Content-Type: application/json' \
--data-raw '{
"caller":"557",
"callee":"552",
"context":"main_routing",
"caller_id":"557",
"trunk_name":"",
"timeout":"30",
"call_limit":"30"
}'
{
"success": 1,
"message": null,
"data": {
"originated_call_id": "orig.call.1703145054.787335"
}
}
به جهت آشنایی بیشتر، در بخش مثالهای کاربردی چند نمونه از کاربردهای این سرویس مورد بررسی قرار گرفته است.