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

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

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

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

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

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

فلسفه وجودی

چرا بایگانی سوابق متنی و لاگ‌های غیرانسانی روی پرونده مشتری ضروری است؟

در سازمان‌های مدرن، بخشی از تعاملات با مشتری توسط سیستم‌های خودکار مانند تلفن گویا (IVR)، ویس‌بات‌های هوش مصنوعی یا لاگ‌های سیستم پشتیبانی انجام می‌شود. اگر این اطلاعات در پایگاه‌های داده مجزا محبوس بمانند، فروشنده هنگام تماس اطلاعات ناقصی از پیشینه مشتری دارد. وب‌سرویس یادداشت‌های رستاک یک لاگ‌بوک یکپارچه برای ثبت هرگونه متن و خلاصه رویداد روی پرونده مخاطب یا معامله است.

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

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

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

1

ثبت خلاصه تماس توسط هوش مصنوعی و سرویس‌های Voice-to-Text

پس از اتمام مکالمه، هوش مصنوعی متن مکالمه را خلاصه کرده و با متد POST مستقیماً روی پرونده مخاطب ثبت می‌کند.

2

درج یادداشت سیستمی هنگام تغییر وضعیت سفارش در فروشگاه اینترنتی

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

3

ثبت نتایج نظرسنجی و ارزیابی رضایت مشتری

پلتفرم نظرسنجی پیامکی پاسخ‌ها و امتیاز مشتری را در قالب یک یادداشت ساختاریافته به پرونده الصاق می‌کند.

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

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

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

PRO +.

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

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

ایجاد حساب