README

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

📌 ویژگی‌ها

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

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

• 🌐 صفحه اصلی سرویس تماس آسا‌نک
• 🧾 مستندات آنلاین کامل
• 🚀 مستندات آنلاین Postman
• ⬇️ دانلود فایل کالکشن Postman

🔧 نصب پکیج

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

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