WhatsApp 임베디드 가입
임베디드 가입을 사용하여 Meta의 호스팅된 가입 플로를 통해 Braze를 WhatsApp Business 계정(WABA)에 연결할 수 있습니다.
WhatsApp 임베디드 가입 워크플로는 Braze 워크스페이스에 처음 WhatsApp을 통합할 때, 그리고 기존 통합에 WhatsApp Business 계정 또는 전화번호를 추가할 때 열립니다.

Braze 워크스페이스에 여러 WhatsApp Business 계정을 추가할 수 있습니다. 그러나 각 WhatsApp Business 계정은 하나의 Braze 워크스페이스에만 추가할 수 있습니다.
워크플로 액세스
- 파트너 통합 > 기술 파트너로 이동합니다.
- WhatsApp을 검색하여 선택합니다.
- 사용 사례에 맞는 옵션을 선택합니다.
- 최초 통합: 통합 시작을 선택합니다.
- 추가 계정 또는 번호: WhatsApp 메시징 통합 페이지에서 계정 또는 번호 추가 또는 WhatsApp 비즈니스 계정 추가를 선택합니다.
두 진입점 중 어디에서 시작하든 Meta 임베디드 가입 흐름은 동일합니다. 구성에 따라 워크스페이스에 네이티브 통합 또는 BYO 커넥터 - Infobip과 같은 통합 탭이 표시될 수도 있습니다. 시작하기 전에 설정에 맞는 탭을 선택하세요.
가입 준비
통합 시작을 선택하면 Braze에서 온보딩 창이 열립니다. 각 슬라이드를 검토한 다음 통합 시작을 다시 선택하여 Meta 임베디드 가입을 시작하세요.
시작하기 전에 다음 사항을 준비하세요.
- Meta Business Manager 액세스 권한: 대부분의 기업은 Meta Business Manager를 사용하여 Facebook 페이지, 광고 및 관련 비즈니스 자산을 관리합니다. 액세스 권한이 없는 경우 관리자에게 권한 부여를 요청하거나 가입 과정에서 Business Manager 계정을 만드세요.
- 전화번호: Meta의 WhatsApp 전화번호 요구 사항을 충족하는 번호를 사용하세요. 가입 과정에서 문자 메시지 또는 전화로 일회성 인증 코드를 받게 됩니다.

초기 임베디드 가입은 통합 경로당 한 번만 완료하므로 비즈니스 세부 정보를 최대한 정확하게 입력하세요.
WhatsApp 임베디드 가입 워크플로
Braze가 Meta 임베디드 가입을 실행한 후, 회사의 Business 매니저에 액세스할 수 있는 Meta 계정으로 로그인합니다. Meta가 가입 화면을 호스팅하며, Braze는 해당 레이아웃이나 레이블을 제어하지 않습니다.

일반적으로 Meta는 다음 단계를 안내합니다.
- 로그인 및 권한 부여. Meta로 인증하고 Braze가 WhatsApp Business 계정에 연결할 수 있도록 허용합니다.
- 비즈니스 포트폴리오 선택. WhatsApp Business 계정을 소유할 Business 매니저 포트폴리오를 연결합니다. 예상한 포트폴리오가 보이지 않으면 Meta 권한을 확인하세요.
- WhatsApp 계정 연결 또는 생성. 새 계정을 생성하거나 이미 전화번호를 보유하고 있는 WhatsApp 계정을 선택합니다. 해당 번호가 이미 다른 공급자에서 사용 중이라면, 번호를 이전하는 대신 해당 WhatsApp 계정을 Braze와 공유할 수 있습니다.
- 비즈니스 및 표시 세부 정보 제공. Meta가 WhatsApp Business 계정에 대해 요청하는 계정 이름, 표시 이름 및 카테고리를 입력합니다.
- 전화번호 인증. WhatsApp 메시징에 사용할 번호를 추가하고 문자 메시지 또는 전화 통화로 인증을 완료합니다.
Meta가 임베디드 가입을 완료하면 제어가 Braze로 돌아옵니다.
Braze 통합 완료하기
임베디드 가입이 끝나면 Braze가 설정 단계를 자동으로 실행합니다. Braze가 다음 작업을 진행하는 동안 WhatsApp Messaging Integration 페이지에 Sign-up flow completed, integration with WhatsApp in progress와 같은 진행 메시지가 표시될 수 있습니다.
- Meta에서 WhatsApp 비즈니스 계정 ID와 전화번호를 가져옵니다.
- WhatsApp 비즈니스 계정에 Braze 시스템 사용자를 추가합니다.
- 전화번호를 등록하고 웹훅 이벤트를 구독합니다.
- 연결된 각 번호에 대해 Braze 구독 그룹을 생성합니다.
메시지를 보내기 전에 통합이 완료될 때까지 기다려 주세요. 설정에 실패하면 통합 페이지에서 오류를 확인하고, 일반적인 안내는 WhatsApp 설정을 참조하세요.
문제 해결
사용할 수 없는 전화번호 선택
Meta 임베디드 가입 중에 전화번호가 Ineligible로 표시될 수 있습니다. Meta는 해당 번호를 Braze에 연결할 수 있는 상태가 될 때까지 선택을 차단합니다. 다음 표에서 번호가 차단되는 여러 원인과 차단을 해제하는 방법을 확인할 수 있습니다.
| 원인 | 해결 방법 |
|---|---|
| 번호가 아직 다른 Meta 개발자 앱에 등록되어 있음 | Meta for Developers 대시보드에서 이전에 WhatsApp API를 설정했던 앱을 엽니다. WhatsApp > API Setup(또는 Getting Started)으로 이동해 해당 전화번호를 찾은 다음 그 앱에서 제거합니다. 번호가 다른 WhatsApp 비즈니스 계정(WABA)에서 실시간으로 사용 중이라면, 번호를 사용할 수 있게 되기 전에 WhatsApp Manager에서 해당 계정으로부터도 번호를 제거해야 할 수 있습니다. |
| WhatsApp 계정을 다른 솔루션 공급자와 공유 중임 | Meta의 새로운 계정 모델에서는 WhatsApp 계정을 다른 공급자와 공유할 수 있습니다. 연결에 사용하는 메시징 계정에 Braze가 액세스할 수 있는지 확인한 다음 전화번호를 다시 선택해 보세요. 기존 WhatsApp 전화번호 사용하기를 참조하세요. |
| Braze 파트너 액세스 권한 없음 | WhatsApp 계정이 아직 Braze와 공유되지 않았다면, 가입 중 Meta에서 안내할 때 Braze를 파트너로 지정한 다음 전화번호를 다시 선택해 보세요. |
충돌하는 등록이나 파트너 공유를 해제한 후, Braze에서 임베디드 가입을 다시 시작하고 번호를 다시 선택하세요.