Gửi và nhận tin nhắn và sự kiện là các khía cạnh cốt lõi của hoạt động giao tiếp giữa tác nhân và người dùng. Nhân viên hỗ trợ gửi tin nhắn, sự kiện và yêu cầu cho người dùng thông qua API Business Messages nhưng nhận được các thông báo và sự kiện do người dùng tạo tại webhook của họ dưới dạng JSON.
Dưới đây là ví dụ về luồng trò chuyện, sử dụng dữ liệu mẫu để minh hoạ cách tin nhắn, sự kiện và yêu cầu có thể tạo ra các tương tác hữu ích và có ý nghĩa.
Trong ví dụ này, người dùng bắt đầu cuộc trò chuyện và gửi thông báo "Xin chào, Tôi là World!", sau đó nhân viên hỗ trợ trả lời bằng "Hello, World".
- Người dùng bắt đầu cuộc trò chuyện với nhân viên hỗ trợ.
Sau khi người dùng bắt đầu nhập câu trả lời, họ sẽ gửi một sự kiện nhập đến nhân viên hỗ trợ.
{ "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", }Người dùng gửi "Hello, I'm World!" dưới dạng tin nhắn.
{ "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", }Nhân viên hỗ trợ gửi nội dung "Hello, World" dưới dạng tin nhắn.
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' } }"Khi gửi tin nhắn, thiết bị của người dùng sẽ trả lại biên nhận gửi.
{ "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", }