مرحبًا بالعالم

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

فيما يلي مثال على تدفق محادثة يستخدم نموذج البيانات لتوضيح كيف ويمكن أن تؤدي الرسائل والأحداث والطلبات إلى إنشاء تفاعلات مفيدة وذات مغزى.

في هذا المثال، يبدأ المستخدم محادثة ويُرسل الرسالة "مرحبًا، I'm World! "، ثم يرد الوكيل بقول "مرحبًا، أيها العالم".

1. يبدأ المستخدم المحادثة مع الوكيل.

2. بعد أن يبدأ المستخدم في كتابة رد، يرسل حدث كتابة إلى وكيل المستخدم.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "requestId": "1234567890",
     "userStatus": {
       "isTyping": "true",
       "createTime": "2020-10-02T15:01:23.045123456Z",
     },
     "sendTime": "2020-10-02T15:01:24.045123456Z",
   }
   

3. يرسل المستخدم الرسالة "Hello, I'm World!" كرسالة.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "requestId": "123123123",
     "message": {
       "messageId": "4444",
       "name": "conversations/12345/messages/67890",
       "text": "Hello! I'm World!",
       "createTime": "2020-10-02T15:05:23.045123456Z",
     },
     "context": {
       "entryPoint": "PLACESHEET",
       "userInfo": {
         "displayName": "Michael",
         "userDeviceLocale": "en",
       },
       "resolvedLocale": "en",
     }
     "sendTime": "2020-10-02T15:05:24.045123456Z",
   }
   

4. يرسل الوكيل "مرحبًا، العالم" كرسالة.

   curl -X POST "https://businessmessages.googleapis.com/v1/conversations/3333/messages" \
   -H "Content-Type: application/json" \
   -H "`oauth2l header --json path/to/service/account/key.json businessmessages`" \
   -d "{
       'messageId': '5555',
       'text': 'Hello, World',
       'representative': {
         'avatarImage': 'https://hello.world/avatar.jpg',
         'displayName': 'Hello World Agent',
         'representativeType': 'BOT'
     }
   }"
   

5. وعند تسليم الرسالة، يرسل جهاز المستخدم إيصال التسليم.

   {
     "agent": "brands/1111/agents/2222",
     "conversationId": "3333",
     "customAgentId": "hello-world-bot",
     "receipts" : {
       "receipts": [
         {
           "message": "conversations/3333/messages/5555",
           "receiptType": "DELIVERED",
         }
       ],
       "createTime": "2020-10-02T16:01:23.045123456Z",
     },
     "sendTime": "2020-10-02T16:01:24.045123456Z",
   }