임베디드 가입
임베디드 가입은 인증 및 권한 부여를 위한 데스크톱 및 모바일 호환 인터페이스로, 비즈니스 고객을 WhatsApp Business 플랫폼으로 성공적으로 온보딩하는 데 필요한 자산을 쉽게 생성할 수 있도록 해줍니다.
임베디드 가입 플로는 비즈니스 고객으로부터 비즈니스 관련 정보를 수집하고, 플랫폼에서 요구하는 모든 WhatsApp 자산을 자동으로 생성하며, 이러한 자산에 대한 액세스 권한을 앱에 부여하므로 이를 통해 비즈니스 고객에게 WhatsApp 메시지 서비스를 빠르게 제공할 수 있습니다.
임베디드 가입을 통해 온보딩된 고객은 자신의 모든 WhatsApp 자산을 소유하고 이러한 자산을 다른 Meta 솔루션(예: WhatsApp 연결 광고)과 함께 활용할 수 있습니다.
사용 방법
임베디드 가입은 비즈니스용 Facebook 로그인 제품과 JavaScript SDK를 활용합니다. 임베디드 가입을 구성하고 나면 이 플로를 시작하는 웹사이트 또는 포털에 링크나 버튼을 추가할 수 있습니다.
링크나 버튼을 클릭하는 비즈니스 고객에게 새로운 창이 표시되고 이를 통해 다음과 같은 작업이 가능합니다.
- Facebook 또는 Meta 비즈니스 로그인 정보를 사용하여 신원을 인증합니다.
- 앱에 WhatsApp 자산에 대한 액세스 권한을 부여합니다.
- 기존 비즈니스 포트폴리오를 선택하거나 새로운 비즈니스 포트폴리오를 만듭니다.
- 기존 WhatsApp Business 계정(WABA)을 선택하거나 새 계정을 만듭니다.
- 비즈니스 전화번호를 입력하고 인증합니다(본인 소유 전화번호 또는 회원님이 제공한 전화번호).
- WhatsApp 클라이언트에서 전화번호 대신 표시할 수 있는 표시 이름을 입력합니다.
임베디드 가입이 성공적으로 완료되면 고객의 WABA ID, 비즈니스 전화번호 ID, 교환 가능한 토큰 코드가 플로를 시작한 창에 표시됩니다. 이 데이터를 서버로 보내서 서버 간 호출에 다음과 같은 용도로 사용해야 합니다.
- 고객 범위 비즈니스 토큰을 얻기 위해 코드를 교환합니다.
- 클라우드 API에 사용할 수 있도록 고객의 비즈니스 전화번호를 등록합니다.
- 앱이 고객의 WABA 계정에 대한 Webhooks를 구독하게 합니다.
- 고객에게 크레딧 라인을 공유합니다(솔루션 파트너 전용).
이러한 단계를 완료하고 나면 회원님이 솔루션 파트너이거나 솔루션 파트너와 협력하고 있을 경우 고객이 회원님의 앱 또는 회원님 파트너의 앱을 사용하여 즉시 메시지를 보낼 수 있습니다. 회원님이 솔루션 파트너가 아니거나 솔루션 파트너와 협력하고 있지 않을 경우 고객은 먼저 WABA에 결제 수단을 연결해야 메시지 전송을 시작할 수 있습니다.
제한 사항
온보딩 한도
기본적으로 연속 7일 동안 최대 10개의 신규 비즈니스 고객을 온보딩할 수 있습니다. 새로 온보딩된 고객만 이 한도에 반영됩니다. 현재 온보딩된 고객 수는 WhatsApp 관리자 > 파트너 개요 패널에서 확인할 수 있습니다. 이 한도에 가까워지면 이메일을 통해 알림을 받게 됩니다.
인증, 앱 검수, 액세스 인증을 완료하고 나면 연속 7일 동안 200개의 신규 비즈니스 고객을 온보딩할 수 있도록 한도가 자동으로 올라갑니다. 주당 200개를 초과하는 고객을 온보딩해야 하는 경우, Meta 비즈니스 파트너 자격을 신청하세요.
비즈니스 고객 메시지 한도
임베디드 가입을 통해 온보딩된 비즈니스 고객은 표준 메시지 한도로 시작할 수 있으며, 한도는 API 사용을 통해 높일 수 있습니다.
비즈니스 고객 전화번호 한도
- 비즈니스 전화번호는 클라우드 API에만 사용하도록 등록할 수 있습니다.
- 온프레미스 API에서 사용하도록 이미 등록되어 있거나 WhatsApp에서 사용 중인 비즈니스 전화번호는 지원되지 않습니다.
- WhatsApp Business 앱에서 이미 사용 중인 비즈니스 전화번호는 지원하지만 WhatsApp Business 앱 사용자 온보딩(즉, 'Coexistence')을 활성화하기 위한 플로를 맞춤 설정해야 합니다.
- 임베디드 가입을 통해 온보딩된 비즈니스 고객은 기본 비즈니스 전화번호 한도로 시작합니다.
액세스 토큰
임베디드 가입은 비즈니스 통합 시스템 사용자 액세스 토큰('비즈니스 토큰')을 생성합니다. 비즈니스 고객이 임베디드 가입 플로를 완료하면 교환 가능한 토큰 코드가 메시지 이벤트로 반환되고 JavaScript SDK에 캡처됩니다. 이 코드는 서버 간 호출을 사용하여 비즈니스 토큰으로 교환해야 합니다.
기술 제공업체인 경우, 비즈니스 토큰만 사용하게 됩니다.
솔루션 파트너인 경우, 시스템 사용자 액세스 토큰('시스템 토큰')을 사용하여 온보딩된 비즈니스 고객에게 크레딧 라인을 공유하고 비즈니스 토큰은 그 외의 다른 모든 용도에 사용합니다. 토큰이 나타내는 시스템 사용자는 앱에 business_management 권한을 부여하고 비즈니스 포트폴리오에서 관리자 또는 재무 정보 편집자 역할을 부여받은 후에 크레딧 라인을 공유할 수 있습니다.
권한
임베디드 가입은 비즈니스 고객에게 대부분의 권한을 요청하도록 구성할 수 있으나 다음과 같은 권한만 필요할 가능성이 높습니다.
- whatsapp_business_management - 앱이 온보딩된 고객의 WhatsApp Business 계정 설정과 메시지 템플릿에 액세스해야 하는 경우에 필요합니다.
- whatsapp_business_messaging - 앱이 온보딩된 고객 비즈니스 전화번호 설정에 액세스해야 하거나 고객이 메시지를 주고받는 데 앱을 사용할 경우에 필요합니다.
구현 과정에서 앱에 필요한 권한을 지정할 수 있습니다.
앱이 개발 모드인 동안에는 임베디드 가입의 권한 부여 화면에서 앱에 대해 관리자, 개발자 또는 테스터 역할이 부여된 모든 사람에게 이러한 권한이 표시됩니다. 그러나 앱을 라이브 모드로 전환하고 나면 앱 검수 절차를 통해 고급 액세스 권한을 승인받은 권한만 플로에 표시됩니다.
청구
솔루션 파트너
솔루션 파트너인 경우, 이미 크레딧 라인이 있고 Meta Business Suite의 비즈니스 설정 > 결제 패널에서 크레딧 할당 API 약관을 수락했어야 합니다. 또한 온보딩 과정에서 모든 고객에게 크레딧 라인을 공유해야 합니다.
기술 제공업체 및 기술 파트너
회원님이 기술 제공업체이거나 기술 파트너인 경우, 온보딩된 비즈니스 고객이 WhatsApp Business 계정에 결제 수단을 추가해야 합니다. WhatsApp Business 플랫폼 계정에 신용카드 추가 고객 센터 문서에 나와 있는 단계를 따르면 결제 수단을 추가할 수 있습니다.
샌드박스 계정
자신의 Facebook 계정으로 임베디드 가입 플로를 테스트할 수 있으나, 이 방법을 사용하면 비즈니스 포트폴리오, WABA, 비즈니스 전화번호가 추가될 수 있습니다. 테스트 데이터로 Facebook 계정이 복잡해지기를 원하지 않는다면 대신 샌드박스 테스트 계정을 요청하고 이를 사용하여 비즈니스 고객이 플로를 완료하는 작업을 시뮬레이션할 수 있습니다.
샌드박스 테스트 계정으로 플로를 완료하면 실제 고객이 플로를 완료한 것처럼 샌드박스 테스트 계정의 WABA ID, 비즈니스 전화번호 ID, 교환 가능한 토큰 코드가 반환됩니다.
샌드박스 계정 제한
- 샌드박스 계정은 30일 동안 유효하며 그 기간이 지나면 비활성화되므로 다시 사용하려면 다시 요청해야 합니다.
- 샌드박스 계정은 추가적인 샌드박스 비즈니스 포트폴리오, WABA 또는 비즈니스 전화번호를 만드는 데 사용할 수 없습니다. 자산은 자동으로 생성되어 임베디드 가입 플로에 표시됩니다.
- 샌드박스 계정은 앱 관리자와 연결됩니다. 샌드박스 계정의 자산이 임베디드 가입 플로에 표시되려면 앱 관리자가 Meta 개발자 계정에 로그인해야 합니다.
- 샌드박스 계정의 비즈니스 포트폴리오는 Meta Business Suite 또는 WhatsApp 관리자에 표시되지 않습니다.
- 반환된 토큰 코드를 샌드박스 계정의 비즈니스 토큰으로 교환하고 이를 사용하여 샌드박스 계정의 WABA ID에 대한 데이터를 가져올 수 있으나, 비즈니스 전화번호를 사용하여 메시지를 주고받을 수는 없습니다.
샌드박스 계정 소유권 요청
샌드박스 계정의 소유권을 요청하는 방법:
- 앱 대시보드 > WhatsApp > 빠른 시작 패널로 이동합니다.
- 테스트 통합 섹션을 찾습니다.
- 샌드박스 계정 소유권 요청 버튼을 클릭합니다.
샌드박스 계정 삭제
샌드박스 계정 삭제 기능은 2025년 6월 25일부터 몇 주에 걸쳐 점진적으로 출시됩니다.
테스트를 완료하고 테스트 환경을 깨끗하게 유지하고 싶다면 샌드박스 계정을 삭제하면 됩니다. 샌드박스 계정을 삭제하면 되돌릴 수 없으며, 관련 테스트 데이터도 모두 삭제됩니다. 샌드박스 계정을 실수로 삭제했는데 다시 테스트해야 하는 경우, 새로운 샌드박스 계정의 소유권을 요청해야 합니다.
샌드박스 계정을 삭제하는 방법:
- 앱 대시보드 > WhatsApp > 빠른 시작 패널로 이동합니다.
- 테스트 통합 섹션으로 이동해서 샌드박스 계정을 찾습니다.
- 샌드박스 계정의 계정 삭제 버튼을 클릭합니다.
555 비즈니스 전화번호
비즈니스 고객은 최대 2개의 555 비즈니스 전화번호 소유권을 요청할 수 있습니다. 이 전화번호는 (가격 책정 규칙, 품질 평가 등에 영향을 받되) 표준 비즈니스 전화번호와 동일한 방식으로 작동하지만 먼저 표시 이름 승인을 받아야 메시지를 보내는 데 사용할 수 있습니다. 또한 555 번호는 다음과 같은 특징이 있습니다.
- 미국 국가 전화 코드(+1) 사용
- 지역 코드 555 사용
- 자동으로 인증
- 다른 WhatsApp Business 계정으로 마이그레이션하거나 WhatsApp Business 플랫폼 외부에서 사용 불가
비즈니스 고객이 555 번호의 소유권을 요청할 수 있는 경우, 전화번호 추가 화면에서 555 전화번호를 선택하는 옵션을 자동으로 제공합니다.
자산 마이그레이션
임베디드 가입은 온보딩된 비즈니스 고객 자산을 여러 가지 방법으로 마이그레이션하는 데 사용될 수 있습니다. 비즈니스 고객 자산 마이그레이션을 참조하세요.
앱 검수
앱이 필수적인 각 권한에 대해 고급 액세스 권한을 승인받아야 비즈니스 고객을 온보딩할 수 있습니다.
앱 검수와 앱 검수 과정을 성공적으로 완료하기 위해 제공해야 하는 항목에 대한 자세한 내용은 앱 검수를 참조하세요.
통합 도우미
임베디드 가입 통합 도우미는 앱 대시보드 내의 설정 및 테스트 도구입니다. 이 도구를 사용하여 다음과 같은 작업을 할 수 있습니다.
- 여러 플로 구성에서 임베디드 가입 시작
- 비즈니스 고객이 플로를 완료할 때 반환되는 데이터 표시
- 구현 코드 및 온보딩 쿼리 생성(이 쿼리를 복사해서 웹사이트, 비즈니스 고객 포털, 서버에 붙여넣기 가능)
- 플로를 완료하는 고객을 온보딩할 때 사용해야 하는 엔드포인트로 API 쿼리 보내기
앱 대시보드 > WhatsApp > ES 통합으로 이동하여 통합 도우미에 액세스할 수 있습니다.
Webhooks
온보딩 과정에서 앱이 임베디드 가입 플로를 완료하는 각 비즈니스 고객의 WABA에 대한 Webhooks를 구독하도록 해야 합니다.
Webhooks가 트리거되고 구독한 Webhooks 필드에 따라 앱에 구성된 콜백 URL로 전송됩니다. 즉, 모든 온보딩된 비즈니스 고객에 대한 모든 Webhooks가 앱의 콜백 URL로 전송됩니다. 그러나 개별 WhatsApp Business 계정이나 비즈니스 전화번호에서 콜백 URL을 재정의할 수 있습니다. 자세한 방법은 Webhooks 재정의를 참조하세요.
현지화
임베디드 가입 플로는 30개 언어로 제공됩니다. 현지화된 플로는 비즈니스 고객이 Facebook에서 사용하는 언어에 따라 자동 트리거됩니다.
아랍어, 체코어, 덴마크어, 그리스어, 영어(영국), 스페인어(스페인), 스페인어, 핀란드어, 프랑스어(프랑스), 히브리어, 힌디어, 헝가리어, 인도네시아어, 이탈리아어, 일본어, 한국어, 노르웨이어(보크몰), 네덜란드어, 폴란드어, 포르투갈어(브라질), 포르투갈어(포르투갈), 루마니아어, 러시아어, 스웨덴어, 태국어, 튀르키예어, 베트남어, 중국어 간체(중국), 중국어 번체(홍콩), 중국어 번체(대만).
다음 단계
웹사이트 또는 포털에 임베디드 가입을 구현하는 방법을 알아보세요.