سنوقف ميزة "الرسائل التجارية من Google" نهائيًا في 31 يوليو 2024. يمكنك الاطّلاع على مزيد من المعلومات هنا.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تلقي الرسائل

بعد التسجيل في نشاط تجاري تطبيق "الرسائل" يمكنك تلقّي الرسائل نيابةً عن موظّف الدعم. يمكنك تلقّي الرسائل للعلامات التجارية التي تديرها بعد إنشاء إثبات الملكية الإطلاق لهذه العلامات التجارية.

عندما يرسِل عميل رسالة إلى أحد موظّفي الدعم الذي تُديره، فإنّ ميزة "الرسائل التجارية" لإرسال حمولة JSON إلى الرد التلقائي على الويب الذي يحتوي على العديد من المعرّفات ومحتوى الرسائل ومعلومات الموقع الجغرافي.

استخدام سجلات وحدة تحكّم المطوّرين في Business Communications لتصحيح أخطاء تسليم الرسائل.

التعامل مع الرسائل الواردة

تعتمد كيفية تعامل الوكيل مع الرسائل الواردة من المستخدمين والرد عليها بشكل كبير على منطق عملك. ومع ذلك، فإن الخطوات اللازمة للرد على المستخدم ورسالتك متسقة.

الإقرار بالرسالة

للإقرار برسالة تلقّاها الرد التلقائي على الويب، يجب عرض استجابة HTTP صالحة للرسائل المُرسَلة إلى ردّك التلقائي على الويب.

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

التأكّد من أنّ الرسالة واردة من Google

يجب التأكّد من أنّ Google أرسلت الرسالة قبل معالجة الرسالة. المحتوى.

للتأكّد من أنّ Google أرسلت رسالة تلقّيتها،

تحليل عنوان X-Goog-Signature للرسالة هذه عبارة عن تجزئة، نسخة بترميز base64 من حمولة نص الرسالة.
استخدام الرمز المميز للعميل (الذي تم عرضه عند تهيئة الردّ التلقائي على الويب) لإنشاء خوارزمية SHA512 HMAC لوحدات بايت حمولة الرسالة، يجب بترميز base64.

ملاحظة: إذا تلقيت مفتاح الشريك أثناء التسجيل لدى النشاط التجاري بالنسبة إلى الرسائل، استخدِم ذلك كمفتاح لخوارزمية SHA512 HMAC بدلاً من البرنامج الرمز المميز. في حال تعديل الرد التلقائي على الويب، استخدام الرمز المميّز للعميل للرسالة باستخدام الإعدادات الجديدة للرد التلقائي على الويب.
قارِن بين تجزئة X-Goog-Signature والتجزئة التي أنشأتها.
- في حال تطابق التجزئات، هذا يعني أنّك تأكّدت من أنّ Google أرسلت الرسالة.
- وفي حال عدم تطابق قيم التجزئة، تحقق من عملية التجزئة على نطاق . إذا كانت عملية التجزئة تعمل بشكل صحيح وتلقّيت التي تعتقد أنه تم إرسالها إليك عن طريق الاحتيال، الاتصال بنا (يجب توقيع باستخدام حساب Google على ميزة "الرسائل التجارية").

الاطّلاع على مثال على التحقق من الرسائل في مستودعات GitHub الخاصة بـ Echo Bots في Java Node.js، وPython.

تحديد اللغة

يتواصل المستخدمون من مواقع جغرافية متعددة وبالعديد من اللغات. رسائل النشاط التجاري يمثل احتياجات المستخدمين الإعدادات المفضّلة للّغة مع resolvedLocale حقلان (userDeviceLocale)، استنادًا إلى الأجهزة إعدادات اللغة. راجع الأقلمة المحلية.

توجيه الرسائل وإنشاء الردود بناءً على تعليقات المستخدمين كلما أمكن اللغة والتفضيلات.

توجيه الرسالة استنادًا إلى سياقها

يوضح سياق الرسالة نوع المعلومات التي قد يبحث عنها المستخدم. على سبيل المثال، إذا أرسل أحد المستخدمين رسالة تحتوي على placeId أرسلوا رسالة إلى موقع جغرافي معيّن (تم تحديد هويته من خلال placeId) أن يطرح أسئلة خاصة بالموقع. وبالمثل، إذا كانت الرسالة تحتوي على nearPlaceId، التي تحدد موقعًا جغرافيًا بالقرب من المستخدم، ويُحتمل أن يكون المستخدم يريد معرفة المعلومات الخاصة بالموقع، ولكن على الوكيل تأكيد موقع يريد المستخدم الدردشة معه قبل بدء المحادثة.

باستخدام معلومات سياق الرسالة، يمكنك توجيه الرسالة إلى الموقع الأفضل مناسب للرد:

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

تحديد نوع الرسالة التي أرسلها المستخدم

يمكن للمستخدمين إرسال ثلاثة أنواع من الرسائل:

الرسائل النصية هي ردود حرة.
تتضمن رسائل الصور عنوان URL موقَّعًا لصورة يرغب المستخدم في استخدامها. تم تحميله.
تتضمن رسائل الاقتراح بيانات الإبلاغ عن الإحالات الناجحة ونص الإجراء المقترَح أو الرد المُقترَح الذي نقر عليه المستخدم.

معالجة محتوى الرسالة

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

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

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

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

الرد على المستخدم

بعد أن يحدد الوكيل الرد الصحيح، سواء من خلال التشغيل الآلي أو موظّف دعم يقدّم خدمة مباشرة، فهو يرسل الرسالة ويواصل المحادثة مع المستخدم.

عند إنشاء ردّ، يجب مراعاة لغة المستخدم. يمكنك بالإضافة إلى ذلك يمكنك تخصيص الردود من خلال استرداد القيم من الكائن userInfo في كل منها. رسالة تتلقاها.

أنواع الرسائل

يوضّح الرمز التالي طريقة تلقّي وكيلك للرسائل.

للحصول على معلومات التنسيق والقيمة، راجع UserMessage

النص

يُعدّ النص العادي الطريقة الأكثر شيوعًا لردّ المستخدمين. تحتوي الرسائل النصية على بالتنسيق التالي.

{
  "agent": "brands/BRAND_ID/agents/AGENT_ID",
  "conversationId": "CONVERSATION_ID",
  "customAgentId": "CUSTOM_AGENT_ID",
  "requestId": "REQUEST_ID",
  "message": {
    "messageId": "MESSAGE_ID",
    "name": "conversations/CONVERSATION_ID/messages/MESSAGE_ID",
    "text": "MESSAGE_TEXT",
    "createTime": "MESSAGE_CREATE_TIME",
  },
  "dialogflowResponse": {
    "autoResponded": "BOOLEAN",
    "faqResponse": {
      "userQuestion": "USER_QUESTION",
      "answers": [{
        "faqQuestion": "FAQ_QUESTION",
        "faqAnswer": "FAQ_ANSWER",
        "matchConfidenceLevel": "CONFIDENCE_LEVEL",
        "matchConfidence": "CONFIDENCE_NUMERIC",
      }],
    },
  },
  "context": {
    "entryPoint": "CONVERSATION_ENTRYPOINT",
    "placeId": "LOCATION_PLACE_ID",
    "resolvedLocale": "MATCH_OF_USER_AND_AGENT_LOCALES",
    "userInfo": {
      "displayName": "USER_NAME",
      "userDeviceLocale": "USER_LOCALE",
    },
  },
  "sendTime": "SEND_TIME",
}

للحصول على خيارات التنسيق والقيمة، يمكنك الاطّلاع على Message

صورة

بالإضافة إلى إرسال الرسائل النصية، يمكن للمستخدمين إرسال صور إلى وكيلك كرسائل. تخزِّن ميزة "الرسائل التجارية" الصور المشترَكة لمدة 7 أيام على موقَّعة. عناوين URL وتشمل عناوين URL هذه في الحقل text من حمولة الرسالة.

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

...
"message": {
    "text": "https://storage.googleapis.com/business-messages-us/936640919331/jzsu6cdguNGsBhmGJGuLs1DS?x-goog-algorithm\u003dGOOG4-RSA-SHA256\u0026x-goog-credential\u003duranium%40rcs-uranium.iam.gserviceaccount.com%2F20190826%2Fauto%2Fstorage%2Fgoog4_request\u0026x-goog-date\u003d20190826T201038Z\u0026x-goog-expires\u003d604800\u0026x-goog-signedheaders\u003dhost\u0026x-goog-signature\u003d89dbf7a74d21ab42ad25be071b37840a544a43d68e67270382054e1442d375b0b53d15496dbba12896b9d88a6501cac03b5cfca45d789da3e0cae75b050a89d8f54c1ffb27e467bd6ba1d146b7d42e30504c295c5c372a46e44728f554ba74b7b99bd9c6d3ed45f18588ed1b04522af1a47330cff73a711a6a8c65bb15e3289f480486f6695127e1014727cac949e284a7f74afd8220840159c589d48dddef1cc97b248dfc34802570448242eac4d7190b1b10a008404a330b4ff6f9656fa84e87f9a18ab59dc9b91e54ad11ffdc0ad1dc9d1ccc7855c0d263d93fce6f999971ec79879f922b582cf3bb196a1fedc3eefa226bb412e49af7dfd91cc072608e98"
  }
...

للحصول على خيارات التنسيق والقيمة، يمكنك الاطّلاع على Message

اقتراح

الردود المقترَحة والإجراءات المقترَحة تسمح للمستخدمين بالردّ أو التنفيذ الإجراءات بنقرة واحدة. عندما ينقر المستخدم على أحد الاقتراحات، يتلقّى الوكيل حمولة مع نص الاقتراح وبيانات تسجيل الإحالات الناجحة.

تكون رسائل الاقتراحات بالتنسيق التالي.

{
  "agent": "brands/BRAND_ID/agents/AGENT_ID",
  "conversationId": "CONVERSATION_ID",
  "customAgentId": "CUSTOM_AGENT_ID",
  "requestId": "REQUEST_ID",
  "suggestionResponse": {
    "message": "conversations/CONVERSATION_ID/messages/MESSAGE_ID",
    "postbackData": "POSTBACK_DATA",
    "createTime": "RESPONSE_CREATE_TIME",
    "text": "SUGGESTION_TEXT",
    "suggestionType": "SUGGESTION_TYPE",
  }
  "context": {
    "entryPoint": "CONVERSATION_ENTRYPOINT",
    "placeId": "LOCATION_PLACE_ID",
    "resolvedLocale": "MATCH_OF_USER_AND_AGENT_LOCALES",
    "userInfo": {
      "displayName": "USER_NAME",
      "userDeviceLocale": "USER_LOCALE",
    },
  },
  "sendTime": "SEND_TIME",
}

للحصول على خيارات التنسيق والقيمة، يمكنك الاطّلاع على SuggestionResponse

طلب المصادقة

يتيح اقتراح طلب المصادقة للمستخدمين تسجيل الدخول باستخدام بروتوكول OAuth. تقديم تفاصيل الهوية مع الوكيل أو السماح له وتنفيذ إجراءات على حسابات المستخدمين بالنيابة عنك. راجِع المصادقة باستخدام بروتوكول OAuth.

إذا سجّل أحد المستخدمين الدخول بنجاح من خلال موفِّر OAuth المحدَّد، سيجري الوكيل يتلقى حمولة من خلال رمز التفويض. في حال عدم نجاح المستخدم في عند تسجيل الدخول، يتلقّى الوكيل حمولة بيانات تتضمن تفاصيل الخطأ.

تكون رسائل طلب المصادقة بالتنسيق التالي.

{
  "agent": "brands/BRAND_ID/agents/AGENT_ID",
  "conversationId": "CONVERSATION_ID",
  "customAgentId": "CUSTOM_AGENT_ID",
  "requestId": "REQUEST_ID",
  "authenticationResponse": {
    "code": "AUTHORIZATION_CODE",
    "redirect_uri": "REDIRECT_URI",
    "errorDetails": {
      "error": "ERROR",
      "errorDescription": "ERROR_DESCRIPTION",
    },
  }
  "context": {
    "entryPoint": "CONVERSATION_ENTRYPOINT",
    "placeId": "LOCATION_PLACE_ID",
    "resolvedLocale": "MATCH_OF_USER_AND_AGENT_LOCALES",
    "userInfo": {
      "displayName": "USER_NAME",
      "userDeviceLocale": "USER_LOCALE",
    },
  },
  "sendTime": "SEND_TIME",
}

للحصول على خيارات التنسيق والقيمة، يمكنك الاطّلاع على AuthenticationResponse

سياق الرسالة

تحتوي كل رسالة على معلومات سياقية حول مكان إنشاء الرسالة.

...
  "context": {
    "customContext": "CUSTOM_CONTEXT",
    "entryPoint": "CONVERSATION_ENTRYPOINT",
    "placeId": "LOCATION_PLACE_ID",
    "nearPlaceId": "NEARBY_LOCATION_PLACE_ID",
    "deflectedPhoneNumber": "DEFLECTED_PHONE_NUMBER",
    "resolvedLocale": "MATCH_OF_USER_AND_AGENT_LOCALES",
    "userInfo": {
      "displayName": "USER_NAME",
      "userDeviceLocale": "USER_LOCALE",
    },
    "widget": {
      "url": "WEBSITE_URL",
      "widgetContext": "WIDGET_CONTEXT",
    },
  },
...

الحقل	الوصف
`customContext`	بيانات السياق التي يحدّدها الشريك
`entryPoint`	مساحة الرسائل التي بدأ المستخدم المحادثة منها، على النحو المحدّد بواسطة EntryPoint
`placeId`	معرّف فريد من قاعدة بيانات "أماكن Google" للموقع الجغرافي التي أرسلها المستخدم. لا تظهر الصورة إلا في الرسائل الواردة من مواقع جغرافية محدّدة. نقاط الدخول.
`nearPlaceId`	معرّف فريد من قاعدة بيانات أماكن Google لأول مرة موقع في حزمة محلية. تأكيد المواقع الجغرافية التي يريد المستخدمون المحادثة عندما تتلقى قيمة `nearPlaceId`.
`deflectedPhoneNumber`	رقم الهاتف الذي منعت المستخدم من الاتصال به في ميزة "الرسائل التجارية" عندما بدأت المحادثة.
`resolvedLocale`	أفضل تطابق محسوب للغة المستخدم (تم الإبلاغ عنه في `userDeviceLocale`) واللغات المتاحة للوكيل (يتم تحديده من خلال إعدادات المحادثة المحدّدة). عرض الأقلمة أو البدء المحادثة. قيمة اللغة هي علامة لغة IETF BCP 47 مكتوبة بشكل صحيح.
`userInfo.displayName`	اسم المستخدم الذي أرسل الرسالة. إذا أوقف المستخدم مشاركة الهوية، هذا الحقل فارغ.
`userInfo.userDeviceLocale`	بلغة المستخدم، التي تم الإبلاغ عنها من خلال جهازه، بتنسيق جيد علامة اللغة IETF BCP 47.
`widget.url`	عنوان URL للموقع الإلكتروني الذي تم فيه إطلاق مساحة المحادثة.
`widget.widgetContext`	صفحة قيمة السمة `data-bm-widget-context` للتطبيق المصغّر المستخدَم لبدء المحادثة.

سجل المحادثة

لا توفّر Google سجلّات محادثات. الاحتفاظ بسجلّك الخاص المحادثات بطريقة تتوافق مع سياسة الخصوصية وأفضل الممارسات لكي تتمكّن من إرسال ردود مدروسة على الرسائل المستقبلية من المستخدمين.