مرحله معامله را از سیستم پیشنهاد هم جلو ببرید

وب‌سرویس معاملات مذاکره باز را با مبلغ و مرحله نگه می‌دارد. اگر پیشنهاد را در نرم‌افزار دیگر می‌نویسید، همان معامله باید در رستاک دیده شود.

وب‌سرویس توسعه‌دهندگان

وب‌سرویس معاملات چه مشکلی را حل می‌کند

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

POST با title، amount، stage. پرسونای بدون معامله این منبع را ندارد.

برای چه کسی است

تیمی که پیشنهاد یا قرارداد را بیرون می‌سازد و باید مرحله در رستاک به‌روز شود.

نمونه کاربرد

  • ساخت معامله بعد از امضای پیش‌فاکتور در سیستم دیگر
  • تغییر stage با PUT وقتی دمو تمام شد
  • خواندن مبلغ باز برای داشبورد خارجی

چرا این ابزار

  • هم‌تراز با پایپ‌لاین پنل
  • مبلغ و مرحله در JSON
  • لیست صفحه‌بندی‌شده
  • حذف معامله آزمایشی با DELETE

چطور از وب‌سرویس معاملات استفاده کنید

1

ماژول معامله

مسیر B2B که deals دارد.

2

کلید API

پلن حرفه‌ای، تب کلیدها.

3

POST یا PUT

معامله جدید یا تغییر مرحله id موجود.

محدودیت صادقانه

برای اینکه با ابزار دیگری اشتباه گرفته نشود.

قوانین مرحله و احتمال بستن ممکن است در پنل غنی‌تر از فیلدهای API باشد. فاکتور منبع جداست.

آدرس و احراز هویت

پایه REST: https://rastakcrm.ir/api/v1 — هدر Authorization: Bearer rstk_…

  • متدها: GET، POST، PUT، DELETE
  • لیست/اصل: https://rastakcrm.ir/api/v1/deals
  • یک رکورد: https://rastakcrm.ir/api/v1/deals/{id}
  • پلن حرفه‌ای یا سازمانی؛ کلید از بخش توسعه‌دهندگان پنل

نمونه بدنه ساخت (JSON)

{
    "title": "قرارداد پشتیبانی سالانه",
    "amount": 25000000,
    "stage": "proposal"
}

نمونه curl

list

curl -X GET \
  "https://rastakcrm.ir/api/v1/deals" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

create

curl -X POST \
  "https://rastakcrm.ir/api/v1/deals" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "قرارداد پشتیبانی سالانه",
    "amount": 25000000,
    "stage": "proposal"
}'

get

curl -X GET \
  "https://rastakcrm.ir/api/v1/deals/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

update

curl -X PUT \
  "https://rastakcrm.ir/api/v1/deals/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "قرارداد پشتیبانی سالانه",
    "amount": 25000000,
    "stage": "proposal"
}'

delete

curl -X DELETE \
  "https://rastakcrm.ir/api/v1/deals/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

سوالات متداول درباره وب‌سرویس معاملات

فاکتور وب‌سرویس جداست؛ معامله را با id خودتان در منطق برنامه ربط دهید.

مقادیر stage همان مراحل پنل مثل proposal در نمونه است؛ مقدار نامعتبر رد می‌شود.

عدد amount طبق واحد فضای کاری است نه تبدیل ارز زنده.

بستگی به پرسونا دارد؛ اگر ماژول نباشد منبع در متای API نیست.

حرفه‌ای یا سازمانی.

کلید را از پنل توسعه‌دهندگان بگیرید

این صفحه مستند عمومی است. ساخت توکن بعد از ورود و پلن حرفه‌ای در منوی توسعه‌دهندگان است.

ایجاد حساب