Tham chiếu API

Receiving Events

contact.updated

Tên trong danh bạ WhatsApp đã thay đổi (không gồm whatsapp-protocol). Chỉ cập nhật các trường được cung cấp trong data.contact.address_book: chuỗi rỗng xóa giá trị, trường bị bỏ qua giữ nguyên, null không hợp lệ. Không ghi đè biệt danh của đối phương hoặc hồ sơ của chính tài khoản. contact.id xác định tài nguyên liên hệ, không nhất thiết là mã hội thoại.

Event payload

{
  "id": "0000000000000000000000000000000000000000000000000000000000000191",
  "type": "contact.updated",
  "provider": "whatsapp",
  "account_id": "acc_example",
  "occurred_at": "2026-09-20T03:00:00Z",
  "data": {
    "contact": {
      "id": "15550000002@s.whatsapp.net",
      "conversation_id": "100000000000002@lid",
      "address_book": {
        "full_name": "Example customer",
        "first_name": "Example"
      }
    },
    "event": {
      "kind": "contact_updated",
      "source": "address_book",
      "changed_fields": ["address_book.full_name", "address_book.first_name"],
      "changed_at": "2026-09-20T03:00:00Z"
    }
  }
}

Ghi chú

  • Tên trong danh bạ WhatsApp đã thay đổi (không gồm whatsapp-protocol). Chỉ cập nhật các trường được cung cấp trong data.contact.address_book: chuỗi rỗng xóa giá trị, trường bị bỏ qua giữ nguyên, null không hợp lệ. Không ghi đè biệt danh của đối phương hoặc hồ sơ của chính tài khoản. contact.id xác định tài nguyên liên hệ, không nhất thiết là mã hội thoại.