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

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

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

در دسترس بودن ربات و انسان

شما می‌توانید دسترسی جداگانه به نماینده ربات و نماینده انسانی را مشخص کنید.

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

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

اگر نمایندگان ربات ۲۴ ساعته در دسترس هستند اما نمایندگان انسانی از ساعت ۸ صبح تا ۸ شب در دسترس هستند، می‌توانید آنها را به طور مستقل مشخص کنید.

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

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

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

وقتی این فیلدها را به‌روزرسانی می‌کنید، باید مقادیر همه فیلدها را در شیء SupportedAgentInteraction وارد کنید. درخواست‌های به‌روزرسانی، محتوای همه فیلدهایی را که ویرایش می‌کنید، از جمله فیلدهای فرزند، بازنویسی می‌کنند. برای مثال، اگر درخواستی برای اضافه کردن یک نمونه به hours ارسال می‌کنید، باید تمام نمونه‌های hours قبلی را نیز وارد کنید، در غیر این صورت به‌روزرسانی شما آنها را بازنویسی می‌کند.

پیش‌نیازها

قبل از به‌روزرسانی قابلیت دسترسی به پیام‌ها، به موارد زیر نیاز دارید:

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

  • name نماینده (برای مثال، "brands/12345/agents/67890")

    اگر name نماینده را نمی‌دانید، به فهرست همه نمایندگان یک برند مراجعه کنید.

  • مناطق زمانی در دسترس بودن ربات، روزهای هفته و ساعات کاری

  • مناطق زمانی در دسترس بودن انسان، روزهای هفته و ساعات

اگر مقادیر فعلی primaryAgentInteraction و additionalAgentInteractions را نمی‌دانید، به بخش Get agent information مراجعه کنید.

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

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

اگر هم به ربات و هم به انسان پیام‌رسانی می‌کنید، در دسترس بودن ربات را در primaryAgentInteraction و در دسترس بودن انسان را در نمونه‌ای از additionalAgentInteractions مشخص کنید.

ربات و انسان 

# This code updates the agent interaction of a bot and human representatives.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction,businessMessagesAgent.additionalAgentInteractions" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "BOT",
      "botRepresentative": {
        "botMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    },
    "additionalAgentInteractions": [
      {
        "interactionType": "HUMAN",
        "humanRepresentative": {
          "humanMessagingAvailability": {
            "hours": [
              {
                "startTime": {
                  "hours": 8,
                  "minutes": 0
                },
                "endTime": {
                  "hours": 20,
                  "minutes": 0
                },
                "timeZone": "America/Los_Angeles",
                "startDay": "MONDAY",
                "endDay": "SUNDAY"
              }
            ]
          }
        }
      }
    ]
  }
}'

فقط ربات

# This code updates the primary agent interaction of a bot representative
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "BOT",
      "botRepresentative": {
        "botMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    }
  }
}'

فقط انسان

# This code updates the primary agent interaction of a human representative
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/brands.agents/patch

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

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/__BRAND_ID__/agents/__AGENT_ID__?updateMask=businessMessagesAgent.primaryAgentInteraction" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "businessMessagesAgent": {
    "primaryAgentInteraction": {
      "interactionType": "HUMAN",
      "humanRepresentative": {
        "humanMessagingAvailability": {
          "hours": [
            {
              "startTime": {
                "hours": 20,
                "minutes": 0
              },
              "endTime": {
                "hours": 8,
                "minutes": 0
              },
              "timeZone": "America/Los_Angeles",
              "startDay": "MONDAY",
              "endDay": "SUNDAY"
            }
          ]
        }
      }
    }
  }
}'

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