הגדרת הזמינות להעברת הודעות

כדי שהמשתמשים יוכלו להתחיל שיחות עם הנציג שלך, צריך להגדיר את זמינות ההודעות של נציג ב-Business Messages.

אם משתמש שולח הודעה לנציג בשעות הזמינות, הוא יענה באמצעות הודעת פתיחה והתחלת שיחה. אם השיחה מתחילה מחוץ לשעות הפעילות, המשתמשים יראו את ההודעה של הנציג ללא חיבור לאינטרנט. להצגת התחלה ה שיחה לקבלת מידע נוסף על ההודעות האלה.

בוטים וזמינות אנושית

אפשר לציין בנפרד בוט ובודק אנושי ייצוגי זמינות.

אם יש סוג של אוטומציה שכותבת הודעות עבור – האם האוטומציה היא משיב אוטומטי שאומר למשתמשים את מקומם בתור סוכן מורכב של הבנת שפה טבעית (NLP), בעל גישה דינמית פרטי המשתמש, או כל דבר שביניהם – צריך לציין את הזמינות של העברת הודעות לבוט.

חובה להשתמש בזמינות אנושית אם רוצים להפעיל נציג תמיכה בניהול Google נקודות כניסה, כולל נקודות כניסה לפי מיקום נקודות כניסה לא מקומיות (מלבד Google Ads). כשמדובר בזמינות אנושית, יש לציין רק את הימים בשבוע ואת השעות שבהם יש נציגים זמינים לענות על שאלות.

אם נציגי הבוטים זמינים 24 שעות ביממה אבל נציגים אנושיים זמינים מ-8:00 עד 20:00. אפשר לציין באופן עצמאי.

בנוסף, אם תציינו זמינות של בוט וזמינות אנושית, יכול לשלוח בקשה לנציג תמיכה אנושי הצעות כדי לבקש ממשתמשים לבקש נציגים פעילים אם נציגי הבוט לא יכולים למלא לצרכים שלהם.

עדכון הזמינות של העברת הודעות

כדי לעדכן את הזמינות של העברת ההודעות, צריך לשלוח בקשת PATCH מהעסק Communications API לעדכון primaryAgentInteraction וגם של הנציג additionalAgentInteractions שדות.

כשמעדכנים את השדות האלה, צריך לכלול ערכים בכל השדות אובייקט supportedAgentInteraction. בקשות עדכון יחליפו את התוכן של כל בשדות שעורכים, כולל כל שדות הצאצא. לדוגמה, אם תשלחו בקשה כדי להוסיף מופע אל hours, צריך לכלול את כל הערכים של hours הקודמים גם כן, אחרת העדכון יחליף אותם.

דרישות מוקדמות

כדי שתוכלו לעדכן את הזמינות של העברת ההודעות, צריך את הפריטים הבאים:

  • נתיב למפתח חשבון השירות של פרויקט GCP במכונת הפיתוח

  • הסוכן name (לדוגמה, "brands/12345/agents/67890")

    לא יודעים מה name של הנציג? אפשר להיעזר במאמר רשימת כל הנציגים של מותג.

  • אזורי הזמן שבהם הבוטים זמינים, ימים בשבוע ושעות פעילות

  • אזורי זמן של זמינות אנושית, ימים בשבוע ושעות פעילות

אם הפרטים הנוכחיים של primaryAgentInteraction לא ידועים לך ערכים של additionalAgentInteractions זמינים במאמר קבלת נציג מידע.

שליחת הבקשה לעדכון

כדי לעדכן את הנציג, מריצים את הפקודה הבאה. החלפת משתנים בערכים שציינתם בדרישות המוקדמות.

אם יש לכם גם את הזמינות של הבוט וגם של הצ'אטים האנושיים, אתם צריכים לציין את הזמינות של הבוט. ב-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"
              }
            ]
          }
        }
      }
    ]
  }
}'
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