WhatsApp 임베디드 가입
임베디드 가입을 사용하여 Meta의 호스팅된 가입 플로를 통해 Braze를 WhatsApp Business 계정(WABA)에 연결할 수 있습니다.
WhatsApp 임베디드 가입 워크플로는 Braze 워크스페이스에 처음 WhatsApp을 통합할 때, 그리고 기존 통합에 WhatsApp Business 계정 또는 전화번호를 추가할 때 열립니다.
Braze 워크스페이스에 여러 WhatsApp Business 계정을 추가할 수 있습니다. 그러나 각 특정 WhatsApp Business 계정은 하나의 Braze 워크스페이스에만 추가할 수 있습니다.
워크플로 액세스
- 파트너 통합 > 기술 파트너로 이동합니다.
- WhatsApp을 검색하여 선택합니다.
- 사용 사례에 맞는 옵션을 선택합니다.
- 최초 통합: 통합 시작을 선택합니다.
- 추가 계정 또는 번호: WhatsApp 메시징 통합 페이지에서 계정 또는 번호 추가 또는 WhatsApp Business 계정 추가를 선택합니다.
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 Business 계정 연결 또는 생성. 새 계정을 생성하거나 사용하지 않는 기존 계정을 선택합니다. 다른 메시징 공급자에 현재 연결된 WhatsApp Business 계정은 선택하지 마세요. 해당 연결은 Braze에서 성공하지 않습니다. 다른 공급자로부터 번호를 마이그레이션하려면, 시작하기 전에 Braze 계정 팀에 문의하세요.
- 비즈니스 및 표시 세부 정보 제공. Meta가 WhatsApp Business 계정에 대해 요청하는 계정 이름, 표시 이름 및 카테고리를 입력합니다.
- 전화번호 인증. WhatsApp 메시징에 사용할 번호를 추가하고 문자 메시지 또는 전화 통화로 인증을 완료합니다.
Meta가 임베디드 가입을 완료하면 제어가 Braze로 돌아옵니다.
Braze 통합 완료하기
임베디드 가입이 끝나면 Braze가 설정 단계를 자동으로 진행합니다. Braze가 다음 작업을 수행하는 동안 WhatsApp 메시징 통합 페이지에 가입 흐름 완료, WhatsApp과의 통합 진행 중과 같은 진행 메시지가 표시될 수 있습니다.
- Meta에서 WhatsApp 비즈니스 계정 ID와 전화번호를 가져옵니다
- WhatsApp 비즈니스 계정에 Braze 시스템 사용자를 추가합니다
- 전화번호를 등록하고 웹훅 이벤트를 구독합니다
- 연결된 번호마다 Braze 구독 그룹을 생성합니다
메시지를 보내기 전에 통합이 완료될 때까지 기다리세요. 설정에 실패하면 통합 페이지에서 오류를 확인하고, 일반적인 안내는 WhatsApp 설정을 참조하세요.
문제 해결
자격이 없는 전화번호 선택
Meta 임베디드 가입 중에 전화번호가 Ineligible로 표시될 수 있습니다. Meta는 해당 번호가 Braze에 연결할 수 있는 상태가 될 때까지 전화번호 선택을 차단합니다. 다음 표에서는 번호가 차단될 수 있는 여러 원인과 차단을 해제하는 방법을 설명합니다.
| 원인 | 해결 방법 |
|---|---|
| 번호가 여전히 다른 Meta 개발자 앱에 등록되어 있음 | Meta for Developers 대시보드에서 이전에 WhatsApp API를 설정한 앱을 엽니다. WhatsApp > API Setup(또는 Getting Started)으로 이동하여 전화번호를 찾은 다음 해당 앱에서 제거합니다. 번호가 다른 WhatsApp Business Account(WABA)에서 실시간으로 사용 중인 경우, 번호를 사용할 수 있게 되기 전에 WhatsApp Manager에서 해당 계정의 번호도 제거해야 할 수 있습니다. |
| WhatsApp Business Account가 다른 솔루션 공급자와 공유됨 | WhatsApp Manager 설정에서 번호를 보유한 WABA가 Braze와만 공유되어 있는지, 또는 다른 메시징 공급자와 공유되지 않았는지 확인합니다. 다른 공급자가 액세스 권한을 가지고 있다면 해당 파트너 공유를 제거하거나 Braze에 연결된 WABA로 번호를 마이그레이션합니다. |
| Braze 파트너 액세스 누락 | WABA가 아직 Braze와 공유되지 않았다면, 가입 중에 Meta가 요청할 때 Braze를 전체 액세스 권한이 있는 파트너로 지정한 다음 전화번호 선택을 다시 시도합니다. |
충돌하는 등록 또는 파트너 공유를 해제한 후, Braze에서 임베디드 가입을 다시 시작하고 번호를 다시 선택하세요.