نحوه کار اعتباربخشی در Zentor App
هیچ سیستم کلید API توسعهدهنده وجود ندارد — فقط ورود به داشبورد و توکن جاسازی ویجت. هر دو اینگونه کار میکنند.
آخرین بررسی: 2026-07-20
Zentor App در حال حاضر یک کلید کلاسیک و دائمی API برای توسعه دهندگان ارائه نمی دهد. دو روش معتبر واقعی وجود دارد: ورود داشبورد (بر اساس جلسه، برای شما به عنوان کاربر) و نشانه های جاسازی ویجت (برای یکپارچه سازی عمومی ویجت چت شما در وب سایت شما).
گام به گام
- درک ورود به داشبوردپس از ثبتنام، یک توکن دسترسی دریافت میکنید که 12 ساعت اعتبار دارد، همچنین یک توکن تازهسازی با 7 روز اعتبار برای اینکه بدون وارد کردن مجدد رمز عبور وارد سیستم بمانید. توکن دسترسی در هر بار تمدید تعویض میشود (فقط یکبار مصرف).
- فعالسازی اختیاری احراز هویت دو مرحلهایشما میتوانید احراز هویت دو مرحلهای مبتنی بر TOTP (سازگار با برنامههای احراز هویت رایج) را برای حساب خود فعال کنید، از جمله کدهای پشتیبان برای مواقع اضطراری.
- ورود یکپارچه (در صورت موجود بودن)اگر برای Tenant شما SSO (SAML/OIDC) راهاندازی شده باشد، ورود به سیستم فقط از طریق Identity-Provider شما قابل اعمال است — ورود با رمز عبور عادی در آن صورت مسدود میشود.
- درک توکن جاسازی ویجتبرای ویجت چت شما، هنگام ایجاد، یک توکن اختصاصی تولید میشود که فقط یک بار به صورت متن ساده نمایش داده میشود. این توکن به شدت محدود به نقاط پایانی عمومی ویجت (پیامهای چت، امتیازدهی، ورودی/خروجی صدا) است و هیچ دسترسی به عملکردهای داشبورد یا مدیریتی نمیدهد. علاوه بر این، دامنه فراخوانیکننده در برابر فهرست مجاز بررسی میشود.
نتیجه مورد انتظار
شما متوجه میشوید که کدام یک از دو مکانیزم واقعاً موجود برای مورد استفاده شما (ورود اختصاصی در مقابل یکپارچهسازی ویجت) مرتبط است.
موارد خطای رایج
من به دنبال یک کلید API هستم تا اسکریپتهای خودم را علیه API اپلیکیشن Zentor اجرا کنم.
علت: چنین سیستم کلید API توسعهدهندهای در حال حاضر وجود ندارد.
راهحل: تنها راه دسترسی برنامهنویسی، نقطه پایانی ورود معمولی با استفاده از توکن پس از آن است — با محدودیتهای ذکرشده (زمان انقضا، وابستگی به نشست). برای یکپارچهسازیهای دائمی با Zentor تماس بگیرید.
توکن دسترسی من در حالی که یک اسکریپت را اجرا میکنم منقضی میشود.
علت: توکن دسترسی به ۱۲ ساعت محدود شده است و باید از طریق نقطه پایانی Refresh تمدید شود.
راهحل: تمدید توکن را از طریق نقطه پایانی بازخوانی پیادهسازی کنید، یا در صورت نیاز دوباره وارد شوید.
توکن ویجت من میتواند به طور تصادفی دادههای داشبورد را بازیابی کند — آیا این یک ریسک امنیتی است؟
علت: نه — توکن ویجت از نظر فنی به شدت محدود به نقاط پایانی عمومی ویجت است و به عنوان جایگزینی برای ورود به نشست عمل نمیکند.
راهحل: نیازی به اقدام نیست؛ با این حال، توکن ویجت را محرمانه تلقی کنید، زیرا علاوه بر بررسی دامنه، به ویجت شما دسترسی میدهد.