fetchAll("SELECT * FROM posts WHERE status = 'published' ORDER BY created_at DESC LIMIT 6"); } catch (Exception $e) { $posts = []; } ?>
با API قدرتمند گپزی پلاس، رباتهای هوشمند بساز. از فروشگاهی تا پشتیبانی، هرچی که فکرشو کنی.
در سه مرحله ساده، ربات خودت رو بساز و شروع به کار کن
فقط با یک کلیک ربات بساز، توکن بگیر و شروع به دریافت و ارسال پیام کن. بدون نیاز به دانش فنی پیچیده.
وارد بات فادر شو و ربات بساز.
توکن دریافتی رو کپی کن.
با API شروع به کار کن.
هر ربات توکن اختصاصی داره. ارتباطات رمزنگاری شده و کاملاً امن.
تعداد ربات، پیام، کاربر و امکانات نامحدود. هرچی میخوای بساز.
تمام چیزی که برای ساخت ربات نیاز داری اینجاست
تمام درخواستهای ربات باید به این آدرس ارسال شوند. میتوانید از طریق این آدرس به تمام متدهای ربات دسترسی داشته باشید.
https://api.gapzhy.ir/bot
توکن ربات خود را در URL قرار دهید. هر ربات یک توکن اختصاصی دارد.
https://api.gapzhy.ir/bot{TOKEN}/{METHOD_NAME}
دریافت پیامهای جدید ارسال شده به ربات. این متد برای polling استفاده میشود.
| پارامتر | نوع | وضعیت | توضیحات |
|---|---|---|---|
offset |
integer | اختیاری | آیدی آخرین پیام دریافت شده |
limit |
integer | اختیاری | حداکثر تعداد پیام (پیشفرض: ۵۰) |
<?php
$token = 'YOUR_BOT_TOKEN';
$url = "https://api.gapzhy.ir/bot{$token}/getUpdates";
$response = file_get_contents($url);
$data = json_decode($response, true);
if ($data['ok']) {
foreach ($data['result'] as $update) {
$chat_id = $update['message']['chat']['id'];
$text = $update['message']['text'];
echo "پیام: {$text}\n";
}
}
?>
{
"ok": true,
"result": [
{
"update_id": 123456,
"message": {
"message_id": 1,
"from": {
"id": 12345,
"name": "کاربر",
"username": "user123"
},
"chat": {
"id": 12345,
"type": "private"
},
"date": 1728000000,
"text": "/start"
}
}
]
}
ارسال پیام متنی از طرف ربات به کاربر.
| پارامتر | نوع | وضعیت | توضیحات |
|---|---|---|---|
chat_id |
string | الزامی | شناسه کاربر مقصد |
text |
string | الزامی | متن پیام |
reply_to |
integer | اختیاری | آیدی پیام برای ریپلای |
<?php
$token = 'YOUR_BOT_TOKEN';
$url = "https://api.gapzhy.ir/bot{$token}/sendMessage";
$data = [
'chat_id' => '12345',
'text' => 'سلام! این یک پیام تستی است.'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
ارسال تصویر از طرف ربات به کاربر.
<?php
$token = 'YOUR_BOT_TOKEN';
$url = "https://api.gapzhy.ir/bot{$token}/sendPhoto";
$data = [
'chat_id' => '12345',
'photo' => new CURLFile('/path/to/photo.jpg'),
'caption' => 'توضیح عکس'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
?>
ارسال ویدیو از طرف ربات به کاربر.
<?php
$token = 'YOUR_BOT_TOKEN';
$url = "https://api.gapzhy.ir/bot{$token}/sendVideo";
$data = [
'chat_id' => '12345',
'video' => new CURLFile('/path/to/video.mp4'),
'caption' => 'توضیح ویدیو'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
?>
ارسال فایل از طرف ربات به کاربر.
<?php
$token = 'YOUR_BOT_TOKEN';
$url = "https://api.gapzhy.ir/bot{$token}/sendDocument";
$data = [
'chat_id' => '12345',
'document' => new CURLFile('/path/to/document.pdf'),
'caption' => 'توضیح فایل'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
?>
به جای polling، میتوانید یک URL تعریف کنید تا پیامها به صورت خودکار به آن ارسال شوند.
POST https://api.gapzhy.ir/bot{TOKEN}/setWebhook
{
"url": "https://yoursite.com/webhook.php"
}
<?php
$input = file_get_contents('php://input');
$update = json_decode($input, true);
if (!$update) exit;
$chat_id = $update['message']['chat']['id'] ?? 0;
$text = $update['message']['text'] ?? '';
if ($text === '/start') {
sendMessage($chat_id, 'سلام! خوش آمدید 👋');
}
function sendMessage($chat_id, $text) {
$token = 'YOUR_BOT_TOKEN';
$url = "https://api.gapzhy.ir/bot{$token}/sendMessage";
$data = [
'chat_id' => $chat_id,
'text' => $text
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_exec($ch);
curl_close($ch);
}
?>
پاسخهای خطای احتمالی از API:
| کد | پیام | توضیحات |
|---|---|---|
401 |
Unauthorized | توکن نامعتبر است |
400 |
Bad Request | پارامترهای ناقص |
403 |
Forbidden | ربات غیرفعال است |
404 |
Not Found | متد یافت نشد |
429 |
Too Many Requests | تعداد درخواستها زیاد است |
چند مثال ساده برای شروع کار با API
رباتی که هر پیامی را دریافت کند، همان را پاسخ میدهد.
نمایش محصولات، دریافت سفارش و پرداخت.
پاسخ خودکار به سوالات متداول کاربران.
ارسال خودکار اخبار و مطالب جدید.