ایجاد تماس سریع

معرفی

با وب‌سرویس تماس سریع می‌توانید از داخل سیستم خود درخواست برقراری تماس ثبت کنید. در این فرایند، داخلی مشخص‌شده ابتدا باید در دسترس و آنلاین باشد تا تماس با شمارهٔ مقصد برقرار شود.

نکته: برای اجرای موفق تماس، داخلی انتخاب‌شده باید آنلاین باشد و شمارهٔ مقصد را با قالب معتبر ارسال کنید.

نشانی و روش درخواست

GET https://panel.telefonchy.com/webservice/v1/smartcall

این مسیر از روش GET استفاده می‌کند. پارامترهای service_id، exten و to باید به‌صورت پارامترهای نشانی به درخواست افزوده شوند و توکن وب‌سرویس نیز در هدر قرار گیرد.

هدرهای درخواست

نام

اجباری

نوع داده

توضیحات

webservice-token

بله

String

توکن وب‌سرویس را از پنل کاربری دریافت کنید.

پارامترهای درخواست

نام

اجباری

نوع داده

توضیحات

service_id

بله

String

شناسهٔ سرویس است که در پنل کاربری قابل مشاهده است.

exten

بله

String

شمارهٔ داخلی است که می‌خواهید تماس از طرف آن برقرار شود.

to

بله

String

شمارهٔ مقصدی است که می‌خواهید با آن تماس برقرار شود.

نکته: درخواست از نوع GET است؛ بنابراین این سه مقدار را در بدنهٔ درخواست نفرستید و آن‌ها را به نشانی درخواست اضافه کنید.

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

نمونهٔ cURL

curl -i -H "webservice-token: {YOUR_TOKEN}" \
  'https://panel.telefonchy.com/webservice/v1/smartcall?service_id={YOUR_SERVICE_ID}&exten={YOUR_EXTENSION}&to={DESTINATION_NUMBER}'

نمونهٔ PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://panel.telefonchy.com/webservice/v1/smartcall?service_id={YOUR_SERVICE_ID}&exten={YOUR_EXTENSION}&to={DESTINATION_NUMBER}',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => [
    'webservice-token: {YOUR_TOKEN}'
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

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

{
  "status": "Ok",
  "code": 200,
  "message": null,
  "data": {
    "status": "success",
    "message": "تماس سریع با موفقیت اجرا شد. اپراتور باید در این لحظه آنلاین باشد."
  }
}

ساختار پاسخ

فیلد

توضیحات

status

وضعیت کلی پردازش درخواست است. مقدار Ok نشان می‌دهد درخواست با موفقیت پردازش شده است.

code

کد وضعیت پاسخ است. مقدار 200 نشان‌دهندهٔ موفقیت درخواست است.

message

پیام تکمیلی سرور است. مقدار null یعنی پیام اضافه‌ای ارسال نشده است.

data.status

وضعیت اجرای تماس سریع است. مقدار success نشان‌دهندهٔ ثبت موفق درخواست است.

data.message

پیام تکمیلی مربوط به نتیجهٔ اجرای تماس سریع است.

نکات مهم و امنیتی

  • توکن وب‌سرویس را فقط در محیط امن سمت سرور نگه دارید و هرگز آن را در کد سمت کاربر یا مخزن عمومی قرار ندهید.

  • پیش از ارسال درخواست، service_id و شمارهٔ داخلی را با سرویس موردنظر تطبیق دهید.

  • شمارهٔ مقصد را اعتبارسنجی کنید تا از ثبت تماس‌های اشتباه جلوگیری شود.

  • موفقیت پاسخ API به‌تنهایی تضمین نمی‌کند که گفت‌وگو انجام شده است؛ وضعیت آنلاین‌بودن اپراتور و نتیجهٔ عملی تماس را نیز بررسی کنید.

  • برای جلوگیری از ثبت درخواست‌های تکراری، در سیستم خود محدودیت زمانی یا شناسهٔ یکتای عملیات در نظر بگیرید.

جمع‌بندی

وب‌سرویس Smart Call راهی ساده برای اتصال سیستم شما به فرایند تماس است. با ارسال درست شناسهٔ سرویس، داخلی و شمارهٔ مقصد و با رعایت کنترل‌های امنیتی، می‌توانید درخواست تماس را به‌صورت سریع و قابل‌مدیریت ثبت کنید.

دانلود راهنمای این پست مرکز آموزش به صورت PDF (کلیک کنید)