3. 자유형 발송 유형별 샘플

아래 예제는 메시지 유형별 파라미터만 포함된 예시입니다. 발송 방식(캠페인/단건)에 따라 필요한 파라미터를 추가하여 전송해야 합니다.

---

텍스트형

• message 필수 (공백 포함 1,000자)

• attach.button[], attach.coupon 선택

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "messageType": "FT",
  "message": "안녕하세요!\n봄맞이 특별 혜택을 확인해보세요.\n기간: 2025-04-01 ~ 2025-04-30",
  "attach": {
    "button": [
      {
        "name": "혜택 확인하기",
        "type": "WL",
        "url_mobile": "https://example.com/event",
        "url_pc": "https://example.com/event"
      },
      {
        "name": "앱으로 보기",
        "type": "AL",
        "scheme_android": "example://event",
        "scheme_ios": "example://event"
      }
    ]
  }
}

---

이미지형

• message 필수 (최대 400자 제한)

• attach.image.img_url 필수 (이미지 업로드 후 받은 이미지 URL)

• attach.button[] 선택

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "messageType": "FI",
  "message": "봄맞이 신상품을 만나보세요.\n지금 바로 확인해보세요!",
  "attach": {
    "image": {
      "img_url": "https://example.com/images/spring_banner.jpg",
      "img_link": "https://example.com/event"
    },
    "button": [
      {
        "name": "상품 보러가기",
        "type": "WL",
        "url_mobile": "https://example.com/product",
        "url_pc": "https://example.com/product"
      }
    ]
  }
}

---

와이드 이미지형

• message 필수 (최대 76자, 줄바꿈 최대 1개)

• attach.image.img_url 필수 (이미지 업로드 후 받은 이미지 URL)

• attach.button[] 선택 (최대 2개)

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "messageType": "FW",
  "message": "봄맞이 특별 이벤트 진행 중!",
  "attach": {
    "image": {
      "img_url": "https://example.com/images/wide_spring_banner.jpg",
      "img_link": "https://example.com/event"
    },
    "button": [
      {
        "name": "이벤트 참여하기",
        "type": "WL",
        "url_mobile": "https://example.com/event",
        "url_pc": "https://example.com/event"
      }
    ]
  }
}

---

와이드 아이템 리스트형

• header 필수

• attach.item.list[] 필수 (최소 3개, 최대 4개)

• attach.button[] 선택 (최대 2개)

  • 버튼 개수와 상관없이 버튼명(name)은 최대 8자

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "messageType": "FL",
  "header": "이번 주 추천 상품",
  "attach": {
    "item": {
      "list": [
        {
          "title": "봄 원피스",
          "img_url": "https://example.com/images/item_01.jpg",
          "url_mobile": "https://example.com/product/01",
          "url_pc": "https://example.com/product/01"
        },
        {
          "title": "린넨 자켓",
          "img_url": "https://example.com/images/item_02.jpg",
          "url_mobile": "https://example.com/product/02",
          "url_pc": "https://example.com/product/02"
        },
        {
          "title": "캔버스 스니커즈",
          "img_url": "https://example.com/images/item_03.jpg",
          "url_mobile": "https://example.com/product/03",
          "url_pc": "https://example.com/product/02"
        }
      ]
    },
    "button": [
      {
        "name": "최대8자",
        "type": "WL",
        "url_mobile": "https://example.com/products",
        "url_pc": "https://example.com/products"
      }
    ]
  }
}

---

프리미엄 동영상형

• attach.video.video_url 필수

  • 동영상 링크는 카카오 TV에 업로드된 영상만 사용 가능

• header, message 선택 (message는최대 76자, 줄바꿈 최대 1개)

• attach.button[] 선택 (최대 1개)

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "messageType": "FP",
  "header": "2025 봄 컬렉션 영상",
  "message": "새로운 봄 컬렉션 영상을 지금 만나보세요.",
  "attach": {
    "video": {
      "video_url": "https://tv.kakao.com/v/123456789",
      "thumbnail_url": "https://example.com/images/video_thumb.jpg"
    }
  }
}

---

커머스형

• attach.commerce 필수

• attach.image.img_url 필수

• attach.button[] 필수 (최소 1개, 최대 2개)

• additional_content 선택

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "messageType": "FM",
  "additional_content": "오늘만 특가! 최대 30% 할인",
  "attach": {
    "image": {
      "img_url": "https://example.com/images/product_main.jpg"
    },
    "commerce": {
      "title": "봄 시즌 린넨 자켓",
      "regular_price": 89000,
      "discount_price": 62300,
      "discount_rate": 30
    },
    "button": [
      {
        "name": "구매하기",
        "type": "WL",
        "url_mobile": "https://example.com/product/100/buy",
        "url_pc": "https://example.com/product/100/buy"
      }
    ]
  }
}

---

캐러셀 피드형

• carousel 필수

  • carousel.list[] 필수 (최소 2개, 최대 6개)

    • list[].header, list[].message 필수

    • list[].attachment.button[] 필수 (최소 1개, 최대 2개)

    • list[].attachment.image.img_url 필수

  • carousel.tail 선택 (더보기 버튼)

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "messageType": "FC",
  "carousel": {
    "list": [
      {
        "header": "봄 원피스 신상",
        "message": "따뜻한 봄날에 어울리는 플로럴 원피스.",
        "attachment": {
          "image": {
            "img_url": "https://example.com/images/carousel_01.jpg",
            "img_link": "https://example.com/product/01"
          },
          "button": [
            {
              "name": "상품 보기",
              "type": "WL",
              "url_mobile": "https://example.com/product/01",
              "url_pc": "https://example.com/product/01"
            }
          ]
        }
      },
      {
        "header": "린넨 자켓 신상",
        "message": "시원하고 가벼운 봄 린넨 자켓.",
        "attachment": {
          "image": {
            "img_url": "https://example.com/images/carousel_02.jpg",
            "img_link": "https://example.com/product/02"
          },
          "button": [
            {
              "name": "상품 보기",
              "type": "WL",
              "url_mobile": "https://example.com/product/02",
              "url_pc": "https://example.com/product/02"
            },
            {
              "name": "앱으로 보기",
              "type": "AL",
              "scheme_android": "example://product/02",
              "scheme_ios": "example://product/02"
            }
          ]
        }
      },
      {
        "header": "캔버스 스니커즈",
        "message": "봄 코디를 완성하는 경량 스니커즈.",
        "attachment": {
          "image": {
            "img_url": "https://example.com/images/carousel_03.jpg",
            "img_link": "https://example.com/product/03"
          },
          "button": [
            {
              "name": "상품 보기",
              "type": "WL",
              "url_mobile": "https://example.com/product/03",
              "url_pc": "https://example.com/product/03"
            }
          ]
        }
      }
    ]
  }
}

---

캐러셀 커머스형

• carousel 필수

  • carousel.head 선택 (인트로 영역)

  • carousel.list[] 필수 (인트로 설정 시 최소 1개 최대 6개, 인트로 미설정 시 최소 2개 최대 6개)

    • list[].attachment.commerce 필수

    • list[].attachment.button[] 필수 (최소 1개, 최대 2개)

    • list[].additional_content 선택

  • carousel.tail 선택 (더보기 버튼)

{
  "senderKey": "abc123def456abc123def456abc123def456abc1",
  "messageType": "FA",
  "additional_content": "봄 시즌 특가 모음",
  "carousel": {
    "head": {
      "header": "봄 시즌 추천 상품",
      "content": "최대 30% 할인된 봄 신상품을 만나보세요.",
      "image_url": "https://example.com/images/carousel_head.jpg",
      "url_mobile": "https://example.com/event",
      "url_pc": "https://example.com/event"
    },
    "list": [
      {
        "additional_content": "오늘만 특가",
        "attachment": {
          "image": {
            "img_url": "https://example.com/images/commerce_01.jpg",
            "img_link": "https://example.com/product/01"
          },
          "commerce": {
            "title": "봄 플로럴 원피스",
            "regular_price": 79000,
            "discount_price": 55300,
            "discount_rate": 30
          },
          "button": [
            {
              "name": "구매하기",
              "type": "WL",
              "url_mobile": "https://example.com/product/01/buy",
              "url_pc": "https://example.com/product/01/buy"
            }
          ]
        }
      },
      {
        "attachment": {
          "image": {
            "img_url": "https://example.com/images/commerce_02.jpg",
            "img_link": "https://example.com/product/02"
          },
          "commerce": {
            "title": "봄 린넨 자켓",
            "regular_price": 89000,
            "discount_price": 71200,
            "discount_rate": 20
          },
          "button": [
            {
              "name": "구매하기",
              "type": "WL",
              "url_mobile": "https://example.com/product/02/buy",
              "url_pc": "https://example.com/product/02/buy"
            },
            {
              "name": "찜하기",
              "type": "BK"
            }
          ]
        }
      },
      {
        "attachment": {
          "image": {
            "img_url": "https://example.com/images/commerce_03.jpg",
            "img_link": "https://example.com/product/03"
          },
          "commerce": {
            "title": "캔버스 스니커즈",
            "regular_price": 59000
          },
          "button": [
            {
              "name": "구매하기",
              "type": "WL",
              "url_mobile": "https://example.com/product/03/buy",
              "url_pc": "https://example.com/product/03/buy"
            }
          ]
        }
      }
    ],
    "tail": {
      "url_mobile": "https://example.com/products/spring",
      "url_pc": "https://example.com/products/spring"
    }
  }
}