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

پیش‌نیازها

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

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

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

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

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

ثبت نام به عنوان همکار

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

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

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

  4. شرایط خدمات پیام‌های تجاری را بررسی و بپذیرید.

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

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

اکنون به APIهای پیام‌های تجاری و ارتباطات تجاری دسترسی دارید.

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

  1. در صفحه اصلی کنسول توسعه‌دهندگان ارتباطات تجاری ، روی تنظیمات حساب همکار کلیک کنید.
  2. در نوار ناوبری سمت چپ، روی حساب سرویس (Service account) کلیک کنید.

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

    مرورگر شما کلید حساب سرویس را دانلود می‌کند. آن را در یک مکان امن ذخیره کنید. بعداً برای استقرار یک برنامه وب و دسترسی به APIهای پیام‌های تجاری و ارتباطات تجاری به این کلید نیاز خواهید داشت.

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

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

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

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

با ربات کمکی پیام‌های تجاری، ویژگی‌های آن را بررسی کنید

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

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

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

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

شروع مکالمه با ربات کمکی

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

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

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

    • روی دکمه اندروید یا دکمه iOS کلیک کنید. سپس کد QR را با دستگاه همراه مربوطه اسکن کنید و روی راه‌اندازی کلیک کنید. همچنین، می‌توانید روی کپی URL اندروید یا کپی URL iOS کلیک کنید تا URL آزمایشی عامل کپی شود.
    • برای ارسال آدرس‌های اینترنتی به آدرس ایمیل شما ، روی ارسال کلیک کنید.

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

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

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

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

  1. کنسول توسعه‌دهنده ارتباطات تجاری را باز کنید.
  2. نماینده خود را انتخاب کنید.
  3. در نوار ناوبری سمت چپ، روی «یکپارچه‌سازی‌ها» کلیک کنید.
  4. برای ربات کمکی ، روی غیرفعال کردن کلیک کنید.

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

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

در این راهنما، شما یک Echo Bot را به همراه یک webhook که برای پردازش پیام‌های کاربر طراحی شده است، در پلتفرم ابری گوگل (GCP) مستقر خواهید کرد.

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

مراحل زیر را انجام خواهید داد:

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

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

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

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

ایجاد یک محیط ابری

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

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

  1. انتخابگر پروژه کنسول ابری گوگل را باز کنید.

    اگر تا به حال پروژه‌ای در گوگل کلود ایجاد نکرده‌اید، باید شرایط و ضوابط را بپذیرید .

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

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

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

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

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

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

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

  8. یک حساب صورتحساب جدید ایجاد کنید یا یک حساب صورتحساب موجود را به پروژه اضافه کنید. برای آشنایی با گزینه‌های پرداخت، به «ویژگی‌های برنامه رایگان گوگل کلود» مراجعه کنید.

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

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

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

  3. فایل اعتبارنامه‌های JSON که در بخش «ایجاد حساب کاربری سرویس» دانلود کرده‌اید را در پوشه منابع نمونه کپی کنید و نام اعتبارنامه‌ها را به «bm-agent-service-account-credentials.json» تغییر دهید. مسیر این فایل اعتبارنامه‌ها به نمونه‌ای که دانلود کرده‌اید بستگی دارد.

    نود جی اس 

    ./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. برای نصب نمونه، دستورات زیر را در ترمینال اجرا کنید:

    نود جی اس 

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

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

    جاوا 

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

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

    پایتون 

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

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

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

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

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

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

  1. تنظیمات حساب کاربری را در کنسول توسعه‌دهندگان ارتباطات تجاری باز کنید.
  2. مطمئن شوید که حساب همکار درست انتخاب شده است.
  3. برای آدرس وب هوک پیام‌های تجاری ، روی پیکربندی کلیک کنید.

  4. برای Webhook endpoint URL ، آدرس اینترنتی برنامه خود را به همراه "/callback" وارد کنید.

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

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

  5. در کنسول توسعه‌دهندگان، روی تأیید کلیک کنید.

    وقتی Business Messages وب‌هوک شما را تأیید کرد، پنجره بسته می‌شود.

برای پیکربندی وب‌هوک خود با رابط برنامه‌نویسی کاربردی ارتباطات تجاری (Business Communications API)، به مثال: به‌روزرسانی آدرس وب‌هوک (Webhook URL) مراجعه کنید.

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

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

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

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

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

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

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

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

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

  1. کنسول توسعه‌دهنده ارتباطات تجاری را باز کنید.
  2. در نوار ناوبری سمت چپ، روی اطلاعات نماینده کلیک کنید.
  3. در قسمت URL های تست عامل ، روی دکمه Android یا دکمه iOS کلیک کنید.

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

    همچنین می‌توانید روی ارسال کلیک کنید تا آدرس‌های اینترنتی به آدرس ایمیل شما ارسال شوند.

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

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

مراحل بعدی

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