لید فرم سایت را مستقیم در قیف رستاک بگذارید

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

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

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

اگر فرم فقط ایمیل به صندوق می‌فرستد، لید در چت گم می‌شود. API لید همان منبع پنل با وضعیت و منبع است.

نیاز به پرسونای دارای لید دارد. کیوسک نمایشگاه مسیر عمومی جداست؛ این وب‌سرویس برای سیستم خودتان است با توکن.

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

بازاریاب فنی یا برنامه‌نویس لندینگ که سرنخ را به CRM می‌ریزد.

نمونه کاربرد

  • فرم «درخواست مشاوره» روی سایت
  • وبهوک تبلیغات که نام و موبایل می‌دهد
  • خواندن لیدهای جدید برای نوتیف در ابزار دیگر

چرا این ابزار

  • ثبت با status و source
  • جدا از مخاطب تا قیف قبل از تبدیل بماند
  • CRUD کامل REST
  • لاگ در پنل توسعه‌دهندگان

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

1

مسیر با لید

پرسونای تجاری یا آموزشی؛ فروش فردی بدون لید این منبع را ندارد.

2

توکن

کلید rstk_ در هدر Bearer.

3

POST لید

name، phone و در صورت نیاز company_name را بفرستید.

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

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

کیوسک عمومی توکن نمی‌خواهد؛ این API توکن می‌خواهد. تبدیل لید به مخاطب در پنل است نه لزوماً یک endpoint جادویی جدا.

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

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

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

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

{
    "name": "علی رضایی",
    "phone": "09121112233",
    "company_name": "نیک‌پرداز",
    "status": "new",
    "source": "referral"
}

نمونه curl

list

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

create

curl -X POST \
  "https://rastakcrm.ir/api/v1/leads" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "علی رضایی",
    "phone": "09121112233",
    "company_name": "نیک‌پرداز",
    "status": "new",
    "source": "referral"
}'

get

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

update

curl -X PUT \
  "https://rastakcrm.ir/api/v1/leads/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "علی رضایی",
    "phone": "09121112233",
    "company_name": "نیک‌پرداز",
    "status": "new",
    "source": "referral"
}'

delete

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

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

خیر. کیوسک لینک عمومی است؛ این وب‌سرویس برای سرور شماست.

مثلاً new در JSON نمونه؛ مقادیر معتبر همان وضعیت‌های پنل است.

فیلد source برچسب ورود لید است؛ مقدار را خودتان قرارداد کنید و در پنل ببینید.

DELETE روی /api/v1/leads/{id} با همان توکن.

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

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

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

ایجاد حساب