[Beta]{class="badge informative"}
Adobe Experience Platform을 사용하면 외부 소스에서 데이터를 수집하는 동시에 Experience Platform 서비스를 사용하여 수신 데이터를 구조화하고 레이블을 지정하며 개선할 수 있습니다. Adobe 애플리케이션, 클라우드 기반 스토리지, 데이터베이스 및 기타 여러 소스와 같은 다양한 소스에서 데이터를 수집할 수 있습니다.
Experience Platform은 스트리밍 애플리케이션에서 데이터를 수집할 수 있도록 지원합니다. 메시징 공급자에 대한 지원에는 WhatsApp이(가) 포함됩니다.
WhatsApp Business은(는) 기업이 WhatsApp을(를) 통해 고객과 통신하는 데 사용하는 메시징 플랫폼입니다. WhatsApp 원본은 고객이 WhatsApp Business 전화 번호로 보내는 인바운드 메시지를 거의 실시간으로 Experience Platform으로 스트리밍합니다.
Meta은 각 메시지를 Platform 스트리밍 끝점(웹후크)에 전달합니다. 여기서 이 끝점은 원시 경험 이벤트 레코드로 캡처되고 다운스트림용으로 데이터 레이크의 데이터 세트에 추가됩니다. 커넥터가 원시 Webhook 페이로드를 그대로 수집하므로 모든 WhatsApp 메시지 유형이 유지됩니다.
커넥터 작동 방식 how-it-works
WhatsApp 원본은 이 시퀀스를 따라 메시지를 Experience Platform으로 가져옵니다.
- 고객이 WhatsApp Business 전화 번호로 메시지를 보냅니다.
- Meta은 Webhook 페이로드에 앱 암호(
X-Hub-Signature-256)를 서명하여 Platform 스트리밍 끝점에 구성한 콜백 URL로 보냅니다. - Platform은 서명을 확인하고 원시 페이로드를 경험 이벤트로 캡처하여 WhatsApp 데이터 세트에 추가합니다.
사전 요구 사항 prerequisites
WhatsApp 소스 연결을 만들기 전에 developers.facebook.com의 Meta에서 다음을 완료하십시오.
- 비즈니스 유형의 Meta 앱을 만든 다음 WhatsApp 제품을 추가합니다.
- 등록된 전화 번호로 WABA(비즈니스 계정) WhatsApp을(를) 만듭니다.
- 앱에
whatsapp_business_management및whatsapp_business_messaging권한이 있는지 확인하십시오. - 앱 설정 > 기본에서 앱 암호를 복사합니다. Meta은 앱 비밀을 사용하여 웹후크 페이로드를 서명합니다.
- 확인 토큰을 선택합니다. 임의의 문자열일 수 있으며, Platform과 Meta 모두에서 입력하는 공유 비밀입니다.
다음 표에서는 각 자격 증명을 찾을 수 있는 위치와 해당 자격 증명을 사용하는 용도에 대해 설명합니다.
X-Hub-Signature-256 서명을 확인하는 중입니다.WABA에 앱 구독 subscribe-app
Meta 앱을 WhatsApp 비즈니스 계정에 구독하면 Meta에서 WABA의 이벤트를 앱으로 라우팅합니다. 이 단계는 필수이며 전적으로 Meta에서 수행되지만, 콜백 URL을 구성한 후에만 게재가 시작됩니다. WhatsApp 비즈니스와 Experience Platform 연결을 참조하십시오.
Graph API를 사용하여 앱 구독:
POST https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps
다음을 사용하여 구독 확인:
GET https://graph.facebook.com/{VERSION}/{WHATSAPP_BUSINESS_ACCOUNT_ID}/subscribed_apps
두 호출 모두 whatsapp_business_management 권한이 있는 토큰과 WABA에 대한 액세스 권한이 필요합니다. {VERSION}을(를) 현재 Graph API 버전(예: v21.0 이상)으로 바꾸십시오.
커넥터가 자동으로 프로비저닝하는 내용 automatic-provisioning
WhatsApp 데이터 흐름 만들기가 완료되면 커넥터가 다음 엔터티를 만들고 연결합니다. 타겟 데이터 세트를 선택하거나 필드를 직접 매핑하지 않습니다.
X-Hub-Signature-256 서명 유효성 검사와 확인 토큰 핸드셰이크를 적용합니다.암호 회전 rotate-secrets
연결을 업데이트하여 언제든지 앱 암호 또는 확인 토큰을 회전할 수 있습니다. 플랫폼은 가동 중지 시간 없이 앱 암호를 롤링할 수 있도록 기본 및 보조 암호를 지원합니다. 전환 중에 이전 값을 보조 암호로 유지하면서 새 값을 기본 암호로 추가합니다. 연결을 업데이트하면 해당 연결을 사용하는 모든 데이터 흐름에 변경 사항이 적용됩니다.
문제 해결 troubleshooting
다음 표에서는 일반적인 문제와 해결 방법을 설명합니다.
Experience Platform에 WhatsApp 연결 connect-to-platform
아래 설명서는 사용자 인터페이스를 사용하여 Experience Platform에 연결할 WhatsApp 스트리밍 커넥터를 만드는 방법에 대한 정보를 제공합니다.