WhatsApp 구성 시작 whatsapp-config

이 페이지에서: WhatsApp API 자격 증명, 웹후크 및 채널 구성을 설정하여 WhatsApp 비즈니스 계정을 연결하면 사용자 환경에서 Journey Optimizer으로 WhatsApp 메시지를 보낼 수 있습니다.

WhatsApp 메시지를 보내기 전에 Adobe Journey Optimizer 환경을 구성하고 WhatsApp 계정과 연결해야 합니다. 다음을 수행하십시오.

이 단계는 Adobe Journey Optimizer 시스템 관리자가 수행해야 합니다.

WhatsApp API 자격 증명 만들기 whatsapp-credentials

  1. 왼쪽 레일에서 관리 > 채널(으)로 이동한 다음 API 자격 증명 메뉴를 선택하십시오. 새 API 자격 증명 만들기 단추를 클릭합니다.

  2. 아래에 자세히 설명된 대로 API 자격 증명을 구성합니다.

    • API 토큰: API 토큰을 입력하십시오. Meta 설명서에서 자세히 알아보기
    • 비즈니스 계정 ID: 비즈니스 포트폴리오와 관련된 고유 번호를 입력하십시오. 자세한 내용은 Meta 설명서를 참조하세요.

  3. 계속​을 클릭합니다.

  4. WhatsApp API 자격 증명에 연결할 WhatsApp 비즈니스 계정​을(를) 선택하십시오.

  5. WhatsApp 메시지를 보내는 데 사용되는 보낸 사람 이름​을(를) 선택하십시오.

  6. 전화 번호 설정이 자동으로 채워집니다.

    • 품질 평가: 지난 24시간 동안 보낸 메시지에 대한 고객 피드백을 반영합니다.

      • 녹색: 고품질
      • 노란색: Medium 품질
      • 빨강: 낮은 품질

      품질 평가에 대해 자세히 알아보기

    • 처리량: 전화 번호에서 메시지를 보낼 수 있는 속도를 나타냅니다.

  7. API 자격 증명 구성을 마치면 제출​을 클릭합니다.

API 자격 증명을 만들고 구성한 후에는 WhatsApp 메시지에 대한 웹후크를 만들어야 합니다. 자세히 알아보기

웹후크 만들기 WhatsApp-webhook

NOTE
지정된 옵트인 또는 옵트아웃 키워드가 없으면 표준 동의 메시지가 활성화되지 않습니다.

WhatsApp API 자격 증명이 정상적으로 생성되면 이제 웹후크를 다음과 같이 구성할 수 있습니다.

  • 옵트인 및 옵트아웃 동의 관리를 위한 인바운드 응답 캡처
  • 읽음 확인 메일(가능한 경우) 및 메시지 배달 상태와 같은 배달 보고서를 받습니다
  • Adobe Experience Platform 데이터 세트의 분석 및 보고를 위해 추적 이벤트 활성화
NOTE
인바운드 WhatsApp 메시지는 AJO 전자 메일 추적 데이터 세트 시스템 데이터 세트에 캡처됩니다. 이 데이터 세트에 수신 메시지를 캡처하려면 프로필에는 Journey Optimizer에서 전송한 하나 이상의 메시지가 있어야 합니다. 자세히 알아보기

Webhooks는 Meta의 WhatsApp Business Platform과 Adobe Journey Optimizer 간의 통신 브리지 역할을 하므로 메시지 이벤트 및 사용자 상호 작용에 대한 실시간 알림을 받을 수 있습니다.

Meta에서는 여러 샌드박스 또는 WhatsApp 자격 증명에서도 WhatsApp 비즈니스 계정당 하나의 웹후크, 콜백 URL 및 확인 토큰만 허용합니다. 피드백 이벤트(전송, 전달, 읽기, 오류, 단추 클릭)이 모든 샌드박스에서 계속 올바르게 캡처됩니다. 인바운드 이벤트(회신, 옵트인/옵트아웃/도움말 키워드)은 Webhook가 등록된 단일 샌드박스에서만 수신됩니다. 프로덕션 샌드박스​에 등록하여 인바운드 이벤트를 받으십시오.

  1. 왼쪽 레일에서 관리 > 채널(으)로 이동하고 WhatsApp 설정​에서 WhatsApp Webhooks 메뉴를 선택한 다음 Webhook 만들기 단추를 클릭합니다.

  2. Webhook의 이름​을(를) 입력하십시오.

  3. 구성 선택 드롭다운에서 이전에 만든 API 자격 증명을 선택합니다.

  4. 다음과 같은 인바운드 키워드 범주​을 선택합니다.

    • 옵트인 키워드
    • 옵트아웃 키워드
    • 도움말 키워드
    • 기본값 - 다른 키워드와 일치하지 않는 모든 인바운드 메시지에 대한 대체 범주. 이 범주를 사용하여 Adobe Experience Platform 데이터 세트에서 이벤트(열기, 게재 보고서) 추적을 활성화합니다.
  5. 키워드​를 입력하고 추가 를 클릭하세요.

  6. 회신 메시지 필드에서 구성된 키워드를 받을 때 보낸 메시지를 입력하거나 드롭다운 메뉴에서 미리 정의된 옵션을 선택합니다.

  1. 인바운드 키워드​을(를) 추가하려면 추가 를 클릭하십시오.

  2. WhatsApp Webhook 구성을 마치면 제출​을 클릭합니다.

  3. Webhooks 메뉴에서 bin 아이콘 을 클릭하여 WhatsApp Webhook를 삭제합니다.

  4. 기존 구성을 수정하고 Webhook URL 또는 Webhook Verify toker​에 액세스하려면 원하는 Webhook을 찾은 다음 편집 옵션을 클릭하여 필요한 내용을 변경하십시오.

  5. 여기에 생성된 Webhook Verify toker​를 복사한 다음 Webhook 설정의 일부로 Meta 인터페이스에 붙여넣습니다.

    이 인증 토큰을 추가하는 방법과 위치에 대한 자세한 지침은 Meta 설명서를 참조하세요.

  6. 이전에 제출한 WhatsApp Webhook​에서 새 Webhook URL​에 액세스하여 복사합니다.

이제 Webhook이 구성되었으므로 WhatsApp 구성을 만들 수 있습니다.

WhatsApp 구성 만들기 whatsapp-configuration

  1. 왼쪽 레일에서 관리 > 채널(으)로 이동한 다음 일반 설정 > 채널 구성​을 선택합니다. 채널 구성 만들기 단추를 클릭합니다.

  2. 구성의 이름 및 설명(선택 사항)을 입력한 다음 WhatsApp 채널을 선택합니다.

    note
    NOTE
    이름은 문자(A-Z)로 시작해야 합니다. 영숫자만 포함할 수 있습니다. 밑줄 _, 점 ., 하이픈 -도 사용할 수 있습니다.
  3. WhatsApp​을(를) 채널로 선택합니다.

    {width="80%"}

  4. 이 구성을 사용하여 동의 정책을 메시지에 연결하려면 마케팅 액션​을 선택하세요. 마케팅 액션과 관련된 모든 동의 정책은 고객의 선호도를 존중하기 위해 활용됩니다. 자세히 알아보기

  5. WhatsApp 설정 섹션에서 이전에 만든 WhatsApp 구성​을(를) 선택하십시오.

    {width="80%"}

  6. 통신에 사용할 발신자 전화 번호​을(를) 입력하십시오. 이 경우 옵트아웃 흐름이 제대로 작동하지 않을 수 있으므로 숫자 앞에 ‘+’ 기호를 포함하지 마십시오.

  7. WhatsApp 실행 필드​를 사용하여 데이터베이스에서 여러 번호를 사용할 수 있는 경우 우선 순위로 사용할 전화 번호를 프로필 특성 중에서 선택합니다. 자세히 알아보기

    note
    NOTE
    기본적으로 Journey Optimizer은(는) 샌드박스 수준의 일반 설정에 지정된 전화 번호를 사용합니다. 이 필드를 업데이트하면 이 구성을 사용하는 여정 및 캠페인에 대한 기본값이 재정의됩니다.
  8. 모든 매개 변수가 구성되면 제출​을 클릭하여 확인합니다. 채널 구성을 초안으로 저장하고 나중에 구성을 다시 시작할 수도 있습니다.

  9. 채널 구성이 만들어지면 목록에 처리 중 상태로 표시됩니다.

    note
    NOTE
    검사에 실패한 경우 이 섹션에서 가능한 실패 이유에 대해 자세히 알아보세요.
  10. 검사가 성공하면 채널 구성이 활성 상태가 됩니다. 메시지를 전달하는 데 사용할 준비가 되었습니다.

구성하고 나면 메시지 작성, 개인화, 링크 추적 및 보고와 같은 기본 제공 채널 기능을 모두 활용할 수 있습니다.

이제 Journey Optimizer에서 WhatsApp 메시지를 보낼 준비가 되었습니다.

WhatsApp 채널 설정 문제 해결 troubleshooting

API 자격 증명 설정 중 HTTP 500 오류 발생

WhatsApp API 자격 증명을 구성할 때 HTTP 500 오류가 발생하는 경우 다음 문제 해결 단계를 수행합니다.

  1. 권한 확인: 조직에 cjm_whatsapp 권한이 프로비저닝되어 있는지 확인합니다. 이 권한이 없으면 WhatsApp 채널을 구성할 수 없습니다.

  2. 비즈니스 계정 필드의 유효성 검사: 모든 필수 필드가 올바르게 채워졌는지 확인하십시오.

    • API 토큰: 적절한 권한이 있는 올바른 Meta 액세스 토큰이어야 합니다. 자세히 알아보기
    • 비즈니스 계정 ID: Meta 비즈니스 계정 ID와 정확히 일치해야 합니다. 자세히 알아보기
  3. 외부에서 자격 증명을 테스트하십시오: Meta API로 직접 자격 증명을 확인하여 자격 증명과 관련된 문제인지 Journey Optimizer 자격 증명을 처리하는 문제인지 확인하십시오.

  4. 고급 로깅 사용: 내부 서버 또는 인증 구성 오류를 식별하려면 Journey Optimizer 환경에서 고급 로그를 사용하여 API 호출 실패에 대한 자세한 정보를 제공합니다.

  5. 지원에 문의: 환경 및 권한이 유효하지만 HTTP 500 오류가 지속되는 경우 Adobe 담당자에게 문의하십시오.

사용 방법 비디오 video

아래 비디오에서는 Adobe Journey Optimizer에서 WhatsApp 채널을 설정하는 방법을 보여 줍니다.

recommendation-more-help
journey-optimizer-help