ضبط مدى توفّر المراسلة

قبل أن يتمكّن المستخدمون من بدء محادثات مع وكيلك، عليك ضبط إعدادات توفّر المراسلة للوكيل في "الرسائل التجارية".

إذا أرسل مستخدم رسالة إلى موظّف الدعم خلال ساعات العمل المتاحة، سيرحّب موظّف الدعم بالمستخدم بإرسال رسالة ترحيب وبدء المحادثة. إذا بدأت المحادثة خارج ساعات التوفّر، ستظهر للمستخدمين رسالة عدم توفّر الوكيل. يمكنك الاطّلاع على بدء المحادثة للحصول على مزيد من المعلومات حول هذه الرسائل.

مدى توفّر الروبوتات والموظفين

يمكنك تحديد مدى توفّر الروبوتات والموظفين المباشرين بشكل منفصل.

إذا كان لديك أي نوع من التشغيل الآلي الذي ينشئ رسائل نيابةً عن وكيلك، سواء كان برنامجًا للردّ التلقائي يخبر المستخدمين بمكانهم في قائمة الانتظار، أو برنامجًا معقّدًا لفهم اللغات الطبيعية يتيح الوصول الديناميكي إلى تفاصيل المستخدمين، أو أي شيء بينهما، عليك تحديد مدى توفّر الرسائل التي يرسلها روبوت الدردشة.

يجب أن يكون هناك فريق دعم متاح إذا أردت إطلاق وكيل على نقاط دخول تديرها Google، بما في ذلك نقاط الدخول المستندة إلى الموقع الجغرافي ونقاط الدخول غير المحلية (باستثناء "إعلانات Google"). بالنسبة إلى مدى توفّر الموظفين، حدِّد فقط أيام الأسبوع والساعات التي يتوفّر فيها موظفون مباشرون للإجابة عن الأسئلة.

إذا كان ممثّلو برامج الدردشة المبرمَجة متاحين على مدار 24 ساعة في اليوم، بينما يتوفّر الممثّلون من البشر من الساعة 8 صباحًا إلى الساعة 8 مساءً، يمكنك تحديد هذه المواعيد بشكل مستقل.

بالإضافة إلى ذلك، إذا حدّدت توفّر كل من الموظفين الآليين والموظفين البشريين، يمكنك إرسال اقتراحات طلبات التحدث مع موظفين مباشرين لتشجيع المستخدمين على طلب التحدث مع موظفين مباشرين إذا لم يتمكّن الموظفون الآليون من تلبية احتياجاتهم.

تعديل مدى توفّر ميزة المراسلة

لتعديل مدى توفّر المراسلة، يمكنك إرسال طلب PATCH باستخدام Business Communications API لتعديل الحقلَين primaryAgentInteraction وadditionalAgentInteractions الخاصَين بأحد وكلاء الدعم.

عند تعديل هذه الحقول، يجب تضمين قيم لجميع الحقول في عنصر SupportedAgentInteraction. تؤدي طلبات التعديل إلى استبدال محتوى جميع الحقول التي تعدّلها، بما في ذلك أي حقول فرعية. على سبيل المثال، إذا أرسلت طلبًا لإضافة مثيل إلى hours، عليك تضمين جميع مثيلات hours السابقة أيضًا، وإلا سيؤدي التعديل إلى استبدالها.

المتطلبات الأساسية

قبل تعديل إعدادات توفّر الرسائل، يجب توفّر ما يلي:

  • مسار مفتاح حساب الخدمة لمشروعك على Google Cloud Platform (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"
              }
            ]
          }
        }
      }
    ]
  }
}'

الروبوت فقط 

# 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.