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

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

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

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

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

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

فلسفه وجودی

چرا پایپ‌لاین معاملات باید از هر نقطه‌ای در کسب‌وکار قابل به‌روزرسانی باشد؟

بسیاری از رویدادهای سرنوشت‌ساز فروش در بیرون از پنل CRM رخ می‌دهند؛ مانند امضای دیجیتال یک قرارداد، تایید پیشنهاد فنی در سامانه تدارکات، یا پرداخت پیش‌پرداخت در درگاه بانکی. وب‌سرویس معاملات رستاک این امکان را فراهم می‌سازد که به محض وقوع این رویدادها، مرحله معامله (Stage) و مبلغ به‌طور خودکار در پایپ‌لاین به‌روزرسانی شود تا جریان درآمدی همیشه شفاف باشد.

سناریوهای واقعی

جریان‌های کاری و سناریوهای محتمل استفاده

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

1

تغییر خودکار مرحله معامله به "موفق" پس از تایید فاکتور در فروشگاه

پس از تایید پیش‌فاکتور توسط مشتری و ثبت پیش‌پرداخت، وب‌سرویس وضعیت معامله را با متد PUT به won تغییر می‌دهد.

2

ایجاد معامله جدید از سامانه استعلام قیمت

هنگامی که مشتری در سامانه محاسبه آنلاین سفارش ثبت می‌کند، معامله‌ای با عنوان و مبلغ محاسبه‌شده در مرحله "پیشنهاد قیمت" ایجاد می‌شود.

3

همگام‌سازی ارزش کل معاملات باز با داشبورد مدیریتی BI

سامانه‌های گزارش‌گیری بیرونی با متد GET لیست معاملات باز و مبالغ را خوانده و شاخص‌های کلیدی عملکرد (KPI) تیم را تحلیل می‌کنند.

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

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

نمونه کاربرد

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

چرا این ابزار

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

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

1

ماژول معامله

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

2

کلید API

پلن PRO +، تب کلیدها.

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}
  • پلن PRO +؛ کلید از بخش توسعه‌دهندگان پنل

نمونه بدنه ساخت (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 نیست.

PRO +.

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

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

ایجاد حساب