가이드 문서
Go to Docs (EN)Sign in to Dashboard

CRM 속성

Suggest Edits

CRM 속성은 핵클 서버에만 안전하게 저장되며 SDK를 통해 값을 직접 조회할 수는 없습니다.

❗️

CRM 속성은 별도로 관리되며, resetUser()를 호출하거나 updateUserProperties에서 clearAll을 호출해도 삭제되거나 초기화되지 않습니다.

사용자가 회원 탈퇴 등을 한 경우, 반드시 별도로 제공되는 함수를 호출하여 정보를 삭제해야 합니다.

전화번호 수집

전화번호 수집 기능은 React SDK 11.42.0 버전 이상에서만 사용할 수 있습니다.

👍

카카오 / 문자 메시지 권장 사항

이 기능을 이용하여 사용자 식별자와 전화번호를 매핑하면 핵클을 통한 카카오 / 문자 메시지를 더욱 원활히 이용할 수 있습니다.

setPhoneNumber

사용자의 전화번호를 등록합니다.

전화번호는 올바른 E.164 포맷일 경우에만 저장됩니다. 국가코드를 지정하지 않았다면 대한민국(+82)이 기본값으로 사용됩니다.

이미 저장된 전화번호가 있는 사용자의 경우, 이 함수를 호출하면 기존 전화번호가 새로운 값으로 교체됩니다.

const myPhone = '+821012341234';
hackleClient.setPhoneNumber(myPhone);

unsetPhoneNumber

사용자에게 등록되어 있는 전화번호를 삭제합니다.

hackleClient.unsetPhoneNumber();

CRM 마케팅 메시지 수신 동의

CRM 마케팅 메시지 수신 동의 기능은 React SDK 11.45.0 버전 이상에서만 사용할 수 있습니다.

📘

수신 동의 상태에 대한 자세한 내용은 CRM 메시지 수신 동의 관리 문서를 참고해주세요.

수신 동의 속성

메시지 목적 별로 수신 동의/거부를 할 수 있습니다.

HackleSubscriptionOperationsBuilder를 사용해 원하는 속성의 동의 상태를 설정한 후, updatePushSubscriptions() 같은 메서드로 최종 업데이트를 진행합니다.

메시지 채널 별로 동의 상태를 업데이트할 수 있습니다.

import { HackleSubscriptionOperationsBuilder } from "@hackler/react-sdk"

const operations = new HackleSubscriptionOperationsBuilder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackleClient.updatePushSubscriptions(operations);

광고성 메시지

광고성 메시지 수신 동의 속성을 설정합니다.

import { HackleSubscriptionOperationsBuilder } from "@hackler/react-sdk"

const operations = new HackleSubscriptionOperationsBuilder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackleClient.updatePushSubscriptions(operations);

정보성 메시지

정보성 메시지 수신 동의 속성을 설정합니다.

import { HackleSubscriptionOperationsBuilder } from "@hackler/react-sdk"

const operations = new HackleSubscriptionOperationsBuilder()
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackleClient.updatePushSubscriptions(operations);

HackleSubscriptionStatus

HackleSubscriptionStatus설명비고
UNKNOWN수신 동의/거부를 하지 않음defualt
SUBSCRIPTION명시적으로 수신 동의
UNSUBSCRIPTION명시적으로 수신 거부

푸시 수신 동의 상태 업데이트

사용자의 푸시 메시지 수신 동의 상태를 업데이트 합니다.

import { HackleSubscriptionOperationsBuilder } from "@hackler/react-sdk"

const operations = new HackleSubscriptionOperationsBuilder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackleClient.updatePushSubscriptions(operations);

카카오 메시지 수신 동의 상태 업데이트

사용자의 카카오 메시지 수신 동의 상태를 업데이트 합니다.

import { HackleSubscriptionOperationsBuilder } from "@hackler/react-sdk"

const operations = new HackleSubscriptionOperationsBuilder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackleClient.updateKakaoSubscriptions(operations);

문자 메시지 수신 동의 상태 업데이트

사용자의 문자 메시지 수신 동의 상태를 업데이트 합니다.

import { HackleSubscriptionOperationsBuilder } from "@hackler/react-sdk"

const operations = new HackleSubscriptionOperationsBuilder()
  .marketing(HackleSubscriptionStatus.SUBSCRIBED)
  .information(HackleSubscriptionStatus.SUBSCRIBED)
  .build()

hackleClient.updateSmsSubscriptions(operations);

Updated about 10 hours ago