Thông báo trạng thái và giá cả

Ứng dụng API WhatsApp Business sẽ gửi thông báo về status của tin nhắn giữa bạn và người dùng. Hệ thống sẽ gửi những thông báo này qua đối tượng statuses.

Cập nhật trạng thái

Cập nhật về giá cả

Ví dụ

Trong ví dụ sau, recipient_id có thể thay bằng trường group_id. Điều này tùy vào việc tin nhắn được gửi cho cá nhân hay cho nhóm.

Trạng thái: Đã gửi tin nhắn

Dưới đây là webhook bạn sẽ nhận được khi doanh nghiệp gửi tin nhắn trong cuộc trò chuyện do người dùng bắt đầu (nếu cuộc trò chuyện đó không bắt nguồn từ một điểm bắt đầu miễn phí):

{
   "statuses": [{
     "id": "ID",
     "recipient_id": "WHATSAPP_ID",
     "status": "sent",
     "timestamp": "TIMESTAMP",
     "type": "message",
     "message": {         
        "recipient_id":"WHATSAPP_ID"   
     },
     "conversation": {
       "id": "CONVERSATION_ID",
       "expiration_timestamp": TIMESTAMP,
       "origin": {
         "type": "user_initiated"
       }
      },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "user_initiated"
    }
   }]
}

Dưới đây là webhook bạn sẽ nhận được khi doanh nghiệp gửi tin nhắn trong cuộc trò chuyện do người dùng bắt đầu đối với tin nhắn có file phương tiện (nếu cuộc trò chuyện đó không bắt nguồn từ một điểm bắt đầu miễn phí):

{
   "statuses": [{
     "id": "ID",
     "recipient_id": "WHATSAPP_ID",
     "status": "sent",
     "timestamp": "TIMESTAMP",
     "type": "message",
     "message": {   
       "media_id": "98d14c8e-0310-4061-8f99-2d148274c286",
       "recipient_id":"WHATSAPP_ID"  
     },
     "conversation": {
       "id": "CONVERSATION_ID",
       "expiration_timestamp": TIMESTAMP,
       "origin": {
         "type": "user_initiated"
       }
      },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "user_initiated"
    }
   }]
}

Dưới đây là webhook bạn sẽ nhận được khi doanh nghiệp gửi tin nhắn trong cuộc trò chuyện do doanh nghiệp bắt đầu:

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "sent",
    "timestamp": "TIMESTAMP",
    "type": "message",         
    "message": {
        "recipient_id":"WHATSAPP_ID" 
    },
    "conversation": {
      "id": "CONVERSATION_ID",
      "expiration_timestamp": TIMESTAMP,
      "origin": {
         "type": "business_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "business_initiated"
    }
   }]
}

Dưới đây là webhook bạn sẽ nhận được khi doanh nghiệp gửi tin nhắn để trả lời cuộc trò chuyện do người dùng bắt đầu bắt nguồn từ một điểm bắt đầu miễn phí:

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "sent",
    "timestamp": "TIMESTAMP",
    "type": "message",
    "message": {
        "recipient_id":"WHATSAPP_ID"   
    },
    "conversation": {
      "id": "CONVERSATION_ID",
      "expiration_timestamp": TIMESTAMP,
      "origin": {
         "type": "referral_conversion",
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": false,
      "category": "referral_conversion"
    }
   }]
}

Trạng thái: Đã phân phối tin nhắn

Dưới đây là webhook bạn sẽ nhận được khi tin nhắn của doanh nghiệp được phân phối và tin nhắn đó nằm trong cuộc trò chuyện do người dùng bắt đầu (nếu cuộc trò chuyện đó không bắt nguồn từ một điểm bắt đầu miễn phí):

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",
    "message": {
        "recipient_id":"WHATSAPP_ID" 
      },
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "user_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "user_initiated"
    }
  }]
}

Dưới đây là webhook bạn sẽ nhận được khi tin nhắn của doanh nghiệp được phân phối và tin nhắn đó nằm trong cuộc trò chuyện do doanh nghiệp bắt đầu:

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    },
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "business_initiated"
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": true,
      "category": "business_initiated"
    }
  }]
}

Dưới đây là webhook bạn sẽ nhận được khi tin nhắn của doanh nghiệp được phân phối và tin nhắn đó nằm trong cuộc trò chuyện do người dùng bắt đầu bắt nguồn từ một điểm bắt đầu miễn phí:

{
  "statuses": [{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "delivered",
    "timestamp": "TIMESTAMP",
    "type": "message",  
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    },
    "conversation": {
      "id": "CONVERSATION_ID",
      "origin": {
         "type": "referral_conversion",
      }
    },
    "pricing": {
      "pricing_model": "CBP",
      "billable": false,
      "category": "referral_conversion"
    }
  }]
}

Trạng thái: Đã đọc tin nhắn

Lệnh gọi lại tiêu chuẩn cho tin nhắn đã đọc:

{
  "statuses":[{
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "read",
    "timestamp": "TIMESTAMP",
    "type": "message",  
    "message": {
        "recipient_id": "WHATSAPP_ID" 
    }
  }]
}

Trạng thái: Không gửi được tin nhắn

Mã lỗi 470

{
  "statuses": [{
    "errors": [{
      "code": 470,
      "title": "Failed to send message because you are outside the support window for freeform messages to this user. Please use a valid HSM notification or reconsider." 
    }],
    "id": "ID",
    "recipient_id": "WHATSAPP_ID",
    "status": "failed",
    "timestamp": "TIMESTAMP"
  }]
}

Mã lỗi 480

{
  "statuses": [{
      "errors": [{
          "code": 480,
          "title": "Failed to send message since we detect an identity change of the contact"
      }],
      "id": "ID",
      "recipient_id": "WHATSAPP_ID",
      "status": "failed",
      "timestamp": "TIMESTAMP"
   }]
}

Nếu không gửi được tin nhắn, lệnh gọi lại sẽ không có tiểu mục của cuộc trò chuyện. Trong trường hợp này, hoạt động kích hoạt cuộc trò chuyện hoặc quy trình lập hóa đơn sẽ không diễn ra.

Trạng thái: Đã xóa tin nhắn

Lệnh gọi lại tiêu chuẩn cho tin nhắn đã xóa:

{
  "statuses": [{
        "id": "ID",
        "recipient_id": "WHATSAPP_ID",
        "status": "deleted",
        "timestamp": "TIMESTAMP",
        "type": "message",
        "message": {
           "recipient_id": "WHATSAPP_ID" 
      }
    }]
}

Nếu tin nhắn đã bị xóa, lệnh gọi lại sẽ không có tiểu mục của cuộc trò chuyện. Trong trường hợp này, hoạt động kích hoạt cuộc trò chuyện hoặc quy trình lập hóa đơn sẽ không diễn ra.

Tất cả các trạng thái tin nhắn có thể có

Hãy xem phần Tổng quan, Tin nhắn để biết thông tin này.

Câu hỏi thường gặp