WhatsApp과의 대화형 통합(WhatsApp 클라우드 API) 설정

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 6분

    • 요청자를 봇 대화에 참여시킬 수 있도록 애플리케이션을 설정합니다 WhatsApp과의 대화형 통합(WhatsApp 클라우드 API) . 와 ServiceNow가상 에이전트 통합하면 라이브 에이전트와 가상 에이전트 채팅 시 WhatsApp 상호작용할 수 있습니다.

    시작하기 전에

    시작하기 전에 다음을 수행합니다.
    • 다음 제품 및 애플리케이션에 대한 권리를 얻습니다 ServiceNow .
      • 통합 허브
      • WhatsApp과의 대화형 통합(WhatsApp 클라우드 API)

      자세한 내용은 다음을 참조하십시오. 에 대한 권리 가져오기 ServiceNow 제품 또는 애플리케이션.

    • 인스턴스에 ServiceNow 다음 애플리케이션을 설정합니다.
      • 통합 허브
      • WhatsApp과의 대화형 통합(WhatsApp 클라우드 API)

    필요한 역할: external_app_install_admin 또는 va_admin

    프로시저

    1. 메타 개발자 계정 및 Facebook 비즈니스 계정에 설정이 필요합니다.
      1. WhatsApp Cloud API 시작하기 가이드의 전제 조건과 1단계를 완료하여 Meta 개발자 앱을 만드세요.
      2. 앱 비밀을 복사합니다.
        • 메타 애플리케이션 대시보드에서 앱 설정 > 기본.
        • 앱 비밀을 기록해 둡니다.

          나중에 이 토큰을 사용하여 인스턴스에서 계정을 인증 WhatsApp 합니다 ServiceNow .

      3. 전화 번호 ID 복사:
        • 다음으로 이동 WhatsApp > API 설정.
        • 메시지 보내기 및 받기 섹션의 보낸 사람 드롭다운 목록에서 WhatsApp 지원 전화번호를 선택합니다.

          인스턴스에서 제공자 기록을 구성하려면 이 ID가 ServiceNow 필요합니다.

      4. Meta 비즈니스 관리자에서 시스템 사용자 액세스 토큰을 생성합니다.

      시스템 사용자 액세스 토큰을 만드는 방법에 대한 자세한 내용은 시스템 사용자 액세스 토큰 생성을 참조하세요. 접근 토큰을 생성하는 동안 필요한 권한을 부여하고 접근 토큰을 복사합니다.

      인스턴스에서 토큰 검증 기록 ServiceNow 을 구성하려면 이 토큰이 필요합니다.

    2. 인스턴스에서 ServiceNow 메시지를 WhatsApp 받으려면 웹후크 URL을 확인하고 구성합니다.
      1. 탐색 필터에 sys_properties.list를 입력합니다.
      2. 속성을 찾아 엽니다 sn_va_whatsapp.webhook_verify_token .
      3. 값 필드에 선택한 암호 또는 비밀을 입력합니다.
      4. 저장을 선택합니다.
      5. Meta 개발자 콘솔에서 WhatsApp > 구성 > WhatsApp 구성.
      6. 웹후크 섹션의 콜백 URL 필드에 https://<instance-name>.service-now.com/api/sn_va_whatsapp/va_whatsapp_adapter 형식으로 URL을 입력합니다.
      7. 토큰 확인 필드에 (c) 단계의 인스턴스에서 ServiceNow 구성한 암호 선택을 입력합니다.
      8. 확인 및 저장을 선택합니다.
      9. 웹후크 필드 섹션에서 구독 토글 스위치를 활성화하여 메시지를 구독합니다.
    3. 계정에서 WhatsApp 들어오는 해시 메시지를 인증하려면 인증 토큰을 저장하는 해시 메시지 검증 기록을 생성합니다.
      1. 인스턴스의 ServiceNow 탐색 필터에 hash_message_verification.list를 입력합니다.
      2. 해시 메시지 검증 목록에서 새로 만들기를 선택합니다.
      3. 양식에서 필드를 채웁니다.
        표 1. 해시 메시지 검증 양식
        필드 설명
        이름

        회사의 WhatsApp 회사 전화 번호와 연결된 인증 토큰을 저장하는 해시 메시지 검증 [hash_message_verification] 테이블의 기록 이름입니다. 예: WhatsappTestAppInboundToken.
        설명 기록에 대한 설명입니다. 예를 들어 WhatsApp 테스트 애플리케이션 인증 토큰입니다.
        비밀 메타 개발자 콘솔에서 설정된 애플리케이션의 앱 비밀입니다.
      4. 해시 메시지 검증 기록의 이름을 적어둡니다.
      5. 제출을 선택합니다.
    4. 필수 인증 헤더 WhatsApp 가 있는 메시지를 계정에 보내려면 시스템 사용자 액세스 토큰을 저장하는 토큰 검증 기록을 생성합니다.
      1. 인스턴스의 ServiceNow 탐색 필터에 token_verification.list를 입력합니다.
      2. 토큰 검증 목록에서 새로 만들기를 선택합니다.
      3. 양식에서 필드를 채웁니다.
        표 2. 토큰 검증 양식
        필드 설명
        이름 회사의 Meta 비즈니스 계정과 연결된 시스템 사용자 액세스 토큰을 저장하는 토큰 검증 [token_verification] 테이블의 기록 이름입니다. 예를 들어 WhatsappTestAppOutboundToken입니다.
        설명 기록에 대한 설명입니다. 예를 들어 WhatsApp Business 테스트 애플리케이션 아웃바운드 토큰입니다.
        토큰 Meta 비즈니스 관리자에서 생성된 시스템 사용자 접근 토큰
      4. 토큰 검증 기록의 이름을 적어둡니다.
      5. 제출을 선택합니다.
    5. 아웃바운드 메시지 기록을 메시지 인증 기록과 연결합니다.
      1. 인스턴스의 ServiceNow 탐색 필터에 message_auth.list 를 입력하고 새로 만들기를 선택합니다.
      2. 양식에서 필드를 채웁니다.
        표 3. 메시지 인증 양식
        필드 설명
        이름 메시지 인증 [message auth] 테이블의 기록 이름입니다. 예를 들어 VA WhatsApp 테스트 앱 메시지 인증입니다.
        제공자 인증 토큰 제공자입니다. WhatsApp을 입력하세요.
        그룹 이름 생성한 그룹의 이름입니다.
        서비스 포털 본인이 생성한 고객 서비스 포털입니다.
        아웃바운드 서비스 토큰 외부 ServiceNow AI Platform 서비스 또는 API에 대한 액세스를 인증하고 권한을 부여하는 데 사용하는 고유 토큰입니다. 토큰은 다른 ServiceNow AI Platform 시스템과 안전하게 상호 작용할 수 있도록 하는 자격 증명입니다. 이 토큰은 외부 서비스에서 생성되어 플랫폼이 요청을 하고 리소스에 액세스할 수 있도록 제공됩니다 ServiceNow AI Platform .
        인바운드 메시지 검증 인바운드 해시 메시지에 대해 생성한 해시 메시지 검증 기록의 이름입니다.
        아웃바운드 메시지 검증 인바운드 해시 메시지에 대해 생성한 토큰 메시지 검증 기록의 이름입니다.
        주:
        인바운드 메시지 검증 및 인바운드 메시지 검증 필드의 값이 동일합니다.
      3. 제출을 선택합니다.
    6. 메시지 인증 기록을 WhatsApp 지원 전화 번호와 연결합니다.
      1. 인스턴스의 ServiceNow 탐색 필터에 sys_cs_provider.list를 입력합니다.
      2. 제공자 채널 목록의 채널에 WhatsApp 해당하는 이름 열에서 VA Whatsapp 어댑터 제공자를 선택합니다.
        항목이 WhatsApp 없으면 탐색 필터에 sys_cs_provider_application.list 를 입력하여 목록을 생성합니다.
      3. 제공자 채널 ID 관련 목록에서 새로 만들기를 선택합니다.
      4. 양식에서 필드를 채웁니다.
        표 4. 제공자 채널 ID 양식
        필드 설명
        이름 IT 서비스 데스크와 같이 사용자가 연락하는 엔터티의 이름입니다.
        인바운드 ID WhatsApp 지원 전화번호에 해당하는 전화번호 ID입니다.
        메시지 인증 사용자가 생성한 메시지 인증입니다.
      5. 제출을 선택합니다.
    7. 제공자 채널 ID 속성을 구성합니다.
      1. 생성한 제공자 채널 ID를 선택합니다.
      2. 제공자 채널 ID 속성 섹션에서 새로 만들기를 선택합니다.
      3. 양식에서 필드를 채웁니다.
        표 5. 제공자 채널 ID 양식
        필드 설명
        이름 사용자가 연락하는 엔터티의 이름입니다. display_phone_number 입력합니다.
        값 생성한 전화 번호 ID에 해당하는 실제 전화 번호를 입력합니다.
        설명 제공자 채널에 대한 설명을 추가합니다.
      4. 제출을 선택합니다.
    8. 사용자가 보낸 미디어 컨텐츠를 다운로드할 수 있도록 서버를 활성화합니다.
      1. 인스턴스의 ServiceNow 탐색 필터에 sys_cs_provider.list를 입력합니다.
      2. 제공자 채널 목록의 채널에 WhatsApp 해당하는 이름 열에서 VA Whatsapp 어댑터 제공자를 선택합니다.
      3. 신뢰할 수 있는 미디어 도메인 필드에 lookaside.fbsbx.com 입력합니다.
      4. 업데이트를 선택합니다.