API و یکپارچه‌سازی

ConnectTim APIهای REST کامل برای یکپارچه‌سازی با سیستم‌های شما

نگاه کلی

ConnectTim APIهای REST مبتنی بر JSON ارائه می‌دهد که به شما امکان یکپارچه‌سازی با CRM، سیستم رزرو، انبار و سایر سیستم‌های شما را می‌دهد.

REST API

APIهای استاندارد REST با مستندات کامل

Webhooks

دریافت رویدادهای تماس به صورت Real-time

Authentication

احراز هویت با API Key و OAuth2

Rate Limiting

محدودیت نرخ مناسب برای هر پلن

نقاط پایانی API

GET

تماس‌ها

دریافت لیست و جزئیات تماس‌ها

/v1/calls
POST

ایجاد تماس

ایجاد تماس جدید

/v1/calls
POST

عملیات تماس

اجرای عملیات در حین تماس

/v1/calls/action
GET

گزارش‌ها

دریافت گزارش‌های تحلیلی

/v1/reports

مثال‌های استفاده

بررسی موجودی

POST /v1/calls/action
{
  "callId": "call_123456",
  "action": "checkAvailability",
  "params": {
    "date": "2024-01-15",
    "time": "10:00"
  }
}

// پاسخ
{
  "available": true,
  "slots": ["10:00", "11:00", "14:00"]
}

ثبت رزرو

POST /v1/reservations
{
  "callId": "call_123456",
  "customerName": "علی احمدی",
  "customerPhone": "09123456789",
  "date": "2024-01-15",
  "time": "10:00",
  "service": "مشاوره"
}

// پاسخ
{
  "reservationId": "res_789",
  "status": "confirmed",
  "confirmationCode": "ABC123"
}

Webhook - رویداد تماس

// Webhook URL شما
POST https://your-domain.com/webhooks/call-event

// بدنه درخواست
{
  "event": "call.started",
  "callId": "call_123456",
  "timestamp": "2024-01-15T10:00:00Z",
  "data": {
    "phoneNumber": "09123456789",
    "direction": "inbound"
  }
}

ثبت سفارش

POST /v1/orders
{
  "callId": "call_123456",
  "items": [
    {"id": "item_1", "quantity": 2},
    {"id": "item_2", "quantity": 1}
  ],
  "customerPhone": "09123456789",
  "deliveryAddress": "..."
}

// پاسخ
{
  "orderId": "ord_456",
  "status": "confirmed",
  "estimatedTime": "30"
}

احراز هویت

API Key

استفاده از API Key برای احراز هویت سریع و ساده

Authorization: Bearer YOUR_API_KEY

OAuth 2.0

احراز هویت پیشرفته با OAuth 2.0 برای اپلیکیشن‌های سازمانی

Authorization: Bearer ACCESS_TOKEN

محدودیت نرخ

Starter

۱۰۰

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

Enterprise

نامحدود

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

مستندات کامل API

برای مشاهده مستندات کامل API و مثال‌های بیشتر، به پنل کاربری خود مراجعه کنید.

شروع استفاده از API