Structures

The following structures are available globally.

  • 좋아요 수, 댓글 수 등의 소셜 정보를 표현하기 위해 사용되는 오브젝트 입니다.

    5개의 속성 중 최대 3개만 표시해 줍니다. 우선순위는 Like > Comment > Shared > View > Subscriber 입니다.

    See more

    Declaration

    Swift

    public struct Social : Codable
  • 메시지 하단에 추가되는 버튼 오브젝트 입니다.

    See more

    Declaration

    Swift

    public struct Button : Codable
  • 메시지에서 컨텐츠 영역이나 버튼 클릭 시에 이동되는 링크 정보 오브젝트 입니다.

    • 오브젝트 내 프로퍼티 중 하나 이상은 반드시 존재해야 합니다.
    • 링크에 사용되는 도메인은 반드시 내 애플리케이션 설정에 등록되어야 합니다. 도메인은 개발자 웹사이트의 [내 애플리케이션] - [앱 설정] - [플랫폼] - [Web] 메뉴에서 등록할 수 있습니다.
    • 링크 실행 우선순위는 {android/ios}ExecutionParams > mobileWebURL > webURL 입니다.

    • 자세한 사항은 가이드(https://developers.kakao.com/docs/latest/ko/message/message-template#component)를 참고하시기 바랍니다.

    See more

    Declaration

    Swift

    public struct Link : Codable
  • 컨텐츠의 내용을 담고 있는 오브젝트 입니다. 1개의 이미지, 제목, 설명, 링크 정보를 가질 수 있습니다.

    See more

    Declaration

    Swift

    public struct Content : Codable
  • 가격, 할인율 등 커머스 정보를 나타내는 오브젝트 입니다.

    See more

    Declaration

    Swift

    public struct CommerceDetail : Codable
  • 기본 템플릿으로 제공되는 피드 템플릿 클래스 입니다.

    피드 템플릿은 하나의 컨텐츠와 하나의 기본 버튼을 가집니다. 소셜 정보를 추가할 수 있으며 임의의 버튼을 설정할 수도 있습니다.

    아래는 간단한 피드템플릿 생성 예제입니다.

    let template = FeedTemplate(content: Content(title: "딸기 치즈 케익",
                                                 imageUrl: URL(string: "http://mud-kage.kakao.co.kr/dn/Q2iNx/btqgeRgV54P/VLdBs9cvyn8BJXB3o7N8UK/kakaolink40_original.png")!,
                                                 description: "#케익 #딸기 #삼평동 #까페 #분위기 #소개팅",
                                                 link: Link(webUrl: URL(string: "https://developers.kakao.com")!,
                                                            mobileWebUrl:  URL(string: "https://developers.kakao.com")!)),
                                social: Social(likeCount: 286,
                                               commentCount: 45,
                                               sharedCount: 845))
    
    See more

    Declaration

    Swift

    public struct FeedTemplate : Codable, Templatable
  • 여러 개의 컨텐츠를 리스트 형태로 보여줄 수 있는 메시지 템플릿 입니다.

    리스트 템플릿은 메시지 상단에 노출되는 헤더 타이틀과, 컨텐츠 목록, 버튼 등으로 구성됩니다. 헤더와 컨텐츠 각각의 링크를 가질 수 있습니다. 피드 템플릿과 마찬가지로 하나의 기본 버튼을 가지며 임의의 버튼을 설정할 수 있습니다.

    let template = ListTemplate(headerTitle: "WEEKLY MAGAZINE",
                                headerLink: Link(mobileWebUrl: URL(string: "https://developers.kakao.com")!),
                                contents: [Content(title: "취미의 특징, 탁구",
                                                   imageUrl: URL(string: "http://mud-kage.kakao.co.kr/dn/bDPMIb/btqgeoTRQvd/49BuF1gNo6UXkdbKecx600/kakaolink40_original.png")!,
                                                   description: "스포츠",
                                                   link: Link(mobileWebUrl: URL(string: "https://developers.kakao.com")!)),
                                           Content(title: "크림으로 이해하는 커피이야기",
                                                   imageUrl: URL(string: "http://mud-kage.kakao.co.kr/dn/QPeNt/btqgeSfSsCR/0QJIRuWTtkg4cYc57n8H80/kakaolink40_original.png")!,
                                                   description: "음식",
                                                   link: Link(mobileWebUrl: URL(string: "https://developers.kakao.com")!)),
                                           Content(title: "감성이 가득한 분위기",
                                                   imageUrl: URL(string: "http://mud-kage.kakao.co.kr/dn/c7MBX4/btqgeRgWhBy/ZMLnndJFAqyUAnqu4sQHS0/kakaolink40_original.png")!,
                                                   description: "사진",
                                                   link: Link(mobileWebUrl: URL(string: "https://developers.kakao.com")!)),])
    
    See more

    Declaration

    Swift

    public struct ListTemplate : Codable, Templatable
  • 주소를 이용하여 특정 위치를 공유할 수 있는 메시지 템플릿 입니다.

    위치 템플릿은 지도 표시에 사용되는 주소 정보와 해당 위치를 설명할 수 있는 컨텐츠 오브젝트로 구성됩니다. 왼쪽 하단에 기본 버튼, 오른쪽 하단에 지도를 보여주기 위한 “위치 보기” 버튼이 추가됩니다. “위치 보기” 버튼을 클릭하면 카카오톡 채팅방 내에서 바로 지도 화면으로 전환하여 해당 주소의 위치를 확인할 수 있습니다.

    let template = LocationTemplate(address: "경기 성남시 분당구 판교역로 235 에이치스퀘어 N동 8층",
                                    addressTitle: "카카오 판교오피스 카페톡",
                                    content: Content(title: "신메뉴 출시❤️ 체리블라썸라떼",
                                                     imageUrl: URL(string: "http://mud-kage.kakao.co.kr/dn/bSbH9w/btqgegaEDfW/vD9KKV0hEintg6bZT4v4WK/kakaolink40_original.png")!,
                                                     description: "이번 주는 체리블라썸라떼 1+1",
                                                     link: Link(mobileWebUrl: URL(string: "https://developers.kakao.com")!)),
                                    buttonTitle: "메뉴 보기")
    
    See more

    Declaration

    Swift

    public struct LocationTemplate : Codable, Templatable
  • 기본 템플릿으로 제공되는 커머스 템플릿 클래스 입니다.

    커머스 템플릿은 하나의 컨텐츠와 하나의 커머스 정보, 하나의 기본 버튼을 가집니다. 임의의 버튼을 최대 2개까지 설정할 수 있습니다.

    let template = CommerceTemplate(content: Content(title: "Ivory long dress (4 Color)",
                                                     imageUrl: URL(string: "http://mud-kage.kakao.co.kr/dn/RY8ZN/btqgOGzITp3/uCM1x2xu7GNfr7NS9QvEs0/kakaolink40_original.png")!,
                                                     link: Link(mobileWebUrl: URL(string: "https://developers.kakao.com")!)),
                                    commerce: CommerceDetail(regularPrice: 208800,
                                                             discountPrice: 146160,
                                                             discountRate: 30),
                                    buttons: [Button(title: "구매하기",
                                                     link: Link(mobileWebUrl: URL(string: "https://developers.kakao.com")!)),
                                              Button(title: "공유하기",
                                                     link: Link(mobileWebUrl: URL(string: "https://developers.kakao.com")!)),
                                              ])
    
    See more

    Declaration

    Swift

    public struct CommerceTemplate : Codable, Templatable
  • 텍스트형 기본 템플릿 클래스 입니다.

    See more

    Declaration

    Swift

    public struct TextTemplate : Codable, Templatable