پشتیار
پشتیار
ابزارها و وب‌هوک‌ها

ساخت و پیکربندی ابزار وب‌هوک

راهنمای تعریف ابزار جدید در پنل کاربری، تنظیم URL وب‌هوک و اتصال آن به اپراتور

برای اینکه مدل هوش مصنوعی بتواند وب‌سرویس سرور شما را حین مکالمه فراخوانی کند، مشخصات ابزار (Tool Schema) را در پنل کاربری پشتیار ثبت نمایید.


مراحل ایجاد ابزار در پنل کاربری

  1. وارد پنل کاربری پشتیار شوید.
  2. از منوی کناری به بخش ابزارها و وب‌هوک‌ها مراجعه فرمایید.
  3. روی دکمه ایجاد ابزار جدید کلیک کنید.
  4. فیلدهای زیر را تکمیل نمایید:
    • نام یکتا (Function Name): نام انگلیسی با حروف کوچک و بدون فاصله (مانند check_inventory یا book_appointment).
    • توضیحات عملکرد (Tool Description): توضیح شفاف برای هوش مصنوعی که این ابزار چه کاری انجام می‌دهد و چه زمانی باید فراخوانی شود.
    • آدرس وب‌هوک (Endpoint URL): آدرس سرور اختصاصی شما با پروتکل امن https://.
    • متد HTTP: متد POST.
    • هدرهای امنیتی (Custom Headers): تعریف کلید و مقدارهایی نظیر X-INTERNAL-TOKEN.
    • پارامترهای ورودی (Parameters Schema): متغیرهایی که هوش مصنوعی باید از گفتگوی کاربر استخراج کند (مانند order_id یا phone_number).

اتصال ابزار به اپراتور

پس از ذخیره ابزار:

  1. به صفحه اپراتورها رفته و اپراتور مد نظر را ویرایش کنید.
  2. در بخش ابزارهای متصل، تیک ابزار ساخته‌شده را فعال فرمایید.
  3. با ذخیره تغییرات، در تمامی تماس‌های بعدی این اپراتور، ابزار در دسترس دستیار صوتی هوشمند قرار می‌گیرد.