نتیجه تماس ربات را روی پرونده مشتری بنویسید

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

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

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

یادداشت روزانه بازارچه شخصی است و به پرونده وصل نیست. این API related_type و related_id می‌خواهد.

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

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

سیستمی که خلاصه رویداد را باید در پرونده CRM بچسباند.

نمونه کاربرد

  • ثبت نتیجه تماس بعد از وب‌هوک تلفن
  • یادداشت جلسه از تقویم خارجی
  • خواندن یادداشت‌های یک مخاطب برای دستیار

چرا این ابزار

  • وصل به contact، company، lead یا deal
  • بدنه متن آزاد
  • لیست و حذف
  • جدا از ابزار یادداشت روزانه

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

1

id موجودیت را داشته باشید

اول مخاطب یا لید را از API همان منبع بگیرید.

2

POST نوت

related_type، related_id و body.

3

در پنل ببینید

روی همان پرونده نمایش داده می‌شود.

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

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

فایل پیوست و ویرایشگر غنی نیست. type نامعتبر رد می‌شود.

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

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

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

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

{
    "related_type": "contact",
    "related_id": 1,
    "body": "جلسه دمو برای چهارشنبه هماهنگ شد."
}

نمونه curl

list

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

create

curl -X POST \
  "https://rastakcrm.ir/api/v1/notes" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "related_type": "contact",
    "related_id": 1,
    "body": "جلسه دمو برای چهارشنبه هماهنگ شد."
}'

get

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

update

curl -X PUT \
  "https://rastakcrm.ir/api/v1/notes/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "related_type": "contact",
    "related_id": 1,
    "body": "جلسه دمو برای چهارشنبه هماهنگ شد."
}'

delete

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

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

نمونه contact است؛ شرکت، لید و معامله هم در توضیح منبع آمده.

خیر؛ یادداشت باید به id معتبر بچسبد.

آن برای تودوی شخصی است؛ این برای تاریخچه مشتری است.

لیست GET با q طبق رفتار عمومی API.

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

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

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

ایجاد حساب