이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

WhatsApp 사용자 이름 및 비즈니스 범위 사용자 ID

WhatsApp 사용자 이름은 비즈니스에 메시지를 보낼 때 사용자의 전화번호를 숨겨 주는 선택적 개인정보 보호 기능입니다. Braze는 이를 자동으로 처리하므로, 대부분의 고객은 Campaigns나 Canvases에서 아무것도 변경할 필요가 없습니다.

중요

Meta는 WhatsApp 사용자 이름과 BSUID를 단계적으로 출시하고 있습니다. Braze는 BSUID 메시징을 완벽하게 지원하므로, 시간이 지남에 따라 BSUID만 있는 사용자가 늘어날 수 있습니다. Meta의 최신 업데이트는 비즈니스 범위 사용자 ID를 참조하세요.

WhatsApp 사용자가 사용자 이름을 채택하면, 해당 사용자의 전화번호는 더 이상 메시지를 보내는 비즈니스에 자동으로 공유되지 않습니다. 대신 WhatsApp은 비즈니스에 비즈니스 범위 사용자 ID(BSUID)를 제공합니다. 이는 각 비즈니스 포트폴리오와 사용자 쌍에 고유한 식별자입니다.

Braze는 BSUID를 자동으로 처리합니다. 사용자 이름을 채택한 사용자는 계속해서 Braze 워크스페이스에 표시되고, 메시지를 수신하고, Canvases를 트리거하고, 이벤트를 생성합니다. 일부 고객은 변경 사항에 대비해야 할 수 있습니다.

비즈니스 범위 사용자 ID(BSUID)

BSUID는 WhatsApp이 특정 비즈니스 포트폴리오 내에서 사용자를 나타내기 위해 할당하는 고유하고 영구적인 식별자입니다. 전화번호를 비공개로 유지하기로 선택한 사용자를 위한 대체 전화번호라고 생각하면 됩니다.

BSUID에는 세 가지 주요 특징이 있습니다.

특징	설명
고유	비즈니스 포트폴리오 내에서 두 사용자가 동일한 BSUID를 공유하지 않습니다.
비즈니스 범위	동일한 사용자라도 메시지를 주고받는 비즈니스마다 서로 다른 BSUID를 갖습니다. BSUID는 서로 다른 비즈니스 포트폴리오 간에 공유하거나 비교할 수 없습니다.
웹훅에서 사용 가능	BSUID는 사용자의 전화번호를 전달하는 모든 웹훅 페이로드에 동일하게 포함됩니다.

WhatsApp 사용자 유형 변경 사항

WhatsApp 사용자에는 두 가지 유형이 있습니다:

사용자 유형	WhatsApp 식별 방식	Braze가 수신하는 정보
사용자 이름이 없는 사용자	전화번호(변경 없음)	전화번호(변경 없음)
사용자 이름이 있는 사용자	사용자 이름(표시), BSUID(백엔드)	BSUID, 비즈니스와 기존 대화가 있는 사용자의 경우 전화번호

가장 큰 차이점은 사용자 이름을 채택한 사용자는 이전에 비즈니스와 대화한 적이 있거나 WhatsApp 연락처에 등록되어 있는 경우에만 비즈니스에 전화번호를 공유한다는 것입니다.

Braze의 BSUID 처리 방식

Braze는 BSUID를 고객 프로필에 whats_app_bsuid 레이블이 지정된 사용자 별칭으로 저장합니다. 따라서 BSUID만 있는 사용자도 완전한 Braze 고객 프로필을 가지며, Canvases에 진입하고, 메시지를 받고, 이벤트를 생성하고, API를 통해 업데이트될 수 있습니다.

메시지 보내기

Braze는 WhatsApp 메시지를 보낼 때 전화번호가 있으면 전화번호를 사용합니다. 사용자에게 BSUID만 있는 경우(예: 사용자 이름을 도입한 후 처음으로 메시지를 보낸 사용자) Braze는 대신 BSUID를 사용해 메시지를 보냅니다. 메시지 템플릿, Campaign, 캔버스 단계는 변경할 필요가 없습니다.

인바운드 메시지 및 Canvas 트리거

사용자 이름이 있는 사용자가 인바운드 WhatsApp 메시지를 보내면 Braze는 다음을 수행합니다.

웹훅에 포함된 BSUID 또는 전화번호 중 사용 가능한 값으로 사용자를 조회합니다.
일치하는 사용자가 없으면 BSUID를 사용자 별칭으로 저장한 새 익명 고객 프로필을 생성합니다.
인바운드 WhatsApp 메시지로 시작하도록 구성된 Canvas 또는 Campaign을 트리거합니다.

고객 프로필

사용자의 BSUID는 해당 사용자의 Braze 고객 프로필 내 WhatsApp 섹션에서 확인할 수 있습니다.

구독 그룹

BSUID 사용자의 구독 그룹 관리는 사용자 별칭으로 식별되는 다른 사용자와 동일한 방식으로 작동합니다. BSUID 사용자의 구독 상태는 다음 방법으로 업데이트할 수 있습니다.

user_alias를 사용하는 users/track 엔드포인트
사용자 업데이트 캔버스 단계(자동으로 작동)
CSV 업로드

참고

subscription/status/set 엔드포인트는 user_alias를 지원하지 않습니다. BSUID만 있는 사용자의 구독 상태를 업데이트하려면 users/track 엔드포인트를 사용하세요.

Currents 및 이벤트 데이터

모든 WhatsApp Currents 이벤트(전송, 전달, 읽음, 실패, 인바운드 수신, 중단, 재시도)에는 BSUID 필드가 포함됩니다. 전화번호와 BSUID가 모두 있는 사용자의 경우 두 필드가 모두 포함됩니다. BSUID만 있는 사용자의 경우 BSUID 필드만 포함되며 전화번호 필드는 비어 있습니다.

변경에 대비하는 방법

대부분의 고객은 별도의 조치가 필요하지 않습니다. Braze가 BSUID 라우팅, 사용자 생성, 이벤트 추적을 자동으로 처리합니다. 다만 WhatsApp 연락처 목록을 활성화하는 것을 권장합니다. 여러 WhatsApp 비즈니스 계정(WABA)을 사용하는 경우에는 비즈니스 포트폴리오를 연결하는 것도 권장합니다.

WhatsApp 연락처 목록 활성화

연락처 목록(Contact Book)은 이미 대화한 사용자의 전화번호를 기록하는 Meta 기능입니다. 사용자가 사용자 이름을 사용하기 시작해도 연락처 목록에 있는 사용자라면 비즈니스에서 계속 전화번호를 확인할 수 있습니다. 따라서 사용자가 사용자 이름을 활성화한 후에도 Braze는 전화번호로 사용자를 계속 식별할 수 있습니다.

연락처 목록을 활성화하려면 다음을 수행합니다.

Meta Business Suite > 비즈니스 설정 > 비즈니스 정보로 이동합니다.
연락처 목록 기능이 활성화되어 있는지 확인합니다.

팁

연락처 목록 기능은 기본값으로 켜져 있지만, Meta 비즈니스 설정에서 한 번 더 확인하는 것을 권장합니다. 연락처 목록이 비활성화되어 있으면 사용자 이름을 사용하기 시작한 사용자는 이전에 메시지를 보낸 적이 있더라도 BSUID만 있는 신규 사용자로 표시됩니다.

여러 WABA를 사용하는 경우 비즈니스 포트폴리오 연결

BSUID는 단일 비즈니스 포트폴리오 범위로 지정됩니다. 조직에서 동일한 Braze 워크스페이스 내에서 여러 비즈니스 포트폴리오의 WABA를 관리하는 경우, 같은 사용자라도 포트폴리오마다 다른 BSUID를 갖게 됩니다. 이로 인해 Braze 고객 프로필이 중복될 수 있습니다.

이를 방지하려면 Meta 담당자에게 문의하여 비즈니스가 포트폴리오 연결 대상인지 확인하세요. 자세한 내용은 비즈니스 포트폴리오 및 상위 BSUID 연결을 참조하세요.

모든 WABA가 동일한 비즈니스 포트폴리오에 속해 있다면 별도의 조치가 필요하지 않습니다.

비즈니스 포트폴리오 및 상위 BSUID 연결

조직에서 여러 비즈니스 포트폴리오에 걸쳐 여러 WhatsApp 비즈니스 계정(WABA)을 운영하는 경우, Meta 담당자에게 해당 포트폴리오를 서로 연결할 수 있는지 자격 여부를 확인해 달라고 요청할 수 있습니다. 자격 여부는 Meta가 결정하며, 관리형 비즈니스에서 사용할 수 있습니다.

연결된 포트폴리오의 동작

비즈니스 포트폴리오가 연결되면 WhatsApp은 모든 메시지 웹훅에 일반 BSUID와 함께 상위 BSUID를 포함합니다. 상위 BSUID는 웹훅 페이로드의 새로운 parent_user_id 속성정보에 할당됩니다.

상위 BSUID는 일반 BSUID와 동일한 속성을 갖지만, 연결된 포트폴리오 세트 내의 모든 비즈니스 전화번호에서 공유됩니다. 즉, 사용자가 어떤 WABA에 메시지를 보내든 동일한 사용자는 하나의 일관된 식별자를 가지므로 고객 프로필이 중복될 위험을 피할 수 있습니다.

상위 BSUID는 국가 코드와 영숫자 식별자 사이에 ENT를 포함합니다. 예를 들면 다음과 같습니다.

US.ENT.11815799212886844830

일반 BSUID에는 ENT가 포함되지 않습니다.

Braze에서 상위 BSUID를 사용하는 방식

웹훅에 일반 BSUID와 상위 BSUID가 모두 포함된 경우, Braze는 상위 BSUID를 기본 식별자로 사용합니다. 이를 통해 연결된 포트폴리오의 여러 WABA에 메시지를 보내는 사용자를 동일한 Braze 고객 프로필에 일관되게 매칭할 수 있습니다.

상위 BSUID가 없는 경우(예: 포트폴리오가 연결되지 않았거나 사용자가 연결되지 않은 WABA에 메시지를 보내는 경우) Braze는 일반 BSUID를 사용합니다. 일반 BSUID는 모든 경우에 계속 정상적으로 작동합니다.

참고

비즈니스 포트폴리오 연결 프로세스는 Meta에서 관리합니다. 시작하려면 Meta 담당자에게 문의하세요. 포트폴리오가 연결된 경우에도 일반 BSUID를 사용하여 사용자에게 메시지를 보낼 수 있습니다. 상위 BSUID는 일반 BSUID를 대체하는 것이 아니라 추가로 제공되는 식별자입니다.

시나리오	Braze에서 사용하는 식별자
단일 비즈니스 포트폴리오	일반 BSUID
여러 개의 연결된 포트폴리오	상위 BSUID(권장). 상위 BSUID가 없으면 일반 BSUID 사용
여러 개의 연결되지 않은 포트폴리오	일반 BSUID(포트폴리오별로 고객 프로필이 중복될 수 있음)

자주 묻는 질문

기존 Campaigns와 Canvases가 중단되나요?

아니요. 기존 Campaigns와 Canvases는 계속 정상적으로 작동합니다. 사용자 이름을 사용하지 않는 사용자는 전혀 영향을 받지 않습니다. 사용자 이름을 사용하면서 비즈니스와 기존 대화 기록이 있는 사용자의 경우, Braze는 계속해서 전화번호를 기본 식별자로 사용합니다.

사용자 이름을 사용하는 사용자가 이미 비즈니스에 메시지를 보낸 적이 있다면 어떻게 되나요?

WhatsApp 연락처(Contact Book)가 활성화되어 있고 최근 30일 이내에 해당 사용자와 이전 대화가 있었거나 사용자에게 메시지를 보낸 적이 있다면, 해당 사용자의 전화번호는 웹훅 페이로드에 BSUID와 함께 계속 표시됩니다. Braze는 이 사용자를 기존 고객 프로필과 매칭합니다. 중복 프로필은 생성되지 않습니다.

사용자 이름을 사용하는 사용자가 비즈니스와 이전 대화가 없다면 어떻게 되나요?

Braze는 인바운드 웹훅에서 사용자의 BSUID를 수신한 후, 기존 고객 프로필과 매칭하거나(이전에 BSUID를 저장한 경우) BSUID를 사용자 별칭으로 저장한 새로운 익명 사용자 프로필을 생성합니다. 이후 해당 사용자는 Canvases에 진입하고, 아웃바운드 메시지를 수신하며, Braze의 표준 ID 확인 도구를 사용하여 식별되거나 다른 프로필과 병합될 수 있습니다.

Segments에서 BSUID 사용자를 타겟팅할 수 있나요?

BSUID 사용자는 완전한 Braze 고객 프로필이므로 표준 오디언스 필터(예: “WhatsApp 메시지를 수신함” 또는 구독 그룹 멤버십)를 통해 타겟팅할 수 있습니다. 단, BSUID 값을 기준으로 한 세분화(예: “BSUID 존재” 또는 “BSUID가 X와 같음”)는 지원되지 않습니다.

BSUID 사용자의 WhatsApp 요금은 어떻게 책정되나요?

WhatsApp 대화 요금은 사용자의 국가에 따라 결정됩니다. 전화번호로 식별된 사용자의 경우, Meta는 전화번호의 국가 코드에서 국가를 도출합니다. BSUID로 식별된 사용자의 경우, 국가 정보가 BSUID 자체에 직접 인코딩되어 있습니다. 예를 들어 US로 시작하는 BSUID는 미국에 있는 사용자를 나타냅니다.

즉, 사용자가 전화번호로 식별되든 BSUID로 식별되든 요금 책정 방식은 동일합니다. 대화 요금 계산에 사용되는 국가는 Meta가 제공하는 식별자에 따라 결정되며, Braze는 이를 수정 없이 그대로 전달합니다. 별도로 조치할 필요는 없지만, BSUID만 있는 사용자에게 메시지를 보낼 때는 Meta의 국가별 요금이 전화번호가 아닌 사용자의 BSUID에 인코딩된 국가를 기준으로 한다는 점에 유의하세요.

API 호출에서 BSUID 사용자를 어떻게 참조하나요?

user_alias 파라미터를 사용하고 alias_label: "whats_app_bsuid"를 지정한 후, alias_name을 사용자의 BSUID 값으로 설정하세요. 예를 들면 다음과 같습니다.

{
  "user_alias": {
    "alias_label": "whats_app_bsuid",
    "alias_name": "DDC91135R"
  }
}

이 방법은 users/track, users/identify, CSV 업로드 및 사용자 업데이트 캔버스 단계에서 사용할 수 있습니다.

Currents 데이터 파이프라인이 중단되나요?

WhatsApp용 Currents 이벤트에는 기존 전화번호 필드와 함께 bsuid 필드가 포함됩니다. BSUID만 있는 사용자의 경우 전화번호 필드는 비어 있습니다. 다운스트림 파이프라인에 전화번호 필드에 대한 엄격한 요구 사항이 있는 경우, null 값이나 빈 값을 처리할 수 있는지 확인하세요.

여러 비즈니스 포트폴리오에 걸쳐 여러 개의 WABA가 있습니다. 동일한 사용자가 Braze에서 두 개의 다른 프로필로 표시되나요?

포트폴리오가 연결되어 있지 않다면 그렇습니다. 동일한 WhatsApp 사용자라도 비즈니스 포트폴리오마다 다른 BSUID를 가지며, Braze는 각각에 대해 별도의 프로필을 생성합니다.

이 문제를 해결하려면 Meta 담당자에게 문의하여 포트폴리오 연결 자격을 확인하세요. 포트폴리오가 연결되면 Meta는 모든 포트폴리오에서 공유되는 상위 BSUID를 제공하며, Braze는 이를 사용하여 여러 WABA에서 사용자를 일관되게 식별합니다. 자세한 내용은 비즈니스 포트폴리오 및 상위 BSUID 연결을 참조하세요.

연락처(Contact Book)를 비활성화할 수 있나요?

연락처를 활성화된 상태로 유지할 것을 강력히 권장합니다. 연락처를 비활성화하면 사용자의 모든 과거 전화번호 기록이 손실됩니다. 그러면 사용자 이름을 사용하는 사용자는 이전에 메시지를 보낸 적이 있더라도 BSUID만 있는 새로운 사용자로 표시됩니다.

추가 리소스

팁

최신 WhatsApp 채널 업데이트는 릴리스 노트를 참조하세요.

New Stuff!