Gửi sự kiện

Nhân viên hỗ trợ của bạn gửi các sự kiện trạng thái đến thiết bị của người dùng để mô phỏng hoạt động tương tác của con người. Đối với người dùng, các sự kiện này hiển thị dưới dạng thông báo xác nhận đã đọc hoặc chỉ báo đang nhập, đảm bảo với họ rằng tin nhắn của họ đang được xử lý.

Để biết đầy đủ các tuỳ chọn định dạng và giá trị, hãy xem tài liệu tham khảo phones.agentEvents.

Để biết thông tin chi tiết về các sự kiện webhook mà nhân viên hỗ trợ của bạn nhận được từ nền tảng RBM, hãy xem phần Nhận sự kiện.

Tác nhân gửi sự kiện READ

Đối với người dùng, sự kiện này xuất hiện dưới dạng thông báo xác nhận đã đọc cho một tin nhắn cụ thể. Sự kiện này cho người dùng biết rằng nền tảng RBM đã gửi tin nhắn của họ và nhân viên hỗ trợ đang xử lý tin nhắn đó.

Các sự kiện READ được lưu giữ và lưu trữ trong 30 ngày. Nếu người dùng đã bật RCS nhưng không liên lạc được, thì sự kiện sẽ được đưa vào hàng đợi. Nếu họ chưa bật RCS, nền tảng RCS for Business sẽ trả về lỗi NOT_FOUND (HTTP 404).

Đoạn mã sau đây gửi một sự kiện READ cho một thông báo có messageId khớp.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentEvents?eventId=EVENT_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'eventType': 'READ',
  'messageId': 'MESSAGE_ID'
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the device an event to indicate that messageId has been read
rbmApiHelper.sendReadMessage('[phone]', messageId);

Mã này là một đoạn trích từ tác nhân mẫu RBM.

Java

import com.google.rbm.RbmApiHelper;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();

// Send the device an event to indicate that messageId has been read
rbmApiHelper.sendReadMessage(messageId, "[phone]");

Đoạn mã này được trích từ một tác nhân mẫu RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service

# Send the device an event to indicate that message_id was read
rbm_service.send_read_event('[phone]', message_id)

Đoạn mã này được trích từ một tác nhân mẫu RBM.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Send the device an event to indicate that messageId has been read
rbmApiHelper.SendReadMessage(messageId, "[phone]");

Mã này là một đoạn trích từ tác nhân mẫu RBM.

Tác nhân gửi sự kiện IS_TYPING

Đối với người dùng, sự kiện này xuất hiện dưới dạng chỉ báo đang nhập và cho họ biết rằng nhân viên hỗ trợ của bạn đang soạn tin nhắn. Chỉ báo đang nhập sẽ hết hạn sau một khoảng thời gian ngắn (mặc định là khoảng 5 giây) hoặc khi thiết bị của người dùng nhận được tin nhắn mới từ nhân viên hỗ trợ của bạn. Tác nhân của bạn có thể gửi nhiều sự kiện IS_TYPING để đặt lại bộ tính giờ hết hạn của chỉ báo đang nhập.

Sự kiện IS_TYPING chỉ tồn tại trong thời gian ngắn và không được đưa vào hàng đợi.

Đoạn mã sau đây gửi một sự kiện IS_TYPING.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentEvents?eventId=EVENT_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d "{
  'eventType': 'IS_TYPING',
}"

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Send the device an event to indicate that the agent is typing
rbmApiHelper.sendIsTypingMessage('[phone]', function() {
    console.log('Typing event sent!');
});

Mã này là một đoạn trích từ tác nhân mẫu RBM.

Java

import com.google.rbm.RbmApiHelper;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();

// Send the device an event to indicate that the agent is typing
rbmApiHelper.sendIsTypingMessage("[phone]");

Mã này là một đoạn trích từ tác nhân mẫu RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service

# Send the device an event to indicate that the agent is typing
rbm_service.send_is_typing_event('[phone]')

Mã này là một đoạn trích từ tác nhân mẫu RBM.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Send the device an event to indicate that the agent is typing
rbmApiHelper.SendIsTypingMessage(messageId, "[phone]");

Mã này là một đoạn trích từ tác nhân mẫu RBM.