asanak/php-web-call-client

There is no license information available for the latest version (v1.0.0) of this package.

A modern PHP Web Call client managing calls via REST API

v1.0.0 2025-06-30 14:23 UTC

This package is not auto-updated.

Last update: 2025-06-30 17:45:54 UTC


README

یک کلاینت مدرن PHP برای مدیریت تماس ها از طریق یک سرویس RESTful.

📌 ویژگی‌ها

  • آپلود فایل صوتی به لیست فایل ها
  • ایجاد تماس از طریق فایل صوتی (تک یا چند مقصده)
  • ایجاد تماس برای کد های احراز هویت (OTP)
  • دریافت گزارش وضعیت تماس ها
  • دریافت اعتبار باقی مانده

📄 منابع و مستندات

🔧 نصب پکیج

در ترمینال خود اجرا کنید:

composer require asanak/php-web-call-client

🧪 نحوه استفاده

1- مقداردهی اولیه کلاینت:

use Asanak\WebCallClient;
use Asanak\WebCallConfig;

$config = new WebCallConfig([
    'base_url' => 'https://callapi.asanak.com'
]);
$client = new WebCallClient('your-username', 'your-password', $config);

1. افزودن فایل صوتی جدید

try {
    $response = $client->uploadNewVoice('/path/file/voice.mp3');
    var_dump($response);
} catch(\Throwable $th) {
    echo $th->getMessage();
}

2. تماس از طریق فایل صوتی

try{
    $response = $client->callByVoice('VOICE_FILE_ID', '09120000000');
    var_dump($response);
} catch(\Throwable $th) {
    echo $th->getMessage();
}

3. تماس OTP

try{
    $response = $client->callByOtp(1234, '09120000000');
    var_dump($response);
} catch(\Throwable $th) {
    echo $th->getMessage();
}

4. استعلام وضعیت تماس ها

try{
    $response = $client->callStatus(['CALL_ID_1', 'CALL_ID_1']);
    var_dump($response);
} catch(\Throwable $th) {
    echo $th->getMessage();
}

5. دریافت اعتبار باقی مانده

try{
    $response = $client->getCredit();
    var_dump($response);
} catch(\Throwable $th) {
    echo $th->getMessage();
}

🧰 لاگ‌گذاری و مانیتورینگ (اختیاری)

اگر قصد دارید لاگ‌ها را ذخیره کنید، می‌توانید از Monolog استفاده نمایید:

composer require monolog/monolog
<?php
use Asanak\WebCallClient;
use Asanak\WebCallConfig;

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$logger = new Logger('web-call-client');
$logger->pushHandler(new StreamHandler(__DIR__.'/debug.log'));

$config = new WebCallConfig([
    'base_url' => 'https://callapi.asanak.com'
]);
$client = new WebCallClient('username', 'password', $config, $logger);

📮 ارتباط با پشتیبانی

📞 ۰۲١۶۴۰۶۳۱۸۰
📨 info@asanak.ir