API リファレンス

Receiving Events

contact.updated

WhatsApp のアドレス帳の名前が更新されました（whatsapp-protocol は対象外）。data.contact.address_book に含まれるフィールドだけを更新します。空文字列は消去、省略は変更なしを意味し、null は無効です。相手のニックネームやアカウント自身のプロフィールは上書きしません。contact.id は連絡先リソースの識別子であり、必ずしも会話の識別子ではありません。

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"
    }
  }
}

注記

  • WhatsApp のアドレス帳の名前が更新されました（whatsapp-protocol は対象外）。data.contact.address_book に含まれるフィールドだけを更新します。空文字列は消去、省略は変更なしを意味し、null は無効です。相手のニックネームやアカウント自身のプロフィールは上書きしません。contact.id は連絡先リソースの識別子であり、必ずしも会話の識別子ではありません。