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

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

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

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

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

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

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

اگر نمایندگان ربات 24 ساعته در دسترس هستند اما نمایندگان انسانی از ساعت 8 صبح تا 8 بعد از ظهر در دسترس هستند، می توانید آن ها را به طور مستقل مشخص کنید.

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

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

برای به‌روزرسانی در دسترس بودن پیام، یک درخواست PATCH با Business Communications API برای به‌روزرسانی primaryAgentInteraction و additionalAgentInteractions AgentInteractions یک نماینده ارائه می‌کنید.

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

پیش نیازها

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

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

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

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

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

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

اگر مقادیر primaryAgentInteraction و additionalAgentInteractions های فعلی را نمی دانید، به دریافت اطلاعات عامل مراجعه کنید.

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

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

اگر هم دسترسی به ربات و هم پیام انسانی دارید، در دسترس بودن ربات را در primaryAgentInteraction و در دسترس بودن انسان را در نمونه ای از AdditionalAgentInteractions 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"
              }
            ]
          }
        }
      }
    ]
  }
}'
update-agent-bm-agentInteractions-bot-and-human.sh

فقط ربات


# 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"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-bot.sh

فقط انسان


# 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"
            }
          ]
        }
      }
    }
  }
}'
update-agent-bm-agentInteractions-human.sh

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