WhatsApp 사용자 이름 및 BSUID: OTP, CRM 및 웹훅의 변경 사항

비즈니스 범위의 사용자 ID(BSUID)는 Meta가 모든 WhatsApp 웹훅에 포함하는 식별자로, 기업이 사용자의 전화번호를 알지 못해도 메시지를 보낼 수 있게 해줍니다. 이는 WhatsApp이 사용자 이름을 도입함에 따라 생성되었습니다. 사용자가 사용자 이름을 활성화하면, 최근에 연락을 주고받지 않은 기업은 더 이상 사용자의 전화번호를 받지 못할 수도 있습니다. BroadNet 엔지니어링 팀에서 제공하는 이 가이드는 데이터 형식, 타임라인, 여전히 전화번호가 필요한 경우, 그리고 웹훅, CRM 기록 및 OTP 흐름을 마이그레이션하는 방법을 설명합니다.

핵심 요약

• 2026년 4월 초부터 모든 사용자를 대상으로 WhatsApp 웹훅에 BSUID가 나타나기 시작했으며, 이는 사용자의 사용자 이름 사용 여부와 관계없이 적용됩니다.
• BSUID의 형식은 US.13491208655302741918와 같습니다. 즉, ISO 3166 알파-2 국가 코드, 마침표(.), 그리고 최대 128자의 영문 및 숫자 조합으로 구성됩니다.
• 이는 각 기업 포트폴리오와 사용자 쌍에 대해 고유하며, 사용자가 전화번호를 변경하면 재생성됩니다.
• 2026년 7월부터 BSUID로 메시지를 보낼 수 있습니다. 단, 원탭(one-tap), 제로탭(zero-tap) 및 코드 복사 인증 템플릿은 여전히 전화번호가 필요합니다.
• Meta에 따르면, 사용자 이름 기반 사용자의 메시지 처리 능력을 상실하지 않으려면 파트너 및 직접 연동된 기업은 반드시 BSUID를 지원해야 합니다.
• 인증된 E.164 전화번호를 OTP, SMS 대체 발송 및 사기 방지 확인을 위한 신원 앵커로 유지하십시오. BSUID는 WhatsApp 채널 키로 취급하십시오.

비즈니스 범위 사용자 ID란 무엇입니까?

Meta는 "전화번호를 모를 때 WhatsApp 사용자에게 메시지를 보낼 수 있는 고유 사용자 식별자"(Meta, 비즈니스 범위 사용자 ID)로 BSUID를(를) 정의합니다. 형식은 사용자의 국가를 ISO 3166 alpha-2 코드로 표기하고, 마침표(.)를 찍은 뒤, 최대 128자의 영문 및 숫자 조합으로 구성됩니다. 예: US.13491208655302741918.

시스템 설계 시 고려해야 할 세 가지 속성은 다음과 같습니다:

• 범위(Scope). BSUID는 하나의 비즈니스 포트폴리오와 하나의 사용자에게 고유합니다. 동일한 인물이라도 대화하는 비즈니스 포트폴리오마다 서로 다른 BSUID를 가지므로, 관련 없는 포트폴리오 간에 고객을 매칭하는 용도로 사용할 수 없습니다.
• 안정성(Stability). 사용자가 전화번호를 변경하면 BSUID가 재생성됩니다. 이 경우 Meta는 user_changed_user_id 유형의 시스템 메시지 웹훅과 별도의 user_id_update 웹훅을 전송합니다.
• 상위 BSUID. 여러 포트폴리오를 보유한 관리형 비즈니스는 Meta 담당자에게 상위 BSUID 등록을 요청할 수 있습니다. 상위 BSUID에는 ENT(예: US.ENT.11815799212886844830)가 포함되며, 등록된 모든 포트폴리오에 걸쳐 작동합니다.

WhatsApp에서 사용자 이름을 도입하는 이유는 무엇인가요?

개인정보 보호를 위해, Meta는 2026년 6월 29일에 사용자가 "올해 말"에 사용할 사용자 이름을 예약할 수 있으며, 사용자가 사용자 이름을 설정하면 처음 메시지를 보내는 개인이나 기업이 더 이상 해당 사용자의 전화번호를 볼 수 없다고 발표했습니다 (Meta 정보). Meta의 개발자 문서에 따르면 사용자 이름 기능은 2026년에 점진적으로 출시될 예정입니다.

기업도 사용자 이름을 가질 수 있습니다. 2026년 6월 29일부터 기업은 WhatsApp Manager, Meta Business Suite 또는 Username API를 통해 WhatsApp이 예약한 사용자 이름을 신청할 수 있으며, 승인된 사용자 이름은 해당 기능이 출시될 때 활성화됩니다. 기업 사용자 이름은 기업의 전화번호를 숨기지 않습니다.

일정은 어떻게 되나요?

고객의 전화번호를 더 이상 알 수 없게 되나요?

경우에 따라 그렇습니다. 모든 메시지 웹훅에는 BSUID가 표시됩니다. Meta에 따르면, 전화번호(wa_id 및 인바운드 메시지의 from 필드)는 다음 조건 중 하나라도 충족되는 경우에만 포함됩니다:

• 웹훅이 트리거되기 전 30일 이내에 사용자의 전화번호로 메시지를 보내거나 전화를 건 경우;
• 해당 30일 이내에 사용자의 전화번호로부터 메시지나 전화를 받은 경우, 또는
• 사용자가 귀하의 연락처에 등록되어 있는 경우.

30일간의 조회 기록은 비즈니스 전화번호별로 평가되므로, 영업 라인에서 인지하고 있는 고객이 지원 라인에서는 인지되지 않을 수 있습니다. 연락처 북은 Meta에서 호스팅하는 기능으로, 첫 상호작용 이후 전화번호와 BSUID를 저장하므로 사용자가 사용자 이름을 채택한 후에도 이후의 웹훅에서 해당 번호를 계속 유지할 수 있습니다. 이 기능은 기본적으로 활성화되어 있으며, Meta Business Suite의 비즈니스 설정 > 비즈니스 정보 메뉴에서 끌 수 있습니다. 특별한 이유가 없다면 이 기능을 켜두시기 바랍니다.

여전히 전화번호가 필요한 항목은 무엇인가요?

Meta의 규정은 명확합니다: BSUID는 "사용자의 전화번호가 필요한 원탭(one-tap), 제로탭(zero-tap), 코드 복사 인증 템플릿을 제외한 모든 유형의 메시지를 보내는 데 사용할 수 있습니다". WhatsApp 외에도 모바일 네트워크에서 실행되는 모든 항목은 전화번호가 필요합니다.

웹훅의 변경 전후 모습은 어떻게 다른가요?

BSUID 이전에는 메시지 웹훅의 contacts 블록에 wa_id 형식으로 전화번호가 포함되었으며, 대부분의 연동 방식에서는 이를 고객 키로 사용했습니다. Meta의 새로운 contacts 객체 예시를 보면 사용자 이름, BSUID, 그리고 활성화된 경우 부모 BSUID가 추가되었습니다. wa_id은 번호 공유가 가능한 경우에만 포함됩니다.

1"contacts": [
2  {
3    "profile": {
4      "name": "<USER_DISPLAY_NAME>",
5      "username": "<USERNAME>"
6    },
7    "wa_id": "<USER_PHONE_NUMBER>",
8    "user_id": "<BSUID>",
9    "parent_user_id": "<PARENT_BSUID>"
10  }
11]

수신 메시지에도 from_user_id(및 활성화 시 from_parent_user_id)이 포함되며, 상태 웹훅에는 recipient_user_id가 포함됩니다. Meta에 따르면 recipient_user_id는 항상 사용자의 BSUID로 설정됩니다. 메시지를 발송하려면 새로운 수신자(recipient) 파라미터에 BSUID를 입력하세요. to 파라미터(전화번호), 수신자(recipient) 파라미터(BSUID), 또는 둘 다 설정할 수 있습니다. 두 파라미터가 모두 있는 경우 전화번호가 우선 적용됩니다.

1{
2  "messaging_product": "whatsapp",
3  "recipient_type": "individual",
4  "recipient": "<BSUID>",
5  "type": "text",
6  "text": {
7    "body": "<BODY_TEXT>"
8  }
9}

발송 응답의 contacts 배열에는 user_id이 포함되며, wa_id은 선택 사항이 됩니다. 만약 파서(parser)가 wa_id가 항상 존재한다고 가정하도록 설계되어 있다면, 첫 번째 사용자 이름 사용 시 오류가 발생할 수 있습니다. 웹훅 페이로드 검사기에 실제 페이로드를 붙여넣어 귀사의 연동 시스템이 실제로 어떤 필드를 수신하는지 확인할 수 있습니다.

OTP의 경우 무엇이 문제가 되나요?

원탭(one-tap), 제로탭(zero-tap) 또는 코드 복사 버튼이 포함된 인증 템플릿은 BSUID로 발송할 수 없습니다. 사용자 이름 사용자가 WhatsApp을 통해 연락해 왔으나 해당 사용자의 전화번호를 보유하고 있지 않다면, 해당 유형의 WhatsApp OTP를 보낼 수 없습니다. 이는 인증 프로세스에 두 가지 영향을 미칩니다:

• 가입 시 전화번호를 E.164 형식으로 수집 및 검증하고, 이를 계정의 인증 주소로 저장하세요. 나중에 WhatsApp 웹훅이 번호를 전달해 줄 것이라고 기대해서는 안 됩니다. E.164란 무엇인가를 참조하세요.
• 전화번호 자체로 작동하는 채널을 유지하세요. SMS OTP, 음성 OTP 및 무음 네트워크 확인은 모두 전화번호를 기반으로 작동하므로, 자동 대체 발송(fallback) 기능이 포함된 멀티채널 설계는 이번 변경 사항에도 영향을 받지 않고 그대로 유지됩니다. 당사의 멀티채널 OTP 가이드와 BroadNet OTP 제품에서 이 패턴을 다루고 있습니다.

CRM 및 고객 중복 제거 시 발생하는 문제는 무엇인가요?

대부분의 CRM은 SMS, 음성, WhatsApp이 모두 전화번호를 공유했기 때문에 WhatsApp 연락처의 키 값을 전화번호로 설정합니다. 사용자 이름 다음에는 BSUID만 포함된 새로운 인바운드 연락처가 도착할 수 있습니다. 이 경우 새로운 CRM 레코드를 생성하면 고객 데이터가 점차 중복됩니다. 데이터를 깨끗하게 유지하기 위한 네 가지 규칙은 다음과 같습니다:

1. 1BSUID를 고객 ID가 아닌 채널 식별자로 모델링하세요. 한 명의 고객은 여러 개의 BSUID(비즈니스 포트폴리오당 하나)을 보유할 수 있으며, 번호 변경 후에는 새로운 BSUID가 생성될 수 있습니다.
2. 2BSUID, 포트폴리오, 확인 가능한 전화번호, 최초 확인 및 최종 확인 시점을 포함하는 매핑 테이블을 유지하고, user_id_update을 포함한 모든 웹훅 발생 시 이를 업데이트하세요.
3. 3추측이 아닌 확실한 근거에 따라 병합하세요. 예: 인증된 전화번호, 로그인 정보 또는 고객이 채팅에서 제공한 주문 참조 번호.
4. 4wa_id이 없다고 해서 새로운 고객으로 처리하지 마세요. 이는 해당 이벤트에서 번호를 공유할 수 없음을 의미할 뿐입니다.

마이그레이션 방법은 무엇인가요? 단계별 체크리스트

1. 1웹훅 파서를 업데이트하여 user_id, from_user_id, recipient_user_id 및 username을 읽도록 하고, wa_id 및 from은 선택 사항으로 처리하도록 설정하세요.
2. 2WhatsApp 연락처를 저장하는 모든 곳에 BSUID 컬럼(관리형 비즈니스의 경우 상위 BSUID 포함)을 추가하세요.
3. 3백필(Backfill): 2026년 4월 초 이후의 모든 인바운드 이벤트에 대해, BSUID를 이미 보유하고 있는 전화번호와 연결하세요.
4. 4새로운 BSUID를 고객과 다시 연결하여 user_changed_user_id 시스템 메시지와 user_id_update 웹훅을 처리하세요.
5. 5전송 경로에 수신자 파라미터를 추가하고, 전화번호가 없는 경우 해당 파라미터를 대체 발송(fallback)으로 사용하세요.
6. 6OTP는 전화번호로 전송하고 BSUID로는 절대 전송하지 마십시오. 또한 SMS 또는 음성을 대체 채널로 유지하세요.
7. 7WhatsApp Manager, Meta Business Suite 또는 Username API를 통해 비즈니스 사용자 이름을 예약하세요.
8. 8사용자 이름이 고객에게 전달되기 전에 사용자 이름 기능이 활성화된 계정으로 테스트하세요.

BroadNet이 귀사의 WhatsApp 제공업체인 경우, 운영 코드를 변경하기 전에 테스트 권한을 요청하고 귀하의 계정 웹훅에 BSUID 필드가 어떻게 표시되는지 확인하세요. 당사의 개발자 허브와 WhatsApp Business API 페이지에 자세한 내용이 있으며, 옴니채널 라우팅을 통해 현재 인증 프로세스에서 필수적인 SMS 대체 발송을 처리할 수 있습니다.

자주 묻는 질문

WhatsApp BSUID란 무엇인가요?

기업 범위의 사용자 ID입니다. Meta가 각 비즈니스 포트폴리오의 각 WhatsApp 사용자에게 할당하는 식별자로, 이를 통해 기업은 사용자의 전화번호를 알지 못해도 메시지를 보낼 수 있습니다. 웹훅에서는 user_id로 표시됩니다.

BSUID는 어떤 형태인가요?

ISO 3166 알파-2 국가 코드, 마침표(.), 그리고 최대 128자의 영문 및 숫자 조합으로 구성됩니다. 예: US.13491208655302741918. 관리형 비즈니스의 상위 BSUID에는 ENT가 포함됩니다. 예: US.ENT.11815799212886844830.

사용자가 사용자 이름을 설정하면 고객의 전화번호를 더 이상 알 수 없게 되나요?

일부 웹훅에서만 해당됩니다. 지난 30일 이내에 해당 번호로 메시지나 통화를 주고받았거나, 사용자가 연락처에 등록되어 있는 경우에는 번호가 여전히 포함됩니다. 그렇지 않은 경우 wa_id은 생략되며 BSUID만 수신하게 됩니다.

BSUID로 메시지를 보낼 수 있나요?

네, 2026년 7월부터 API 전송 시 수신자 파라미터를 사용하여 가능합니다. 사용자의 전화번호가 필요한 원탭(one-tap), 제로탭(zero-tap), 코드 복사 인증 템플릿을 제외한 모든 메시지 유형에서 작동합니다.

BSUID로 인증(OTP) 템플릿을 보낼 수 있나요?

아니요. 원탭, 제로탭 및 코드 복사 인증 템플릿은 전화번호가 필요합니다. 모든 계정에 인증된 전화번호를 유지하고, 대체 발송으로 SMS 또는 음성 OTP를 사용하세요.

BSUID가 비즈니스 포트폴리오 간에 공유되나요?

아니요. BSUID는 하나의 비즈니스 포트폴리오와 사용자 쌍에 고유하게 할당됩니다. 관리형 비즈니스의 경우 Meta에 상위 BSUID에 대해 문의할 수 있으며, 상위 BSUID는 함께 등록된 포트폴리오 간에 공유됩니다.

BSUID가 변경될 수도 있나요?

네. 사용자가 전화번호를 변경하면 BSUID가 재생성되며, Meta는 user_changed_user_id 시스템 메시지와 user_id_update 웹훅을 통해 이를 알립니다.

비즈니스 사용자 이름을 예약하려면 어떻게 해야 하나요?

2026년 6월 29일부터 WhatsApp Manager, Meta Business Suite 또는 사용자 이름 API를 통해 가능합니다. 승인된 사용자 이름은 해당 기능이 출시되면 활성화되며, 비즈니스 전화번호를 숨기지 않습니다.

출처

• 개발자를 위한 Meta, 비즈니스 범위 사용자 ID (형식, 타임라인, 웹훅 필드, 연락처, 전송 파라미터, 인증 템플릿 예외 사항), 2026년 9월 26일 접속.
• Meta 정보, 지금 WhatsApp 사용자 이름을 예약하세요, 2026년 6월 29일, 2026년 9월 26일 접속.