مخاطبین را از سیستم خودتان به رستاک وصل کنید

وب‌سرویس مخاطبین همان دفترچه افراد فضای کاری است؛ فرم سایت، اپ موبایل یا میان‌افزار می‌تواند مخاطب بسازد و بخواند بدون ورود به پنل.

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

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

ورود دستی مخاطب برای تیم کوچک کافی است؛ وقتی فرم سایت یا سیستم دیگر منبع شماره است، باید همان داده با API در رستاک بنشیند تا پیگیری دو جا نماند.

مسیر /api/v1/contacts عملیات کامل REST دارد: لیست با جستجو و صفحه، ساخت، خواندن یک رکورد، به‌روزرسانی و حذف. احراز هویت با هدر Authorization و توکن rstk_ است. در پلن BASIC و PRO وب‌سرویس قفل است.

فلسفه وجودی

چرا اتصال مستقیم فرم‌ها به دفترچه مخاطبین ضروری است؟

در بسیاری از کسب‌وکارها، اطلاعات تماس مشتریان در پورتال‌های ثبت‌نام، فروشگاه‌های اینترنتی یا فرم‌های مشاوره ثبت می‌شود اما با تاخیر چندروزه و به‌صورت دستی وارد نرم‌افزار CRM می‌گردد. این گپ زمانی باعث سرد شدن ارتباط با خریدار و خطای انسانی در ثبت شماره‌ها می‌شود. فلسفه وب‌سرویس مخاطبین رستاک، تبدیل خودکار هر ثبت‌نام آنلاین به یک پرونده زنده در CRM در کسری از ثانیه است.

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

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

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

1

همگام‌سازی ثبت‌نام در سایت وردپرسی یا فروشگاه آنلاین

به محض اینکه کاربر در سایت شما ثبت‌نام می‌کند یا فرم مشاوره را پر می‌کند، یک درخواست POST به /api/v1/contacts ارسال شده و مخاطب با مشخصات کامل ایجاد می‌شود.

2

یکپارچه‌سازی مخاطبین با اپلیکیشن موبایل اختصاصی

اپلیکیشن مشتریان یا پنل خدمات با ارسال توکن Bearer مشخصات پروفایل کاربر را به‌روزرسانی کرده و یادداشت‌های تغییر وضعیت را ذخیره می‌کند.

3

اتصال کال‌سنتر و سیستم VoIP به پرونده مشتری

هنگام تماس ورودی، سرور تلفنی با متد GET شماره مشتری را جستجو کرده و نام و وضعیت پرونده را روی صفحه اپراتور نمایش می‌دهد.

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

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

نمونه کاربرد

  • ثبت مخاطب از فرم تماس سایت
  • همگام‌سازی دفترچه با سیستم دیگر
  • خواندن موبایل برای ارسال از کانال خودتان

چرا این ابزار

  • CRUD کامل روی همان مدل مخاطب پنل
  • جستجو و صفحه‌بندی در لیست
  • نمونه JSON و curl در همین صفحه
  • لاگ درخواست در بخش توسعه‌دهندگان پنل

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

1

پلن و کلید

پلن PRO + و کلید API از منوی توسعه‌دهندگان.

2

POST مخاطب

نام و موبایل را با Bearer به /api/v1/contacts بفرستید.

3

لیست و به‌روزرسانی

با GET فیلتر کنید و با PUT همان id را عوض کنید.

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

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

سقف مخاطب پلن اعمال می‌شود. توکن به فضای کاری مالک است نه هر کاربر مهمان. حذف برگشت‌ناپذیر است.

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

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

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

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

{
    "first_name": "سارا",
    "last_name": "محمدی",
    "mobile": "09120000000",
    "email": "sara@example.com",
    "status": "active",
    "source": "website"
}

نمونه curl

list

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

create

curl -X POST \
  "https://rastakcrm.ir/api/v1/contacts" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "سارا",
    "last_name": "محمدی",
    "mobile": "09120000000",
    "email": "sara@example.com",
    "status": "active",
    "source": "website"
}'

get

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

update

curl -X PUT \
  "https://rastakcrm.ir/api/v1/contacts/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "سارا",
    "last_name": "محمدی",
    "mobile": "09120000000",
    "email": "sara@example.com",
    "status": "active",
    "source": "website"
}'

delete

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

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

https://دامنه-شما/api/v1/contacts برای لیست و ساخت؛ /api/v1/contacts/{id} برای یک رکورد.

حداقل هویت فرد مثل نام و موبایل طبق نمونه JSON همین صفحه؛ status و source اختیاری‌اند.

اکسل دستی و دسته‌ای است؛ API برای اتصال زنده نرم‌افزار دیگر است.

محدودیت throttle روی مسیر API اعمال می‌شود؛ برای همگام‌سازی انبوه صفحه و تأخیر بگذارید.

وب‌سرویس در پلن PRO + است.

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

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

ایجاد حساب