사용자 WhatsApp ID 신원

/v1/contacts/{users-whatsapp-id}/identity

대화 중인 사용자가 변경되었을 가능성이 있을 경우 WhatsApp에서 알림을 받을 수 있습니다. 이 /v1/contacts 에지를 사용하여 사용자의 신원을 관리하세요. 자세한 내용은 WhatsApp 비즈니스의 ID 변경 이해하기를 참조하세요.

WhatsApp에서 보낸 시스템 알림에 대한 자세한 내용은 인바운드 시스템 메시지 — 예: 사용자가 변경되었을 가능성이 있습니다를 참조하세요. 시스템 알림에 대한 응답은 비즈니스에서 관리합니다.

읽기

이 엔드포인트로 GET 호출을 보내면 사용자의 최신 ID 해시를 검색합니다.

요청:

GET /v1/contacts/users-whatsapp-id/identity

응답:

성공할 경우 요청에서 200 OKcontacts 개체가 포함된 메시지 본문을 반환합니다. 예를 들어 contacts 개체를 포함한 완전한 응답은 다음과 같습니다.

{
    "contacts":
    {
        "hash": "UKD6Y/5SqDU=",
        "created_timestamp": 1600132094000,
        "acknowledged": true 
    }
}
  

반환된 필드

contacts 응답 개체에는 사용자의 ID에 대해 다음의 정보가 포함됩니다.

이름설명

acknowledged

유형: 문자열

최신 user_identity_changed 시스템 알림에 대한 승인 상태입니다.

created_timestamp

유형: 정수

WhatsApp Business API 클라이언트가 사용자의 잠재적 변경을 탐지한 시점의 타임스탬프입니다.

hash

유형: 문자열

최신 user_identity_changed 시스템 알림에 대한 식별자입니다.

만들기

이 엔드포인트로 PUT 호출을 보내서 최신 user_identity_changed 시스템 알림을 확인합니다.

show_security_notifications 설정이 앱 설정에 활성화되어 있을 경우 user_identity_changed 알림을 받은 후 identity API 호출에 성공할 때까지 이 사용자에게 전송되는 모든 발송 메시지가 차단됩니다.

요청:

PUT /v1/contacts/users-whatsapp-id/identity
  {
    “hash”: “Rc/eg9RQ0JA=”
  }

응답:

성공한 응답은 null 또는 {} 메시지 본문이 포함된 200 OK로 표시됩니다.

매개변수

이름설명

hash

유형: 문자열

이 연락처에 대해 수신한 최신 user_identity_change 시스템 알림의 식별자