اولین نماینده خود را ایجاد کنید

پیش نیازها

نماینده خود را ایجاد کنید

این راهنما شما را با نحوه ایجاد یک عامل با استفاده از یک برنامه نمونه آشنا می کند. نمونه یک راه سریع برای کشف عملکرد یک عامل ارائه می دهد و می تواند به عنوان نقطه شروعی برای توسعه عامل شما باشد. اگر می خواهید یک برنامه موجود را تغییر دهید تا یک عامل را شامل شود، نمونه مدل خوبی برای منطق برنامه شما ارائه می دهد.

در این شروع سریع، کارهای زیر را انجام خواهید داد:

  • به عنوان شریک ثبت نام کنید
  • یک برند و یک نماینده ایجاد کنید
  • به صورت اختیاری، ویژگی‌ها را در مکالمه با ربات Helper Messages Business کاوش کنید
  • نماینده خود را برای ارسال و دریافت پیام تنظیم کنید

برای ایجاد یک عامل بدون استفاده از نمونه، به ایجاد عامل خود مراجعه کنید.

به عنوان شریک ثبت نام کنید

  1. کنسول توسعه دهنده Business Communications را باز کنید.
  2. در بخش پیام‌های تجاری ، روی ایجاد حساب شریک کلیک کنید.

  3. اطلاعات شریک خود را وارد کنید:

    میدان ارزش
    نام شما نام کامل شما
    نام شریک نام سازمان شما
    وب سایت شریک وب سایت سازمان شما
    منطقه منطقه ای که می خواهید میزبان سرویس پیام های تجاری باشد

  4. شرایط خدمات Business Messages را بررسی کرده و بپذیرید.

  5. روی ایجاد کلیک کنید.

شما اکنون به عنوان شریک Business Messages ثبت نام کرده اید. یک پروژه Google Cloud جدید برای شما ایجاد شده است که APIهای Business Messages و Business Communications فعال است. شما به این پروژه دسترسی ندارید و با هیچ یک از پروژه های Google Cloud موجود شما تداخلی نخواهد داشت.

اکنون به APIهای Business Messages و Business Communications دسترسی دارید.

یک حساب کاربری ایجاد کنید

  1. در صفحه اصلی Business Communications Developer Console ، روی تنظیمات حساب شریک کلیک کنید.
  2. در پیمایش سمت چپ، روی حساب سرویس کلیک کنید.

  3. روی ایجاد کلید کلیک کنید، سپس روی ایجاد کلیک کنید.

    مرورگر شما کلید حساب سرویس را دانلود می کند. آن را در مکانی امن ذخیره کنید. بعداً برای استقرار یک برنامه وب و دسترسی به Business Messages و Business Communications API در آینده به این کلید نیاز خواهید داشت.

یک برند و یک نماینده ایجاد کنید

یک نماینده نمایش مکالمه ای از یک نام تجاری است - موجودیت مکالمه ای که کاربران با آن تعامل دارند. شما یک نام تجاری برای نمایندگی کسب و کار ایجاد می کنید و یک نماینده ایجاد می کنید تا مشتریان بتوانند به صورت مکالمه با آن ارتباط برقرار کنند.

  1. کنسول توسعه دهنده Business Communications را باز کنید و با حساب Google Business Messages خود وارد شوید.
  2. روی ایجاد عامل کلیک کنید.
  3. برای نوع نماینده ، Business Messages را انتخاب کنید.
  4. مقادیر نام تجاری و نام نماینده را وارد کنید.
  5. یکی از کارهای زیر را انجام دهید:
    • برای تجربه مکالمه با نماینده خود که در آن می‌توانید ویژگی‌های موجود را کاوش کنید، فعال کردن ربات راهنمای پیام‌های تجاری را انتخاب کنید.
    • برای سفارشی کردن نماینده خود و آماده کردن آن برای مدیریت پیام، فعال کردن ربات راهنمای پیام های تجاری را از حالت انتخاب خارج کنید.
  6. روی ایجاد عامل کلیک کنید.

اگر ربات کمکی پیام‌های تجاری را فعال کرده باشید، می‌توانید بلافاصله مکالمه را شروع کنید . در غیر این صورت، اقدام به تنظیم نماینده خود برای مدیریت پیام کنید .

با ربات Helper Messages Business ویژگی ها را کاوش کنید

ربات Helper Messages به شما امکان می دهد به سرعت با نماینده خود گفتگو کنید تا بتوانید آنچه را که این پلتفرم ارائه می دهد تجربه کنید. فعال کردن Helper Bot اختیاری است اما هنگام ایجاد اولین نماینده خود بسیار توصیه می شود.

ربات Helper به شما این امکان را می دهد

  • ویژگی های غنی را کاوش کنید
  • نحوه پیاده سازی ویژگی ها را بیاموزید
  • منابعی را برای تنظیم عامل پیدا کنید

هنگامی که Helper Bot فعال باشد، پیام هایی را برای نماینده شما ارسال و دریافت می کند. نیازی به وب هوک نیست قبل از اینکه بتوانید یک وب هوک تنظیم کنید یا Dialogflow را برای مدیریت پیام های کاربر فعال کنید، باید Helper Bot را غیرفعال کنید .

مکالمه را با Helper Bot شروع کنید

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

برای تعامل با Helper Bot، مراحل زیر را از این گفتگو انجام دهید:

  1. به URL های آزمایشی نماینده دسترسی پیدا کنید. چند راه برای انجام این کار وجود دارد:

    • روی دکمه اندروید یا دکمه iOS کلیک کنید. سپس کد QR را با دستگاه تلفن همراه مربوطه اسکن کرده و روی راه‌اندازی کلیک کنید. یا روی Copy URL Android یا Copy URL iOS کلیک کنید تا URL آزمایشی نماینده را کپی کنید.
    • برای ارسال URL ها به آدرس ایمیل شما روی Send کلیک کنید.

  2. URL را در دستگاه تلفن همراه خود باز کنید. (دستگاه‌های iOS به برنامه Google Maps نیاز دارند.)

ربات Helper را غیرفعال کنید

قبل از اینکه بتوانید نماینده خود را سفارشی کنید و آن را برای راه اندازی آماده کنید، باید ربات Helper Messages را غیرفعال کنید.

برای غیرفعال کردن Helper Bot،

  1. کنسول توسعه دهنده Business Communications را باز کنید.
  2. نماینده خود را انتخاب کنید
  3. در پیمایش سمت چپ، روی Integrations کلیک کنید.
  4. برای Helper Bot ، روی Disable کلیک کنید.

وقتی Helper Bot غیرفعال باشد، دیگر برای نماینده شما پیامی ارسال و دریافت نمی کند. اکنون می توانید نماینده خود را برای مدیریت جریان پیام تنظیم کنید.

نماینده خود را برای مدیریت پیام تنظیم کنید

در این راهنما، یک ربات اکو را در پلتفرم Google Cloud (GCP) با یک هوک طراحی شده برای پردازش پیام های کاربر مستقر خواهید کرد.

Echo Bot یک نمونه برنامه کاربردی است که پیام ها را به کاربر بازتاب می دهد. این به شما امکان می‌دهد در گفتگو با نماینده خود، ویژگی‌های غنی، مانند اقدامات پیشنهادی و کارت‌های غنی را آزمایش کنید. همچنین می توانید از Echo Bot به عنوان نقطه شروعی برای توسعه نماینده خود استفاده کنید.

شما مراحل زیر را تکمیل خواهید کرد:

  • نمونه Echo Bot را در GCP مستقر کنید
  • URL webhook را برای حساب شریک Business Messages خود پیکربندی کنید
  • اطلاعات اولیه در مورد نماینده خود ارائه دهید

در پایان این راهنما، نماینده شما آماده ارسال و دریافت پیام خواهد بود.

برنامه وب را در GCP مستقر کنید

Business Messages پیام‌های کاربران را به یک وب هوک در زیرساخت شما ارسال می‌کند. در این راهنما، کد منبع نمونه Echo Bot را در یک وب هوک از پیش پیکربندی شده مستقر خواهید کرد. اگر از قبل زیرساخت وب برای استفاده برای دریافت پیام ها دارید، می توانید یک وب هوک جدید در آن وب سرویس ایجاد کنید، اما باید خودتان منطق را پیکربندی کنید. برای جزئیات بیشتر به تنظیم وب هوک در سطح شریک خود مراجعه کنید.

یک محیط Cloud ایجاد کنید

برای استقرار نمونه Echo Bot به یک محیط ابری نیاز دارید.

برای ایجاد یک پروژه GCP به عنوان یک محیط ابری، مراحل زیر را دنبال کنید:

  1. انتخابگر پروژه Google Cloud Console را باز کنید.

    اگر هرگز پروژه Google Cloud ایجاد نکرده‌اید، باید شرایط و خدمات را بپذیرید .

  2. روی ایجاد پروژه کلیک کنید.

  3. یک نام و مکان برای پروژه جدید خود وارد کنید

    • شناسه پروژه شما به طور خودکار ایجاد می شود و در زیر نام پروژه شما ظاهر می شود.
    • در قسمت Location ، روی Browse کلیک کنید تا مکان های احتمالی پروژه شما نمایش داده شود. اگر نمی‌توانید سازمان Google Workspace خود را پیدا کنید، پس به حساب Google Workspace وارد نشده‌اید. شما می توانید یک پروژه بدون سازمان ایجاد کنید، اما برخی از ویژگی ها محدود هستند. برای اطلاعات بیشتر به مزایای منبع سازمان مراجعه کنید.

  4. روی ایجاد کلیک کنید.

  5. روی منو کلیک کنید.

  6. روی صورتحساب کلیک کنید.

  7. روی پیوند یک حساب صورتحساب کلیک کنید.

  8. یک حساب صورتحساب جدید ایجاد کنید یا یک حساب صورتحساب موجود را به پروژه اضافه کنید. برای درک گزینه های پرداخت، به ویژگی های برنامه رایگان Google Cloud مراجعه کنید.

نمونه Echo Bot را مستقر کنید

  1. gcloud CLI را نصب کنید. از این برای استقرار کد نمونه در Google Cloud استفاده خواهید کرد.

  2. نمونه Echo Bot را دانلود و استخراج کنید ( Node.js ، Java ، Python ).

  3. فایل اعتبار JSON را که در Create a service account دانلود کرده اید در پوشه منابع نمونه کپی کنید و نام اعتبارنامه را به "bm-agent-service-account-credentials.json" تغییر دهید. مسیر این فایل اعتبارنامه به نمونه ای که دانلود کرده اید بستگی دارد.

    Node.js 

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    جاوا 

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    پایتون

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. در یک ترمینال، به دایرکتوری full_sample نمونه بروید.

  5. برای استقرار نمونه دستورات زیر را در ترمینال اجرا کنید:

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID شناسه پروژه پروژه ای است که در ایجاد محیط ابری ایجاد کرده اید. شناسه پروژه در داشبورد پروژه در Google Cloud فهرست شده است.

    جاوا

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID شناسه پروژه پروژه ای است که در ایجاد محیط ابری ایجاد کرده اید. شناسه پروژه در داشبورد پروژه در Google Cloud فهرست شده است.

    پایتون

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID شناسه پروژه پروژه ای است که در ایجاد محیط ابری ایجاد کرده اید. شناسه پروژه در داشبورد پروژه در Google Cloud فهرست شده است.

  6. در خروجی آخرین دستور، به URL برنامه مستقر شده توجه کنید. این پایه URL وب هوک شما است:

    Deployed service [default] to [https:// PROJECT_ID .appspot.com]

وب هوک خود را تنظیم کنید

اکنون که Echo Bot مستقر شده است، برای شروع دریافت پیام ها باید یک URL webhook را مشخص کنید.

  1. تنظیمات حساب را در Business Communications Developer Console باز کنید.
  2. مطمئن شوید که حساب شریک صحیح انتخاب شده است.
  3. برای نشانی اینترنتی وب هوک پیام‌های تجاری ، روی پیکربندی کلیک کنید.

  4. برای URL نقطه پایانی Webhook ، URL برنامه + "/callback" را وارد کنید.

    نقطه پایانی شما از قالب پیروی می کند: "https:// PROJECT_ID .appspot.com/callback".

    این نقطه پایانی در منطق کاربردی نمونه ای که در GCP مستقر کرده اید از پیش تعریف شده است.

  5. در Developer Console، روی تأیید کلیک کنید.

    هنگامی که Business Messages وب هوک شما را تأیید می کند، کادر گفتگو بسته می شود.

برای پیکربندی webhook خود با Business Communications API، به مثال مراجعه کنید: URL webhook را به‌روزرسانی کنید .

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

اطلاعات نماینده را وارد کنید

برخی از اطلاعات اولیه را برای تکمیل تنظیمات نماینده خود ارائه دهید.

  1. کنسول توسعه دهنده Business Communications را باز کنید.
  2. در پیمایش سمت چپ، روی اطلاعات نماینده کلیک کنید.

  3. مقادیر را هر طور که دوست دارید به روز کنید یا از پیشنهادات زیر استفاده کنید:

    میدان ارزش
    پیام خوش آمد گویی به گفتگوی Echo Bot خوش آمدید!
    سیاست حفظ حریم خصوصی https://policies.google.com/privacy

  4. روی ذخیره کلیک کنید.

گفتگو را شروع کنید

برای تعامل با Echo Bot، مراحل زیر را دنبال کنید:

  1. کنسول توسعه دهنده Business Communications را باز کنید.
  2. در پیمایش سمت چپ، روی اطلاعات نماینده کلیک کنید.
  3. در بخش نشانی‌های اینترنتی آزمایشی نماینده ، روی دکمه Android یا دکمه iOS کلیک کنید.

  4. کد QR را با دستگاه تلفن همراه مربوطه اسکن کنید، یا روی Copy URL Android یا Copy URL iOS کلیک کنید تا URL آزمایشی نماینده را کپی کنید.

    همچنین می توانید برای ارسال URL ها به آدرس ایمیل خود بر روی Send کلیک کنید.

  5. URL را در دستگاه تلفن همراه خود باز کنید. (دستگاه‌های iOS به برنامه Google Maps نیاز دارند.)

پیام خوش آمد گویی نماینده شما به شما خوشامد می گوید. در این مرحله، می توانید با ربات اکو تعامل کنید. پیام هایی را که برایتان ارسال می کنید بازتاب می دهد. علاوه بر این، می‌توانید ویژگی‌های غنی را با ارسال رشته‌های خاص فراخوانی کنید: "چرخ فلک"، "کارت"، "تراشه".

مراحل بعدی

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