fetchAll("SELECT * FROM posts WHERE status = 'published' ORDER BY created_at DESC LIMIT 6"); } catch (Exception $e) { $posts = []; } ?> گپزی پلاس | توسعه‌دهندگان بات
پلتفرم توسعه‌دهندگان گپزی پلاس

ربات خودت
رو بساز

با API قدرتمند گپزی پلاس، ربات‌های هوشمند بساز. از فروشگاهی تا پشتیبانی، هرچی که فکرشو کنی.

۵۰K+ ربات فعال
۱M+ پیام روزانه
۹۹.۹٪ آپ‌تایم
شروع کنید

چطور ربات بسازم؟

در سه مرحله ساده، ربات خودت رو بساز و شروع به کار کن

سریع و آسان

فقط با یک کلیک ربات بساز، توکن بگیر و شروع به دریافت و ارسال پیام کن. بدون نیاز به دانش فنی پیچیده.

مرحله ۱

وارد بات فادر شو و ربات بساز.

مرحله ۲

توکن دریافتی رو کپی کن.

مرحله ۳

با API شروع به کار کن.

امنیت کامل

هر ربات توکن اختصاصی داره. ارتباطات رمزنگاری شده و کاملاً امن.

بدون محدودیت

تعداد ربات، پیام، کاربر و امکانات نامحدود. هرچی می‌خوای بساز.

مستندات

API ربات

تمام چیزی که برای ساخت ربات نیاز داری اینجاست

BASE https://api.gapzhy.ir/

آدرس پایه API

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

Base URL
https://api.gapzhy.ir/bot
AUTH /bot{TOKEN}/methodName

احراز هویت

توکن ربات خود را در URL قرار دهید. هر ربات یک توکن اختصاصی دارد.

URL Format
https://api.gapzhy.ir/bot{TOKEN}/{METHOD_NAME}
GET /getUpdates

getUpdates - دریافت پیام‌ها

دریافت پیام‌های جدید ارسال شده به ربات. این متد برای polling استفاده می‌شود.

پارامتر نوع وضعیت توضیحات
offset integer اختیاری آی‌دی آخرین پیام دریافت شده
limit integer اختیاری حداکثر تعداد پیام (پیش‌فرض: ۵۰)
PHP
<?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";
    }
}
?>
Response JSON
{
  "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"
      }
    }
  ]
}
POST /sendMessage

sendMessage - ارسال پیام

ارسال پیام متنی از طرف ربات به کاربر.

پارامتر نوع وضعیت توضیحات
chat_id string الزامی شناسه کاربر مقصد
text string الزامی متن پیام
reply_to integer اختیاری آی‌دی پیام برای ریپلای
PHP
<?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;
?>
POST /sendPhoto

sendPhoto - ارسال عکس

ارسال تصویر از طرف ربات به کاربر.

PHP
<?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);
?>
POST /sendVideo

sendVideo - ارسال ویدیو

ارسال ویدیو از طرف ربات به کاربر.

PHP
<?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);
?>
POST /sendDocument

sendDocument - ارسال فایل

ارسال فایل از طرف ربات به کاربر.

PHP
<?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);
?>
POST /setWebhook

Webhook - دریافت خودکار

به جای polling، می‌توانید یک URL تعریف کنید تا پیام‌ها به صورت خودکار به آن ارسال شوند.

HTTP
POST https://api.gapzhy.ir/bot{TOKEN}/setWebhook

{
  "url": "https://yoursite.com/webhook.php"
}
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);
}
?>
ERRORS Error Codes

کدهای خطا

پاسخ‌های خطای احتمالی از API:

کد پیام توضیحات
401 Unauthorized توکن نامعتبر است
400 Bad Request پارامترهای ناقص
403 Forbidden ربات غیرفعال است
404 Not Found متد یافت نشد
429 Too Many Requests تعداد درخواست‌ها زیاد است
مثال‌ها

مثال‌های کاربردی

چند مثال ساده برای شروع کار با API

ربات Echo

رباتی که هر پیامی را دریافت کند، همان را پاسخ می‌دهد.

ربات فروشگاهی

نمایش محصولات، دریافت سفارش و پرداخت.

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

پاسخ خودکار به سوالات متداول کاربران.

ربات خبری

ارسال خودکار اخبار و مطالب جدید.

آماده‌ای رباتت رو بسازی؟

همین حالا وارد بات فادر شو و اولین رباتت رو بساز. کاملاً رایگان و بدون محدودیت.

ساخت ربات جدید
گپزی پلاس با هدف ارائه بهترین تجربه توسعه‌دهندگان طراحی شده است. تیم ما همیشه آماده کمک به شماست.