Sự kiện Official Account gửi tin nhắn tương tác

Ví dụ:

"{
  ""event_name"": ""oa_send_list"",
  ""app_id"": ""663461135417947644"",
  ""sender"": {
    ""id"": ""2607422273982216036""
  },
  ""recipient"": {
    ""id"": ""8832509132079120882""
  },
  ""message"": {
    ""attachments"": [
      {
        ""payload"": {
          ""thumbnail"": ""https://s160-ava-talk.zadn.vn/7/f/a/3/2/160/fdae951a3a9dd08958342c2e0fd88440.jpg"",
          ""description"": ""Nền tảng Giao tiếp Đa kênh CS eTelecom (Communications Platforms as a Service) kết nối các Nhà mạng & Zalo, giúp Doanh nghiệp triển khai Zalo Official Account (OA) nhanh chóng bao gồm OA Chat, ZNS, ZCC & Zalo Mini App. CS eTelecom hỗ trợ Doanh nghiệp API/SDK tích hợp Tổng đài ảo và phần mềm bên thứ 3 (e-Invoice, Chatbot, CDP, CRM, DMS, ERP, POS)"",
          ""title"": ""eTelecom - Đang yêu cầu thông tin từ bạn"",
          ""url"": ""https://oa.zalo.me/reqinfo?tk=miFAs1PMofAAd9JOGmUlrCV7xerP2gJHniFkbK9CxvYM__dI2ZIzY9_--zGFCAMUtRdrp4fqj9NOjl7BJ7oqbZPz""
        },
        ""type"": ""link""
      }
    ],
    ""text"": ""eTelecom - Đang yêu cầu thông tin từ bạn"",
    ""msg_id"": ""d5067d81765fe404bd4b""
  },
  ""timestamp"": ""1731487620760""
}"

Mô tả thuộc tính data

Thuộc tính
Kiểu dữ liệu
Mô tả

app_id

String

Id ứng dụng ứng với access_token gọi API gửi tin nhắn

sender

Json Object

Trong đó:

  • "id": Id của Official Account gửi tin nhắn

  • "admin_id": Id của admin OA nhắn tin (Chỉ có khi OA gửi tin nhắn bằng tool chat OA - https://oa.zalo.me/chatv2)

recipient

Json Object

Trong đó:

  • "id": Id của User nhận tin nhắn

attachments

Json Array

Trong đó:

  • payload: Chứa thông tin chi tiết của tin nhắn đa phương tiện

    • thumbnail: Hình ảnh hiển thị

    • description: Thông tin mô tả của trang web đó.

    • url: đường dẫn đến trang web

  • type: Loại tin nhắn

event_name

String

Thuộc tính xác định loại event, có giá trị như sau:

  • event _name="oa_send_list": OA gửi tin nhắn tương tác

message

Json Object

Tùy theo event_name mà message sẽ có định dạng khác nhau, chi tiết sẽ được định nghĩa bên dưới bảng này.

Trong đó:

  • "text": Nội dung tin nhắn người dùng gửi cho Official Account.

  • "msg_id": Id của tin nhắn.

Ngoài ra:

  • Nếu tin nhắn được gửi là tin nhắn đa phương tiện (Hình ảnh, ảnh gif,...) thì sẽ có thêm thuộc tính attachments.

  • Nếu trong data trả về có thuộc tính “quote_msg_id” thì tin nhắn này được gửi qua Gửi tin tư vấn trích dẫn

user_id_by_app

String

Trường này chỉ có khi app_id chỉ ứng dụng đang liên kết với Official Account nhận sự kiện. Id này có thể sử dụng cho social_api

timestamp

String

Thời điểm request được gửi, tính bằng milisecond

Last updated