تلقي الرسائل

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

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

للتعرّف على كيفية تعامل وكيلك مع إشعارات التسليم وإشعارات القراءة ومؤشرات الكتابة، اطّلِع على تلقّي الأحداث.

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

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

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

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

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

• تتضمّن رسائل الموقع الجغرافي قيم خطوط الطول والعرض.

• تتضمّن رسائل الملف معرّف الموارد المنتظم (URI) لملف وبيانات مرتبطة به.

الخطوة 2: معالجة محتوى الرسالة

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

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

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

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

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

الخطوة 3: تنفيذ منطق النشاط التجاري للتفاعل

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

الخطوة 4: الردّ على المستخدم

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

أمثلة

يوضّح الرمز التالي كيفية تلقّي الوكيل للرسائل. للحصول على معلومات حول التنسيق والقيمة، يُرجى الاطّلاع على UserMessage.

يتلقّى الوكيل رسالة نصية

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "text": "Hello, world!"
}

يتلقّى الموظف رسالة من اقتراح

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "suggestionResponse": {
    "postbackData": "suggestion_1",
    "text": "Suggestion #1"
  }
}

يتلقّى الوكيل موقعًا جغرافيًا

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "location": {
    "latitude": 37.422000,
    "longitude": -122.084056
  }
}

يتلقّى الوكيل ملفًا

{
  "agentId": "AGENT_ID",
  "senderPhoneNumber": "PHONE_NUMBER",
  "messageId": "MESSAGE_ID",
  "sendTime": "2018-12-31T15:01:23.045123456Z",
  "userFile": {
    "thumbnail": {
      "mimeType": "image/jpeg",
      "fileSizeBytes": 1280,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c8",
      "fileName": "4_animated.jpeg"
    },
    "payload": {
      "mimeType": "image/gif",
      "fileSizeBytes": 127806,
      "fileUri": "https://storage.googleapis.com/copper_test/77ddb795-24ad-4607-96ae-b08b4d86406a/d2dcc67ab888d34ee272899c020b13402856f81597228322079eb007e8c9",
      "fileName": "4_animated.gif"
    }
  }
}