با Business Messages ثبت نام کنید

وقتی به عنوان شریک در Business Messages ثبت نام می‌کنید، می‌توانید مکالمات بین کاربران و مارک‌ها را با ایجاد نمایندگان فعال کنید - نهادهای مکالمه‌ای که عملکردهای تجاری را نشان می‌دهند، مانند پشتیبانی وب‌سایت، و مکان‌های برند.

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

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

با ثبت نام به‌عنوان شریک در Business Messages، ایجاد نمایندگی‌هایی برای برندها، و استفاده از APIهایی که عامل شما را تقویت می‌کنند، می‌توانید تجربه‌های پیام‌رسانی را برای خدمات مشتری، فروش و سایر برنامه‌های تجاری فعال کنید.

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

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

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

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

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

اکنون به عنوان شریک Business Messages ثبت نام کرده اید و به API های Business Messages و Business Communications دسترسی دارید. Business Messages API برای کاربران پیام می فرستد، در حالی که Business Communications API نمایندگان را مدیریت می کند.

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

برای احراز هویت ایمن تماس‌های API به APIهای Business Messages و Business Communications، به یک کلید حساب سرویس و ابزار خط فرمان oauth2l نیاز دارید.

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

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

    مرورگر شما کلید حساب سرویس را دانلود می کند. کلید حساب سرویس خود را در مکانی امن و خصوصی ذخیره کنید. کلید خود را به صورت عمومی به اشتراک نگذارید. بعداً برای دسترسی به APIهای Business Message و Business Communication به این کلید نیاز خواهید داشت.

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

اکنون که Business Messages and Business Communications API فعال است، باید URL webhook خود را برای شروع دریافت پیام ها مشخص کنید.

  1. تنظیمات حساب را در Business Communications Developer Console باز کنید.
  2. مطمئن شوید که حساب شریک صحیح انتخاب شده است.
  3. برای نشانی اینترنتی وب هوک پیام‌های تجاری ، روی پیکربندی کلیک کنید.
  4. برای URL نقطه پایانی Webhook ، نشانی اینترنتی وب هوک خود را وارد کنید که با "https://" شروع می شود.
  5. به ارزش clientToken خود توجه کنید. برای تأیید اینکه پیام‌هایی که دریافت می‌کنید از Google ارسال می‌شوند به آن نیاز دارید.

  6. وب هوک خود را طوری پیکربندی کنید که درخواست POST را با پارامتر clientToken مشخص شده بپذیرد و یک پاسخ 200 OK با مقدار متن ساده پارامتر secret به عنوان بدنه پاسخ ارسال کند.

    به عنوان مثال، اگر وب هوک شما یک درخواست POST با محتوای بدنه زیر دریافت کند

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    وب هوک شما باید مقدار clientToken را تأیید کند و اگر clientToken درست باشد، یک پاسخ 200 OK با 0123456789 به عنوان بدنه پاسخ برگرداند.

  7. در کنسول، روی تأیید کلیک کنید.

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

به مثال مراجعه کنید: URL webhook را به‌روزرسانی کنید تا ببینید چگونه وب‌هوک خود را با APIهای ارتباط تجاری پیکربندی کنید.

اطلاعات شریک را دریافت کنید

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

دستور زیر را اجرا کنید. شناسه شریک خود را جایگزین PARTNER_ID کنید.


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
get-partner.sh

اطلاعات شریک را به روز کنید

برای به روز رسانی اطلاعات شریک خود، می توانید از صفحه تنظیمات حساب در Business Communications Developer Console استفاده کنید یا دستورات زیر را اجرا کنید.

PARTNER_ID را با شناسه شریک خود جایگزین کنید (شناسه شریک را می‌توانید در کنسول برنامه‌نویس ارتباطات کسب و کار پیدا کنید)، و نام فیلدهایی را که به‌روزرسانی می‌کنید جایگزین UPDATED_FIELDS کنید.


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'
update-partner.sh

برای گزینه‌های قالب‌بندی و مقدار، به partners.patch مراجعه کنید.

مثال: نام نمایشی را به روز کنید

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

مثال: URL webhook را به روز کنید

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

مراحل بعدی

اکنون که یک شریک ثبت‌شده هستید و APIها را فعال کرده‌اید، می‌توانید با Business Messages شروع به توسعه کنید. برای شروع سریع، به ایجاد اولین نماینده خود مراجعه کنید.

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