Trả lời hội thoại

• Trả lời hội thoại tin nhắn, bình luận.

Request

• Xem sample Postman tại đây.

curl --location 'https://vpage.open.nhanh.vn/v3.0/conversation/reply?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json' \
--data '{
    "pageId": "{{pageId}}",
    "conversationId": "{{conversationId}}",
    "messageType": {{messageType}} 
    "message": "{{message}}", 
    "recipientId": "{{recipientId}}", 
    "attachments": {{attachments}}
}'

Common params

Param	Type	Mô tả
conversationId	string $^{{\color{red}*}}$	ID hội thoại
pageId	string $^{{\color{red}*}}$	ID page/fanpage
recipientId	string $^{{\color{red}*}}$	ID người nhận
messageType	string	Loại tin nhắn.
message	string	Nội dung text
attachments	array	Danh sách URL file đính kèm
buttons	array	Danh sách nút bấm (chỉ button)
quickReplies	array	Danh sách nút trả lời nhanh (chỉ quickReply)
galleryCards	array	Danh sách card carousel (chỉ gallery)
replyToMessageId	string	ID tin nhắn cần trả lời trực tiếp. Chỉ dùng được ở các kênh ghi rõ bên dưới. Tin nhắn phải thuộc đúng pageId và conversationId.

---

Reply to a message

Truyền ID của tin nhắn đã có trong hội thoại vào replyToMessageId để gửi một tin nhắn trả lời trực tiếp (quote/reply). Hệ thống tự lấy nội dung preview và dữ liệu quote cần thiết từ tin nhắn đã lưu.

Channel	Hỗ trợ	Điều kiện
Zalo OA	Có	Áp dụng cho text và image.
Zalo Cá nhân	Có	Áp dụng cho text, image và video.
TikTok Business	Có	Chỉ áp dụng khi messageType là text.
Facebook Messenger	Không
Instagram	Không
TikTok Shop	Không
Shopee	Không
Lazada	Không
WhatsApp	Không

---

Text - Tin nhắn văn bản

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "text",
  "message": "Xin chào! Chúng tôi có thể giúp gì cho bạn?"
}

Image - Tin nhắn ảnh

Gửi 1 hoặc nhiều ảnh. Mỗi ảnh là 1 URL.

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "image",
  "attachments": ["https://example.com/photo.jpg"]
}

Nhiều ảnh (chỉ Facebook hỗ trợ 1 request, các kênh khác gửi từng ảnh 1 request):

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "image",
  "attachments": [
    "https://example.com/photo1.jpg",
    "https://example.com/photo2.jpg"
  ]
}

Video - Tin nhắn video

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "video",
  "attachments": ["https://example.com/video.mp4"]
}

Audio - Tin nhắn âm thanh

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "audio",
  "attachments": ["https://example.com/audio.mp3"]
}

File - Tin nhắn file đính kèm

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "file",
  "attachments": ["https://example.com/document.pdf"]
}

Button - Tin nhắn có nút bấm (chỉ Facebook)

Gửi tin nhắn text kèm tối đa 3 nút bấm.

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "button",
  "message": "Bạn muốn xem thông tin gì?",
  "buttons": [
    {"type": "block", "title": "Xem đơn hàng", "blockId": "block_order_123"},
    {"type": "url", "title": "Xem sản phẩm", "url": "https://example.com/products"},
    {"type": "phone_number", "title": "Gọi hỗ trợ", "phoneNumber": "0987654321"}
  ]
}

Các loại nút:

• block: trigger chatbot block khi user bấm (cần blockId)

• url: mở URL trong webview (cần url)

• phone_number: mở app điện thoại gọi (cần phoneNumber)

Gallery/Carousel - Tin nhắn carousel (chỉ Facebook)

Gửi carousel tối đa 10 card, mỗi card có ảnh, tiêu đề và nút bấm.

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "gallery",
  "galleryCards": [
    {
      "title": "Sản phẩm 1",
      "subtitle": "Giá: 100.000đ",
      "imageUrl": "https://example.com/product1.jpg",
      "link": "https://example.com/product/1",
      "buttons": [{"type": "block", "title": "Mua ngay", "blockId": "buy_123"}]
    }
  ]
}

Quick Reply - Nút trả lời nhanh (chỉ Facebook)

{
  "conversationId": "conv_123",
  "pageId": "page_001",
  "recipientId": "user_123",
  "messageType": "quickReply",
  "message": "Bạn muốn làm gì tiếp?",
  "quickReplies": [
    {"title": "Xem đơn hàng", "blockId": "block_order_123"},
    {"title": "Hỗ trợ"}
  ]
}

---

Response

• Xem cấu trúc chung tại đây.

Failed response

• Xem các mã lỗi chung tại đây.

Successful response

{
    "code": 1,
    "data": {
        "conversation": {
            "id": "101286204573840_1155721606569955_6289022961168486",
            "type": 1,
            "channel": 1,
            "pageId": "101286204573840",
            "pageUserId": "6289022961168486",
            "pageUserName": "Lý Sơn",
            "pagePostId": "101286204573840_1155721606569955",
            "commentId": "1155721606569955_722713100448041",
            "lastMessage": "open cmt 6",
            "status": 2,
            "hasPhone": false,
            "hasReply": true,
            "updatedAt": 1753349855,
            "createdAt": 1750066386,
            "customerAvatar": "https://example.com/user_1.jpg",
            "isFromLive": 0,
            "isSentPrivateMessage": 1,
            "postIds": [
                "101286204573840_1155721606569955"
            ],
        }
    }
}