본문으로 건너뛰기

커머스 템플릿으로 메세지 전송하기

커머스 템플릿​

공식 문서

상품 가격을 포함해 상품 정보를 자세히 보여주는 메시지 형식입니다. 피드 템플릿만큼 긴 텍스트를 추가하거나 소셜 정보를 추가할 수는 없지만, 사용자에게 가격 정보를 안내할 수 있는 장점이 있습니다.

활용 예시: 상품의 가격 정보(정상 가격, 할인 가격, 할인율)를 담을 수 있어 쇼핑몰에서 판매하는 상품이나 프로모션 진행 상품의 소식을 알리는 데 적합합니다.

템플릿 타입 정의​

/**
 * 기본 템플릿으로 제공되는 커머스 템플릿 클래스
 *
 * @property content 메시지의 내용. 텍스트 및 이미지, 링크 정보 포함.
 * @property commerce 컨텐츠에 대한 가격 정보
 * @property buttons 버튼 목록. 버튼 타이틀과 링크를 변경하고 싶을때, 버튼 두개를 사용하고 싶을때 사용. (최대 2개)
 * @property buttonTitle 기본 버튼 타이틀(자세히 보기)을 변경하고 싶을 때 설정. 이 값을 사용하면 클릭 시 이동할 링크는 content 에 입력된 값이 사용됨.
 */
export interface KakaoCommerceTemplate {
  content: KakaoTemplateContent;
  commerce: KakaoTemplateCommerce;
  buttons?: KakaoTemplateButton[];
  buttonTitle?: string;
}

나에게 메세지 전송하기​

sendCommerceTemplateToMe 로 템플릿 메세지를 나에게 전송할 수 있습니다.

export function sendCommerceTemplateToMe(params: {
  template: KakaoCommerceTemplate;
})
  • template: 템플릿 객체입니다.

친구들에게 메세지 전송하기​

sendCommerceTemplateToFriends 로 템플릿 메세지를 친구들에게 전송할 수 있습니다.

export function sendCommerceTemplateToFriends(params: {
  template: KakaoCommerceTemplate;
  receiverUuids: string[];
})
정보

자세한 컴포넌트들의 타입은 컴포넌트 타입들을 참고해주세요.

사용에 문제가 생긴다면 Troubleshooting을 참고해주세요