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

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

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

توفُّر برنامج التتبُّع وفريق العمل

يمكنك تحديد برنامج تتبُّع ومنفصل الممثِّل مدى التوفر.

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

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

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

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

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

لتعديل مدى توفّر ميزة المراسلة، عليك تقديم طلب تصحيح مع النشاط التجاري. Communications API لتعديل primaryAgentInteraction للوكيل حقلان (additionalAgentInteractions)

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

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

قبل تعديل مدى توفّر ميزة المراسلة، ستحتاج إلى العناصر التالية:

  • المسار إلى مفتاح حساب خدمة مشروع Google Cloud Platform في جهاز التطوير

  • الوكيل 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