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

اتصال سامانه CRM به پشتیار

راهنمای گام‌به‌گام و سریع اتصال هر نوع CRM به پشتیار جهت استعلام سوابق و شناخت مشتری در شروع تماس تلفنی

با اتصال سامانه CRM به پشتیار، هوش مصنوعی به محض برقراری تماس تلفنی، شماره تماس مخاطب را در CRM شما جستجو می‌کند و با دانستن نام، پیشینه و یادداشت‌های مشتری، مکالمه را کاملاً هوشمندانه و با نام او آغاز می‌کند («سلام جناب رضایی عزیز، وقتتون بخیر...»).

تمامی سامانه‌های CRM (اختصاصی، ابری یا شرکتی) با همین ۳ مرحله ساده به پشتیار متصل می‌شوند.


روند کار چگونه است؟

۱. مشتری تماس می‌گیرد ──► پشتیار شماره را به CRM شما می‌فرستد
۲. CRM شما پاسخ می‌دهد: { "name": "علی رضایی", "status": "مشتری VIP" }
۳. هوش مصنوعی مکالمه را با شناخت کامل شروع می‌کند!

گام ۱: ساخت وب‌سرویس ساده در CRM شما

تنها کاری که در سمت CRM باید انجام شود، داشتن یک آدرس (URL) است که با دریافت شماره موبایل، اطلاعات مشتری را در قالب یک پاسخ ساده JSON بازگرداند.

نمونه پاسخ مورد انتظار از CRM شما:

{
  "name": "علی رضایی",
  "status": "مشتری طلایی",
  "notes": "آخرین بار در خصوص تمدید قرارداد سالانه تماس گرفته بودند."
}

فیلدهای دلخواه

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

چنانچه شماره تماس در سیستم شما جدید باشد و پرونده‌ای نداشته باشد، کافی است خروجی زیر را بازگردانید:

{
  "found": false,
  "message": "مخاطب جدید است"
}

گام ۲: ایجاد ابزار CRM در پنل پشتیار

وارد پنل کاربری پشتیار شوید و مراحل زیر را انجام دهید:

باز کردن صفحه ابزارها

از منوی کناری پنل کاربری، به بخش ابزارها و وب‌هوک‌ها بروید و روی دکمه ایجاد ابزار جدید کلیک کنید.

تکمیل فرم مشخصات ابزار

اطلاعات فرم را مطابق زیر وارد کنید:

  • نام فنی ابزار: get_customer_info
  • عنوان: استعلام اطلاعات مشتری از CRM
  • توضیحات عملکرد (برای هوش مصنوعی):

    «این ابزار با دریافت شماره موبایل تماس‌گیرنده، نام و سوابق مشتری را از سامانه CRM دریافت می‌کند.»

  • آدرس وب‌هوک (URL): آدرس وب‌سرویس CRM شما (مثال: https://crm.yourcompany.com/api/customer)
  • متد: POST
  • زمان اجرا: گزینه شروع تماس (pre_call) را انتخاب کنید.

تنظیم پارامتر ورودی (شماره تماس)

در کادر پارامترها (JSON Schema)، پارامتر شماره تلفن را وارد کنید:

{
  "type": "object",
  "properties": {
    "phone": {
      "type": "string",
      "description": "شماره موبایل مشتری (مثال: 09123456789)"
    }
  },
  "required": ["phone"]
}

تست اتصال و ذخیره

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


گام ۳: فعال‌سازی در اپراتور صوتی

پس از ساخت ابزار:

  1. از منوی کناری به بخش اپراتورها رفته و اپراتور مدنظر خود را ویرایش کنید.
  2. در بخش ابزارهای متصل، تیک ابزار استعلام اطلاعات مشتری از CRM را روشن کنید.
  3. در کادر دستورالعمل (پرامپت) اپراتور بنویسید:

    «به محض شروع تماس، اطلاعات دریافت شده از ابزار CRM را بررسی کن. اگر نام مشتری مشخص بود، سلام گرم کن و او را با نام صدا بزن.»

  4. ذخیره کنید. کار تمام است!

(اختیاری) ثبت خلاصه مکالمه در CRM پس از قطع تماس

اگر می‌خواهید هوش مصنوعی بعد از پایان هر تماس، خلاصه مکالمه انجام‌شده را هم در CRM شما ثبت کند:

یک ابزار دوم با مشخصات زیر بسازید:

  • نام ابزار: save_call_summary
  • عنوان: ثبت خلاصه مکالمه در CRM
  • آدرس: آدرس ذخیره‌سازی در CRM شما (مثلاً https://crm.yourcompany.com/api/save-call)
  • زمان اجرا: گزینه پایان تماس (post_call)
  • پارامترها:
{
  "type": "object",
  "properties": {
    "phone": {
      "type": "string",
      "description": "شماره تماس مشتری"
    },
    "summary": {
      "type": "string",
      "description": "خلاصه مکالمه و توافقات انجام‌شده"
    }
  },
  "required": ["phone", "summary"]
}

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