التسجيل باستخدام ميزة "الرسائل التجارية"

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

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

التسجيل كشريك

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

  1. افتح وحدة تحكم مطوّري البرامج في Business Communications.
  2. ضمن الرسائل التجارية، انقر على إنشاء حساب شريك.

  3. أدخِل قيمًا لمعلومات الشريك:

    الحقل القيمة
    اسمك اسمك بالكامل
    اسم الشريك اسم مؤسستك
    الموقع الإلكتروني للشريك الموقع الإلكتروني لمؤسستك
    المنطقة المنطقة التي تريد استضافة خدمة "الرسائل التجارية" عليها

  1. راجع بنود خدمة رسائل الأنشطة التجارية واقبلها.

  2. انقر على إنشاء.

لقد سجّلت الآن كشريك في ميزة "الرسائل التجارية" ويمكنك الوصول إلى "الرسائل التجارية" وواجهات برمجة التطبيقات Business Communications API. ترسل واجهة برمجة تطبيقات "الرسائل التجارية" الرسائل إلى المستخدمين، بينما تدير Business Communications API الوكلاء.

إنشاء حساب خدمة

لمصادقة طلبات البيانات من واجهة برمجة التطبيقات بأمان لواجهات برمجة تطبيقات الرسائل التجارية والاتصالات، تحتاج إلى مفتاح حساب الخدمة وأداة سطر الأوامر oauth2l.

  1. في الصفحة الرئيسية لـ Business Console Communications Console، انقر على إعدادات حساب الشريك.
  2. في شريط التنقل الأيمن، انقر على حساب الخدمة.

  3. انقر على إنشاء مفتاح، ثم انقر على إنشاء.

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

تعيين Webook

بعد تفعيل واجهة برمجة تطبيقات "الرسائل التجارية" و"اتصالات الأنشطة التجارية"، عليك تحديد عنوان URL للردّ التلقائي على الويب لبدء استلام الرسائل.

  1. افتح إعدادات الحساب في وحدة تحكم مطوّري البرامج في Business Communications.
  2. تأكَّد من اختيار حساب الشريك الصحيح.
  3. بالنسبة إلى عنوان URL للردّ التلقائي على الويب للرسائل التجارية، انقر على ضبط.
  4. بالنسبة إلى عنوان URL لنقطة نهاية الرد التلقائي على الويب، أدخِل عنوان URL للردّ التلقائي على الويب الذي يبدأ بـ "https:// ".
  5. سجِّل قيمة clientToken. ستحتاج إليه للتحقق من أن الرسائل التي تتلقاها تأتي من Google.

  6. يمكنك إعداد الرد التلقائي على الويب لقبول طلب POST مع المعلمة clientToken المحددة وإرسال استجابة 200 OK مع قيمة النص العادي لمعلمة secret باعتبارها نص الاستجابة.

    على سبيل المثال، إذا تلقّى الرد التلقائي على الويب طلب POST بمحتوى النص الأساسي التالي

    {
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}

    من المفترض أن يؤكد الرد التلقائي على الويب على القيمة clientToken، وإذا كان clientToken صحيحًا، فإنه يعرض استجابة 200 OK مع 0123456789 كنص أساسي للاستجابة.

  7. في وحدة التحكّم، انقر على إثبات الملكية.

    عندما تتحقّق "الرسائل التجارية" من الرد التلقائي على الويب، يتم إغلاق مربّع الحوار.

اطّلِع على مثال: تعديل عنوان URL للردّ التلقائي على الويب للاطّلاع على كيفية ضبط الردّ التلقائي على الويب باستخدام واجهات برمجة تطبيقات التواصل في Business.

الحصول على معلومات الشريك

للحصول على معلومات شريكك الحالي، يمكنك طلب البحث في Business Communications API باستخدام معرّف الشريك.

شغّل الأمر التالي. استبدل PARTNER_ID برقم تعريف الشريك.


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"
get-partner.sh

تحديث معلومات الشريك

لتعديل معلومات الشريك، يمكنك استخدام صفحة إعدادات الحساب في وحدة تحكم مطوّري البرامج في Business Communications أو تشغيل الأوامر التالية.

استبدِل PARTNER_ID برقم تعريف الشريك(يمكن العثور على رقم تعريف الشريك في وحدة تحكم مطوّري البرامج في Business Communications)، واستبدِل UPDATED_FIELDS بأسماء الحقول التي تعدّلها.


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'
update-partner.sh

للتعرُّف على خيارات التنسيق والقيمة، يُرجى الاطّلاع على partners.patch.

مثال: تحديث الاسم المعروض

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

مثال: تعديل عنوان URL للردّ التلقائي على الويب

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

الخطوات التالية

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

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