API نرم افزار تیکتینگ AzTicket
API نرم افزار تیکتینگ راهی امن برای اتصال سایت، CRM، اپلیکیشن یا نرمافزار داخلی به سامانه پشتیبانی است. در AzTicket میتوانید با توکن API، اطلاعات پایه را بخوانید، تیکت ثبت کنید، تیکتها را مشاهده کنید و برای تیکتها پاسخ بفرستید؛ بدون اینکه کلید یا دسترسی مدیریتی را در سمت کاربر ذخیره کنید.
API نرم افزار تیکتینگ چیست؟
API تیکتینگ مجموعهای از مسیرهای برنامهنویسی است که به نرمافزارهای دیگر اجازه میدهد با سامانه پشتیبانی ارتباط بگیرند. بهجای اینکه همه درخواستها فقط از داخل پنل ثبت شوند، یک سایت، CRM یا سیستم داخلی میتواند درخواست مشتری را به تیکت قابل پیگیری تبدیل کند.
API تیکتینگ AzTicket چه کاربردی دارد؟
- ثبت تیکت از فرم تماس سایت یا پرتال مشتریان
- اتصال CRM یا نرمافزار داخلی به سامانه پشتیبانی
- دریافت لیست تیکتها و مشاهده جزئیات هر تیکت
- ارسال پاسخ پشتیبانی روی تیکتهای موجود
- دریافت اطلاعات پایه مثل دپارتمانها، نوع تیکت و اولویتها
- بررسی وضعیت دسترسی API و اطلاعات پلن فعال
چه قابلیتهایی در API فعلی وجود دارد؟
| قابلیت | توضیح | سطح دسترسی |
|---|---|---|
| وضعیت حساب API | نمایش اطلاعات دامنه، پلن فعال و توکن جاری | نیاز به توکن معتبر |
| اطلاعات پایه | دریافت دپارتمانها، نوع تیکتها و اولویتها | read:metadata |
| مشاهده تیکتها | دریافت لیست و جزئیات تیکتهای همان دامنه | read:tickets |
| ثبت تیکت | ایجاد تیکت جدید برای مشتری مشخصشده | create:tickets |
| ارسال پاسخ | ثبت پاسخ پشتیبانی روی تیکت موجود | reply:tickets |
احراز هویت API چگونه انجام میشود؟
در AzTicket احراز هویت API با Bearer Token انجام میشود. توکن از داخل پنل مدیریت و بخش «API و اتصالها» ساخته میشود و مقدار خام آن فقط همان لحظه نمایش داده میشود. در دیتابیس مقدار hash شده نگهداری میشود، نه متن خام توکن.
نمونه ساختار عمومی درخواست
Authorization: Bearer {token}توکن API باید فقط در سمت سرور، CRM یا نرمافزار امن نگهداری شود. قرار دادن توکن در JavaScript عمومی، سورس صفحه، اپلیکیشن بدون محافظت یا repository عمومی خطرناک است.
API به کدام پلن نیاز دارد؟
استفاده عملیاتی از API در AzTicket برای پلن دارای دسترسی API و در حالت فعال و منقضینشده امکانپذیر است. سایر کاربران میتوانند مستندات را ببینند، اما ساخت یا استفاده عملیاتی از توکن فقط زمانی فعال است که پلن اجازه API داشته باشد.
سناریوهای رایج استفاده از API
ثبت تیکت از سایت
اگر سایت شما فرم تماس یا فرم درخواست پشتیبانی دارد، میتوانید اطلاعات فرم را در سمت سرور دریافت کنید و به API AzTicket بفرستید تا یک تیکت قابل پیگیری ساخته شود.
اتصال CRM به پشتیبانی
در تیمهای فروش و پشتیبانی، CRM معمولاً اطلاعات مشتری را نگهداری میکند. با اتصال CRM به API تیکتینگ، درخواستهای مشتری میتوانند در AzTicket ثبت و از همان مسیر پیگیری شوند.
اتصال نرمافزار داخلی سازمان
اگر سازمان شما نرمافزار داخلی، پرتال مشتری یا سامانه عملیات دارد، API کمک میکند درخواستها بدون ورود دستی دوباره به سیستم پشتیبانی منتقل شوند.
امنیت و محدودیت دسترسی
- هر توکن فقط به دامنه/tenant خودش دسترسی دارد.
- دسترسیها با ability محدود میشوند؛ مثل مشاهده تیکت، ثبت تیکت یا ارسال پاسخ.
- توکن خام نباید در مرورگر یا کد عمومی ذخیره شود.
- برای هر اتصال بهتر است یک توکن جدا با دسترسی محدود ساخته شود.
- در صورت عدم نیاز، توکن باید از پنل غیرفعال شود.
چه چیزهایی فعلاً از API عمومی انجام نمیشود؟
در نسخه فعلی، API برای عملیات اصلی تیکت طراحی شده است. تغییر وضعیت تیکت، حذف تیکت، مدیریت کاربران، عملیات مالی، پرداخت، webhook و آپلود پیوست از API عمومی فعال نیستند و نباید بهعنوان قابلیت آماده در نظر گرفته شوند.
لینکهای مرتبط
سوالات متداول
API نرم افزار تیکتینگ چیست؟
API نرم افزار تیکتینگ راهی برای ارتباط برنامهنویسی بین سامانه پشتیبانی و نرمافزارهای دیگر است؛ مثل سایت، CRM، اپلیکیشن یا پرتال مشتریان.
API تیکتینگ چه کاربردی دارد؟
با API میتوان تیکت ثبت کرد، اطلاعات پایه را خواند، تیکتها را مشاهده کرد و روی تیکتهای موجود پاسخ پشتیبانی ثبت کرد.
آیا میتوان از سایت یا CRM تیکت ثبت کرد؟
بله. اگر توکن معتبر و دسترسی لازم وجود داشته باشد، سایت یا CRM میتواند درخواست مشتری را به تیکت در AzTicket تبدیل کند.
احراز هویت API چگونه انجام میشود؟
احراز هویت با Bearer Token انجام میشود. توکن از پنل مدیریت ساخته میشود و باید فقط در سمت سرور یا نرمافزار امن نگهداری شود.
آیا دسترسی API به پلن خاصی نیاز دارد؟
بله. استفاده عملیاتی از API فقط برای پلنی فعال است که دسترسی API داشته باشد و تاریخ انقضای آن نگذشته باشد.
آیا استفاده از API امن است؟
در صورت نگهداری امن توکن، محدود کردن abilityها و استفاده از اتصال امن، API میتواند روش مناسبی برای اتصال سیستمها باشد. توکن نباید در کد عمومی یا سمت مرورگر قرار بگیرد.
چه اطلاعاتی نباید در سمت کاربر ذخیره شود؟
توکن API، رمز عبور، کلیدهای خصوصی، اطلاعات پرداخت و هر داده محرمانه نباید در مرورگر، JavaScript عمومی یا source page ذخیره شود.
جمعبندی
API نرم افزار تیکتینگ AzTicket برای تیمهایی مناسب است که میخواهند پشتیبانی را با سایت، CRM یا نرمافزار داخلی خود یکپارچه کنند. این API برای ثبت و مشاهده تیکت، پاسخگویی و دریافت اطلاعات پایه طراحی شده و با توکن، پلن فعال و سطح دسترسی کنترل میشود.
میخواهید وباپ ازتیکت را روی دستگاه خود نصب کنید؟