Nhận sự kiện

Nhân viên hỗ trợ của bạn nhận được các sự kiện webhook từ nền tảng RBM, thông báo cho bạn về cả hoạt động tương tác của người dùng và thông tin cập nhật ở cấp nền tảng.

Các sự kiện này được phân loại theo nguồn gốc:

Sự kiện của người dùng: Thông báo được gửi từ thiết bị của người dùng đến nhân viên hỗ trợ của bạn, báo hiệu một hoạt động tương tác với nhân viên hỗ trợ của bạn.
Sự kiện nền tảng: Thông báo về các thay đổi về trạng thái ra mắt của nhân viên hỗ trợ và thời gian hết hạn của tin nhắn do nền tảng RBM gửi.

Để biết thông tin chi tiết về các sự kiện trạng thái mà nhân viên hỗ trợ của bạn gửi đến thiết bị của người dùng, hãy xem Gửi sự kiện.

Để biết thông tin chi tiết về cách xử lý tin nhắn của người dùng, chẳng hạn như văn bản, tệp, vị trí, và các thông tin khác, hãy xem bài viết Nhận tin nhắn.

Sự kiện của người dùng

Sự kiện của người dùng là thông báo từ thiết bị của người dùng báo cáo trạng thái tin nhắn hoặc các thay đổi về gói thuê bao (tức là người dùng đã huỷ đăng ký hoặc đăng ký lại trong Google Tin nhắn).

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

Người dùng nhận được tin nhắn của nhân viên hỗ trợ

Sự kiện này cho biết rằng một tin nhắn đã được gửi thành công đến thiết bị của người dùng.

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "DELIVERED",
  "eventId": "EVENT_ID",
  "messageId": "MESSAGE_ID",
  "agentId": "AGENT_ID"
}

Người dùng đọc tin nhắn của nhân viên hỗ trợ

Sự kiện này cho biết rằng một tin nhắn đã được mở hoặc xác nhận.

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "READ",
  "eventId": "EVENT_ID",
  "messageId": "MESSAGE_ID",
  "agentId": "AGENT_ID"
}

Người dùng bắt đầu nhập

Sự kiện này cho biết rằng người dùng đang nhập câu trả lời.

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "IS_TYPING",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID"
}

Người dùng nhấn vào một hành động được đề xuất

Khi người dùng nhấn vào một hành động được đề xuất, tác nhân của bạn sẽ nhận được một sự kiện có dữ liệu gửi lại của hành động đó.

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID",
  "suggestionResponse": {
    "postbackData": "postback_1234"
  }
}

Người dùng huỷ đăng ký nhận tin nhắn trong cuộc trò chuyện

Sự kiện này cho biết rằng người dùng đã huỷ đăng ký nhận tin nhắn không thiết yếu (chẳng hạn như tin nhắn quảng bá) từ nhân viên hỗ trợ của bạn và doanh nghiệp mà nhân viên hỗ trợ đó đại diện. Người dùng kích hoạt sự kiện này bằng cách huỷ đăng ký nhận tin nhắn trong cuộc trò chuyện RBM trong Google Tin nhắn.

Quan trọng: Để giúp các nhà phát triển chuyển đổi sang các sự kiện webhook UNSUBSCRIBE và SUBSCRIBE mới, Google Tin nhắn cũng đang gửi tin nhắn "DỪNG" và "BẮT ĐẦU" cùng với các sự kiện webhook. Mặc dù hiện tại bạn có thể dựa vào logic DỪNG/BẮT ĐẦU hiện có, nhưng bạn nên cập nhật logic để xử lý các sự kiện UNSUBSCRIBE và SUBSCRIBE, vì các sự kiện này sẽ trở thành bắt buộc theo quy cách GSMA.

Dưới đây là một ví dụ về tải trọng JSON:

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "UNSUBSCRIBE",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID"
}

Cách hoạt động của tính năng huỷ đăng ký

Tuỳ chọn Huỷ đăng ký luôn có trong trình đơn trò chuyện. Đối với các nhân viên hỗ trợ quảng bá và đa mục đích, tuỳ chọn này cũng xuất hiện trực tiếp trong cuộc trò chuyện sau một số tin nhắn chưa đọc (các quy tắc cụ thể sẽ khác nhau tuỳ theo quốc gia).

Việc chọn Huỷ đăng ký sẽ kích hoạt đồng thời hai hành động: Google Tin nhắn gửi một từ khoá dành riêng cho quốc gia (ví dụ: "DỪNG") đến nhân viên hỗ trợ của bạn và nền tảng RBM gửi một sự kiện UNSUBSCRIBE đến webhook của bạn.

Từ khoá được xác định bằng mã quốc gia gồm hai chữ cái của số điện thoại của người dùng. Bảng sau đây liệt kê các từ khoá cho từng quốc gia được hỗ trợ.

Quốc gia (mã quốc gia)	Từ khoá huỷ đăng ký
Hoa Kỳ (US), Ấn Độ (IN), Vương quốc Anh (GB), Đức (DE)	DỪNG
Tây Ban Nha (ES), Mexico (MX)	BAJA
Pháp (FR)	DỪNG
Brazil (BR)	parar

Sau khi người dùng huỷ đăng ký, cuộc trò chuyện vẫn nằm trong hộp thư đến của họ, trừ phi bị báo cáo là tin nhắn rác. Trong trường hợp đó, cuộc trò chuyện sẽ chuyển đến thư mục Tin nhắn rác và bị chặn.
Để xác định các hành vi vi phạm chính sách và quy tắc kinh doanh, Google sẽ giám sát các mẫu tin nhắn sau khi người dùng huỷ đăng ký.

Quy tắc kinh doanh

Là đối tác RBM quản lý cuộc trò chuyện này, bạn có trách nhiệm tuân thủ yêu cầu huỷ đăng ký của người dùng.
Nếu không thể thực hiện việc huỷ đăng ký trong chuỗi tin nhắn, bạn phải gửi ngay một tin nhắn xác nhận kèm theo đường liên kết trực tiếp đến trang web hoặc ứng dụng nơi người dùng có thể quản lý lựa chọn ưu tiên về gói thuê bao.
Sau khi người dùng huỷ đăng ký, bạn không được gửi tin nhắn không thiết yếu.
Bạn vẫn được phép gửi tin nhắn thiết yếu. Các tin nhắn này bao gồm:
- Thông tin xác thực, chẳng hạn như mật khẩu một lần (OTP)
- Thông báo về một dịch vụ cụ thể mà người dùng đã yêu cầu và đồng ý nhận
- Xác nhận yêu cầu huỷ đăng ký của người dùng, kèm theo thông tin để quản lý thêm các lựa chọn ưu tiên về thông tin liên lạc

Ví dụ:

Nếu người dùng huỷ đăng ký nhận tin nhắn từ một nhân viên hỗ trợ của hãng hàng không có trường hợp sử dụng là đa mục đích, thì bạn phải ngừng gửi tin nhắn tiếp thị. Tuy nhiên, bạn có thể gửi thông tin cập nhật về chuyến bay nếu người dùng đã đồng ý rõ ràng nhận thông tin cập nhật cho chuyến bay cụ thể đó.

Lý do huỷ đăng ký

Khi huỷ đăng ký nhận tin nhắn từ nhân viên hỗ trợ của bạn, người dùng có thể chọn một lý do trong các lựa chọn sau:

Tin nhắn rác
Chưa từng đăng ký
Quá nhiều tin nhắn
Không còn quan tâm
Khác

Lý do huỷ đăng ký được hiển thị trong phần Tổng quan về Analytics để giúp các đối tác hiểu được lý do người dùng huỷ đăng ký.

Người dùng đăng ký lại nhận tin nhắn trong cuộc trò chuyện

Sự kiện này cho biết rằng người dùng muốn nhận lại tin nhắn từ nhân viên hỗ trợ của bạn, bao gồm cả nội dung không thiết yếu như tin nhắn quảng bá. Người dùng có thể kích hoạt sự kiện này bằng cách đăng ký lại nhận tin nhắn trong một cuộc trò chuyện mà họ đã huỷ đăng ký trước đó trong Google Tin nhắn.

Dưới đây là một ví dụ về tải trọng JSON:

{
  "senderPhoneNumber": "PHONE_NUMBER",
  "eventType": "SUBSCRIBE",
  "eventId": "EVENT_ID",
  "agentId": "AGENT_ID"
}

Cách hoạt động của tính năng đăng ký lại

Tuỳ chọn Đăng ký (có trong cả trình đơn trò chuyện và đường liên kết trong cuộc trò chuyện) cho phép người dùng đăng ký lại nhận tin nhắn trong một cuộc trò chuyện mà họ đã huỷ đăng ký.

Việc chọn Đăng ký sẽ kích hoạt đồng thời hai hành động: Google Tin nhắn gửi một từ khoá dành riêng cho quốc gia (ví dụ: "BẮT ĐẦU") đến nhân viên hỗ trợ của bạn và nền tảng RBM gửi một sự kiện ĐĂNG KÝ đến webhook của bạn. Từ khoá cụ thể được xác định bằng mã quốc gia gồm hai chữ cái của số điện thoại của người dùng. Bảng sau đây liệt kê các từ khoá cho từng quốc gia được hỗ trợ.

Quốc gia (mã quốc gia)	Từ khoá đăng ký
Hoa Kỳ (US), Ấn Độ (IN), Vương quốc Anh (GB), Đức (DE)	BẮT ĐẦU
Tây Ban Nha (ES), Mexico (MX)	ALTA
Pháp (FR)	Démarrer
Brazil (BR)	começar

Quy tắc kinh doanh

Là đối tác RBM quản lý cuộc trò chuyện này, bạn có trách nhiệm tuân thủ yêu cầu đăng ký lại của người dùng.
Tính năng đăng ký lại áp dụng cho tất cả các loại tin nhắn, bao gồm cả nội dung không thiết yếu như tin nhắn quảng bá.
Nếu người dùng nhắn tin cho doanh nghiệp của bạn sau khi huỷ đăng ký, thì đây có thể được coi là yêu cầu đăng ký lại.
Nếu người dùng đăng ký lại bên ngoài kênh nhắn tin (ví dụ: trên trang web của bạn), thì bạn có trách nhiệm cập nhật trạng thái của họ và tiếp tục gửi tin nhắn cho phù hợp với tư cách là đối tác RBM.

Sự kiện nền tảng

Nền tảng RBM gửi các sự kiện nền tảng để thông báo cho nhân viên hỗ trợ của bạn về những thay đổi đối với trạng thái ra mắt của nhân viên hỗ trợ hoặc thời gian hết hạn của tin nhắn.

Trạng thái ra mắt của nhân viên hỗ trợ đã thay đổi

Nền tảng RBM gửi một AgentLaunchEvent cho mỗi thay đổi đối với trạng thái ra mắt của nhân viên hỗ trợ. Ví dụ: khi trạng thái của nhân viên hỗ trợ thay đổi từ PENDING thành LAUNCHED. Sự kiện này được gửi dưới dạng thông báo Pub/Sub. Để phân biệt sự kiện này với các sự kiện khác, hãy kiểm tra đường dẫn message.attributes.type để tìm giá trị agent_launch_event.

Cấu hình webhook

Bạn có thể sử dụng webhook ở cấp độ đối tác hoặc cấp độ nhân viên hỗ trợ để nhận các thông báo này.

Điều kiện tiên quyết

Định cấu hình webhook cho tính năng nhắn tin RBM (đây là yêu cầu để nhận tin nhắn và sự kiện của người dùng).
Để phân biệt giữa sự kiện của người dùng và sự kiện trạng thái ra mắt của nhân viên hỗ trợ, hãy kiểm tra đường dẫn message.attributes.type để tìm giá trị agent_launch_event.

Cấu trúc tải trọng sự kiện

AgentLaunchEvent được gửi dưới dạng thông báo Pub/Sub. Ví dụ:

{
  "message": {
    "attributes": {
      "business_id": "rbm-chatbot-id@rbm.goog",
      "event_type": "REJECTED",
      "product": "RBM",
      "project_number": "3338881441851",
      "type": "agent_launch_event"
    },
    "data": "....BASE64-encoded-JSON-with-notification...",
    "messageId": "14150481888479752",
    "message_id": "14150481888479752",
    "publishTime": "2025-03-05T18:50:21.88Z",
    "publish_time": "2025-03-05T18:50:21.88Z"
  },
  "subscription": "projects/rbm-partner-gcp/subscriptions/rbm-sub"
}

Trường AgentLaunchEvent.LaunchState trong tải trọng sự kiện cho biết trạng thái ra mắt mới của nhân viên hỗ trợ. Dưới đây là các giá trị có thể có:

Giá trị	Trạng thái ra mắt của nhân viên hỗ trợ	Thông tin chi tiết
`PENDING`	Đang chờ xử lý	Yêu cầu đã được gửi đến một nhà mạng để xem xét.
`LAUNCHED`	Đã ra mắt	Tin nhắn được cho phép trên một nhà mạng nhất định.
`REJECTED`	Bị từ chối trên một nhà mạng nhất định	Lý do từ chối được chỉ định trong nhận xét.
`SUSPENDED`	Bị tạm ngưng trên một nhà mạng nhất định	Lý do tạm ngưng được chỉ định trong nhận xét.
`UNLAUNCHED`	Chưa ra mắt	Bạn được phép chỉnh sửa các nhân viên hỗ trợ đã bị huỷ ra mắt khỏi tất cả các nhà mạng.

Trường dữ liệu chứa một đối tượng JSON được mã hoá Base64 có thông tin chi tiết về trạng thái ra mắt. Dưới đây là một ví dụ về JSON đã giải mã:

    {
      "eventId": "rbm-chatbot-id/0a7ed168-676e-4a56-b422-b23434",
      "agentId": "rbm-chatbot-id@rbm.goog",
      "botDisplayName": "RBM Welcome Bot 7 - RBM Chatbot name",
      "brandId": "bd38fbff-392a-437b-a6f2-7f2e43745b56",
      "brandDisplayName": "Chatbots brand",
      "regionId": "/v1/regions/fi-rcs",
      "oldLaunchState": "PENDING",
      "newLaunchState": "REJECTED",
      "actingParty": "rbm-support@google.com",
      "comment": "Carrier has rejected the launch: policy violation",
      "sendTime": "2025-03-05T18:50:19.386436Z"
    }

Các thay đổi về trạng thái ra mắt do nhà mạng khởi xướng

Đây là những quá trình chuyển đổi được phép mà Nhà mạng thường xử lý trong quá trình xem xét và thực thi:

Trạng thái ra mắt cũ	Trạng thái ra mắt mới	Hành động kích hoạt
`PENDING`	`LAUNCHED`	Phê duyệt yêu cầu ra mắt.
`PENDING`	`REJECTED`	Từ chối yêu cầu ra mắt.
`LAUNCHED`	`SUSPENDED`	Tạm ngưng vì lý do thực thi/quản trị.
`SUSPENDED`	`LAUNCHED`	Khôi phục nhân viên hỗ trợ về trạng thái hoạt động.
`SUSPENDED`	`UNLAUNCHED`	Chấm dứt nhân viên hỗ trợ.

Các thay đổi về trạng thái ra mắt do đối tác khởi xướng

Đây là những quá trình chuyển đổi được phép mà Đối tác thường xử lý:

Trạng thái ra mắt cũ	Trạng thái ra mắt mới	Hành động kích hoạt
`UNSPECIFIED`	`PENDING`	Gửi để xem xét.
`UNLAUNCHED`	`PENDING`	Gửi để xem xét.
`REJECTED`	`PENDING`	Gửi lại để xem xét.

Tin nhắn đã hết hạn; thu hồi thành công

Sự kiện này cho biết rằng thời gian tồn tại (TTL) của tin nhắn đã hết hạn và tin nhắn đã được thu hồi thành công. Đây là một trình kích hoạt tốt cho chiến lược nhắn tin dự phòng của bạn.

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

{
  "phoneNumber": "[phone number]" ,
  "messageId": "[RCS message ID]",
  "agentId": [bot ID],
  "eventType": "TTL_EXPIRATION_REVOKED",
  "eventId": "[unique ID]",
  "sendTime": "[time stamp]"
}

Tin nhắn đã hết hạn; thu hồi không thành công

Sự kiện này cho biết rằng TTL của tin nhắn đã hết hạn nhưng không thu hồi được.

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

{
  "phoneNumber": "[phone number]",
  "messageId": "[RCS message ID]",
  "agentId": "[bot ID]",
  "eventType": "TTL_EXPIRATION_REVOKE_FAILED",
  "eventId": "[unique ID]",
  "sendTime": "[time stamp]"
}

Việc gửi tin nhắn không được đảm bảo.

Nếu tin nhắn được gửi, bạn sẽ nhận được một sự kiện DELIVERED tại webhook của mình.
Nếu tin nhắn không được gửi, hãy sử dụng API thu hồi để gửi yêu cầu thu hồi.

Nếu tin nhắn có tính chất nhạy cảm về thời gian, chẳng hạn như OTP hoặc cảnh báo lừa đảo, thì tốt nhất là bạn nên gửi tin nhắn thông qua một kênh thay thế như SMS ngay cả khi điều này dẫn đến việc người dùng nhận được tin nhắn trùng lặp.

Gửi sự kiện

Tiếp

Kiểm tra khả năng

Nhận sự kiện Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Sự kiện của người dùng

Người dùng nhận được tin nhắn của nhân viên hỗ trợ

Người dùng đọc tin nhắn của nhân viên hỗ trợ

Người dùng bắt đầu nhập

Người dùng nhấn vào một hành động được đề xuất

Người dùng huỷ đăng ký nhận tin nhắn trong cuộc trò chuyện

Cách hoạt động của tính năng huỷ đăng ký

Quy tắc kinh doanh

Ví dụ:

Lý do huỷ đăng ký

Người dùng đăng ký lại nhận tin nhắn trong cuộc trò chuyện

Cách hoạt động của tính năng đăng ký lại

Quy tắc kinh doanh

Sự kiện nền tảng

Trạng thái ra mắt của nhân viên hỗ trợ đã thay đổi

Cấu hình webhook

Điều kiện tiên quyết

Cấu trúc tải trọng sự kiện

Các thay đổi về trạng thái ra mắt do nhà mạng khởi xướng

Các thay đổi về trạng thái ra mắt do đối tác khởi xướng

Tin nhắn đã hết hạn; thu hồi thành công

Tin nhắn đã hết hạn; thu hồi không thành công

Nhận sự kiện