맞춤 CRM 필드 매핑 (Salesforce, Zendesk, Kustomer)

CRM 레코드의 메타데이터를 빠르게 분석할 수 있도록 CCAI Platform 웹 및 모바일 SDK와 앱 API(채팅)는 데이터를 CRM 커스텀 필드로 푸시할 수 있습니다.

커스텀 필드 매핑을 사용하면 CCAI Platform 고객 데이터 키(포털 UI: 커스텀 데이터 필드 라벨)를 CRM 필드 또는 속성에 매핑하여 매핑된 값이 적절한 CRM 레코드에 자동으로 기록되도록 할 수 있습니다.

커스텀 데이터 키는 다음을 통해 제공할 수 있습니다.

  • CCAI Platform 웹 및 모바일 SDK

  • 채팅에서 맞춤 데이터 전송 엔드포인트를 사용하는 Apps API(채팅)

모바일 SDK API 예시

다음 섹션에서는 모바일 SDK와 관련된 예를 간략하게 설명합니다.

SDK에서 서버로 데이터 전송

{
    custom_data: { # same format with previous custom data from SDK
        data_name: {
            value: value,
            type: string,
            label: "Data Name",
        },
        device: { # example
            value: "iOS",
            type: "string",
            label: "Device Type"}
    }
}

서버에서 CRM 어댑터로 데이터 전송

{
    key: {
        crm_field: "crm custom field name",
        type: "text", # text / checkbox ...,
        value: "value"
    },
    device: { # example
        crm_field: "device",
        type: "text", 
        value: "iOS"
    }
}

API 엔드포인트

CRM 맞춤 필드 매핑은 API를 사용하여 액세스할 수 있습니다. 사용할 수 있는 엔드포인트는 다음과 같습니다.

  • 모든 필드 가져오기: HTTP POST 또는 GET: /crm_custom_fields

  • 특정 필드 업데이트 또는 삭제: HTTP PUT 또는 DELETE /crm_custom_fields/:id

Apps API(채팅) 예시(SDK 없음)

CCAI Platform 웹 또는 모바일 SDK 없이 Apps API를 직접 사용하는 고객은 기존 채팅 세션의 커스텀 데이터를 전송하여 채팅 상호작용에 커스텀 필드 매핑을 계속 사용할 수 있습니다.

  • 엔드포인트: POST /apps/api/v1/chats/:id/custom_data

요청 본문(보안되지 않음/서명되지 않음)

{
  "signed": false,
  "data": {
    "orderId": {
      "label": "Order ID",
      "value": "12345"
    },
    "customerTier": {
      "label": "Customer Tier",
      "value": "gold"
    }
  }
}

요청 본문(보안/서명된 JWT)

{
  "signed": true,
  "signed_data": "<JWT>"
}

JWT 페이로드 형태(예시)

{
  "custom_data": {
    "orderId": { "label": "Order ID", "value": "12345" },
    "customerTier": { "label": "Customer Tier", "value": "gold" }
  },
  "exp": 1734567890,
  "iat": 1734560000
}

Apps API 페이로드에 맞춤 필드 매핑 적용

CCAI Platform 포털에서 커스텀 데이터 필드 라벨(커스텀 데이터 키)을 Apps API 페이로드 data 객체 아래의 최상위 키(예: orderId 또는 customerTier)로 설정하고 선택한 CRM 필드 또는 속성에 매핑합니다.

다음은 두 가지 예입니다.

  • 키별 지도: orderId, customerTier
  • 중첩 라벨로 매핑되지 않음: "label": "Order ID"는 표시 텍스트이며 매핑에 사용되지 않습니다.

예약된 키(고객 플래그)

다음과 같은 예약된 키가 표시될 수 있습니다.

  • reserved_verified_customer

  • reserved_bad_actor

  • reserved_repeat_customer

이러한 키는 주로 고객 플래그 동작에 사용됩니다. 혼동을 방지하려면 특정 보고 요구사항이 없는 한 reserved_* 키를 CRM 맞춤 필드로 매핑하지 마세요. CRM 맞춤 필드 매핑에는 비즈니스별 키(예: orderId, customerTier 등)를 매핑하는 것이 좋습니다.

맞춤 CRM 필드 매핑을 구성하는 단계

  1. CRM에서 맞춤 필드와 값을 만듭니다.

  2. CRM의 연락처에 새 값을 할당합니다.

  3. CCAI Platform 포털에서 설정을 구성합니다.

  4. 테스트

Zendesk 구성

다음 섹션에서는 Zendesk CRM의 필드 매핑을 구성하는 프로세스를 간략하게 설명합니다.

사용자(연락처)의 맞춤 입력란 만들기

  1. 관리자로 Zendesk에 로그인합니다.

  2. 를 클릭하여 관리자 옵션에 액세스합니다.

  3. 사용자 필드를 선택합니다.

  4. 만들려는 필드 유형을 선택합니다.

    필드 유형 선택

  5. 상담사 뷰에 필드 제목과 이름을 추가합니다.

    필드 키는 자동으로 채워집니다.

  6. 필드 만들기를 클릭합니다.

이제 활성 필드 목록에 이 새 필드가 표시되고 사용자를 볼 때 이 새 필드가 왼쪽 열에 표시됩니다.

활성 필드 표시

티켓의 커스텀 필드 만들기

  1. 관리자로 Zendesk에 로그인합니다.

  2. 아이콘을 클릭하여 관리 옵션에 액세스합니다.

  3. Ticket Fields(티켓 필드)를 선택합니다.

  4. 커스텀 필드 추가 버튼을 클릭합니다.

  5. 선택을 클릭하여 만들려는 필드 유형을 선택합니다.

  6. 필드 제목을 추가합니다. 필드 제목이 상담사 보기에 표시됩니다.

    API의 crm_field와 동일한 값을 사용하는 것이 좋습니다.

    필드 제목 표시

  7. 필드 추가 버튼을 클릭합니다.

이제 활성 필드 목록에 이 새 필드가 표시되고 티켓을 볼 때 왼쪽 열에 이 새 필드가 표시됩니다.

Salesforce 구성

  1. 설정으로 이동합니다.

  2. Object Manager(객체 관리자)를 선택합니다.

  3. 커스텀 필드를 추가할 객체(케이스 또는 CCAI Platform 세션)를 선택합니다.

  4. I can help you with that. Let's start by clicking Fields & Relationships.

  5. New(새로 만들기)를 클릭합니다.

  6. 데이터 유형으로 텍스트를 선택합니다.

  7. 필드 라벨에 필드 이름을 입력합니다.

  8. 길이에 255를 입력합니다.

    필드 라벨을 입력하면 필드 이름이 자동으로 채워집니다.

    필드 라벨 표시

    나머지 변수는 기본값으로 둘 수 있습니다.

  9. 다음을 클릭합니다.

  10. 객체(케이스 또는 CCAI Platform 세션)에 액세스하는 프로필의 표시 체크박스를 선택합니다.

  11. 다음을 클릭합니다.

  12. 저장을 클릭합니다.

  13. 그러면 Fields & Relationships(필드 및 관계) 뷰로 돌아갑니다. 방금 만든 필드를 찾고 필드 이름을 기록해 둡니다.

    필드 및 관계 뷰

  14. 필드 이름은 CCAI Platform 커스텀 필드 매핑 페이지의 CRM 필드 라벨에 입력하는 이름입니다.

다음 예시에서는 케이스 객체에서 올바르게 설정되고 사용될 때 새 필드가 어떻게 표시되는지 보여줍니다.

새 필드 표시

Kustomer 구성

커스텀 필드 설정에 관한 세부정보 및 정보는 Kustomer 고객센터를 참조하세요.

CCAI Platform 구성

다음 섹션에서는 Kustomer CRM 필드 매핑을 구성하기 위해 CCAI Platform 포털에서 필요한 변경사항을 간략하게 설명합니다.

  1. CCAI Platform 포털에서 설정 > 작업 관리로 이동합니다.

  2. CRM 맞춤 필드 매핑 섹션으로 이동하여 모두 보기를 클릭합니다.

  3. + CRM 필드 매핑 추가 링크를 클릭합니다.

    • 필드 매핑 제목: CCAI Platform 포털에서 사용되는 이 커스텀 필드 매핑의 CCAI Platform 이름입니다.

    • CRM 필드 라벨: 매핑할 CRM 필드의 CRM 내 라벨입니다.

    • 커스텀 데이터 필드 라벨: 매핑하는 커스텀 데이터 필드 라벨입니다.

    • SDK 예시: data_name, device(custom_data object에서)

    • Apps API(Chat) 예시: orderId, customerTier(Apps API 요청 데이터 객체에서 가져옴)

  4. 저장을 클릭합니다.