콘텐츠로 건너뛰기
사용자 가이드지원 데모 요청 로그인
Pushwoosh.com

LINE API

createLineMessage

Anchor link to

사용자에게 LINE 메시지를 보내는 데 사용됩니다

POST https://api.pushwoosh.com/json/1.3/createLineMessage

텍스트 메시지 보내기

Anchor link to

이미지나 버튼 없이 일반 텍스트로만 구성된 간단한 LINE 메시지입니다. 자세히 알아보기

팁: 고급 서식 및 리치 미디어를 사용하려면 Flex, 이미지 또는 캐러셀과 같은 메시지 템플릿을 사용하세요.

요청 본문
Anchor link to
매개변수
유형
필수설명
applicationstring예Pushwoosh 애플리케이션 코드
authstring예요청 인증을 위한 API 액세스 토큰입니다.
notificationsarray of objects예전송할 LINE 메시지 객체 목록입니다.
contentstring예전송할 LINE 메시지의 텍스트입니다. 최대 글자 수: 5000.
참고: preset과 content가 모두 포함된 경우, 요청의 값이 preset을 재정의합니다.
presetstring아니요Pushwoosh 제어판에서 생성한 LINE 프리셋의 코드입니다. 참고: preset과 content가 모두 포함된 경우, 요청의 값이 preset을 재정의합니다.
send_datestring예메시지를 보낼 날짜 및 시간입니다. 즉시 보내려면 YYYY-MM-DD HH:mm 형식 또는 now를 사용하세요.
devicesarray of strings예LINE 메시지를 보낼 장치 코드(사용자 ID) 목록입니다.
{
    "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
        "notifications": [
            {
                "content": "test",
                "preset": "preset_code",
                "send_date":"now",
                "devices": ["XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"]
            }
        ]
    }
}

이미지 메시지 보내기

Anchor link to

요청의 템플릿 필드 내에 이미지 객체를 지정하여 LINE 사용자에게 이미지 메시지를 보낼 수 있습니다.

각 이미지 메시지에는 두 개의 이미지 URL이 필요합니다: 하나는 **전체 크기 이미지(image_url)**용이고 다른 하나는 **미리보기(preview_image_url)**용입니다. 사용자가 미리보기를 탭하면 전체 크기 이미지가 열립니다. 두 URL 모두 HTTPS(TLS 1.2 이상)를 사용하고 공개적으로 액세스할 수 있는 이미지 파일에 연결되어 있는지 확인하세요.

자세한 내용은 LINE Messaging API 문서의 이미지 메시지 섹션을 참조하세요.

요청 본문
Anchor link to
매개변수
유형
필수설명
applicationstring예Pushwoosh 애플리케이션 코드
authstring예요청 인증에 사용되는 API 액세스 토큰입니다.
notificationsarray of objects예보낼 메시지 목록입니다.
contentstring예메시지의 대체 또는 미리보기 텍스트로 사용됩니다. Pushwoosh 제어판에서 생성한 LINE 프리셋의 코드입니다.
참고: preset과 template이 모두 포함된 경우, 요청의 template이 사용됩니다.
preset과 content가 모두 포함된 경우, 요청의 content가 프리셋을 재정의합니다.
send_datestring예메시지를 보낼 날짜 및 시간입니다. 즉시 보내려면 YYYY-MM-DD HH:mm 형식 또는 now를 사용하세요.
devicesarray of strings예LINE 메시지를 보낼 장치 코드(사용자 ID) 목록입니다.
presetstring아니요Pushwoosh 제어판에서 생성한 LINE 프리셋의 코드입니다.
참고: preset과 template 매개변수가 모두 요청에 포함된 경우, template의 값이 프리셋에 정의된 값을 재정의합니다.
preset과 content가 동일한 요청에 모두 포함된 경우, 요청에 직접 제공된 content가 preset의 콘텐츠를 재정의합니다.
templateobject예메시지 레이아웃 템플릿입니다. 여러 메시지 유형을 지원합니다. 아래에서 자세한 내용을 참조하세요.
템플릿 매개변수
Anchor link to

유형: image

매개변수
유형
필수설명
image_urlstring예전체 크기 이미지의 URL입니다(HTTPS 사용 필수). 최대 길이: 2000자. 형식: JPEG, PNG. 최대 크기: 10MB.
preview_image_urlstring예채팅에 표시되는 미리보기 이미지의 URL입니다(HTTPS 사용 필수). 최대 길이: 2000자. 형식: JPEG, PNG. 최대 크기: 1MB.
요청 예시
Anchor link to
{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": [
          "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        ],
        "preset": "preset_code",
        "template": {
          "en": {
            "image": {
              "alt_text": "some text",
              "image_url": "https://images.com/1.jpg",
              "preview_image_url": "https://images.com/1.png"
            }
          }
        }
      }
    ]
  }
}

이미지 캐러셀 메시지 보내기

Anchor link to

이미지 캐러셀 메시지를 사용하면 여러 이미지를 가로로 스크롤할 수 있는 형식으로 표시할 수 있습니다. 각 이미지는 사용자가 LINE 채팅 인터페이스에서 스와이프할 수 있는 별도의 클릭 불가능한 열로 나타납니다.

이 형식은 아이템, 프로모션 또는 시각적 선택 항목을 매력적인 방식으로 보여주는 데 이상적입니다.

자세한 내용은 LINE Messaging API 문서의 이미지 캐러셀 템플릿 섹션을 참조하세요.

요청 본문
Anchor link to
매개변수
유형
필수설명
applicationstring예Pushwoosh 애플리케이션 코드
authstring예요청 인증에 사용되는 API 액세스 토큰입니다.
notificationsarray of objects예보낼 메시지 목록입니다.
contentstring예메시지의 대체 또는 미리보기 텍스트로 사용됩니다.
참고: content와 template이 모두 설정된 경우, template이 사용됩니다.
preset과 content가 동일한 요청에 모두 포함된 경우, 요청에 직접 제공된 content가 preset의 콘텐츠를 재정의합니다.
send_datestring예메시지를 보낼 날짜 및 시간입니다. YYYY-MM-DD HH:mm 형식 또는 "now"를 사용하세요.
devicesarray of strings예LINE 메시지를 보낼 장치 코드(사용자 ID) 목록입니다.
presetstring아니요Pushwoosh 제어판에서 생성한 LINE 프리셋의 코드입니다.
참고: preset과 template 매개변수가 모두 요청에 포함된 경우, template의 값이 preset에 정의된 값을 재정의합니다.
preset과 content가 동일한 요청에 모두 포함된 경우, 요청에 직접 제공된 content가 preset의 콘텐츠를 재정의합니다.
templateobject예메시지 레이아웃 템플릿입니다. 여러 메시지 유형을 지원합니다. 아래에서 자세한 내용을 참조하세요.
템플릿 매개변수
Anchor link to

유형: image_carousel

매개변수
유형
필수설명
alt_textstring예푸시 미리보기 및 지원되지 않는 장치에 표시되는 대체 텍스트입니다. 최대 400자.
columnsarray of objects예이미지 열의 배열입니다(1-10개 지원). 각 열에는 이미지가 포함됩니다.
image_urlstring예각 캐러셀 열에 표시되는 이미지의 URL로, 공개적으로 액세스할 수 있는 JPEG 또는 PNG 파일을 가리킵니다. HTTPS를 사용해야 합니다.
요청 예시
Anchor link to
{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": [
          "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        ],
        "preset": "preset_code",
        "template": {
          "en": {
            "image_carousel": {
              "alt_text": "some text",
              "columns": [
                { "image_url": "https://images.com/1.jpg" },
                { "image_url": "https://images.com/2.jpg" },
                { "image_url": "https://images.com/3.jpg" }
              ]
            }
          }
        }
      }
    ]
  }
}

Flex 메시지 보내기

Anchor link to

Flex 메시지는 텍스트, 이미지, 버튼 및 기타 구성 요소를 사용하여 구조화된 레이아웃을 만들 수 있는 강력하고 사용자 정의 가능한 메시지 유형입니다. 영수증, 제품 카드, 메뉴 또는 시각적 구조화의 이점을 누릴 수 있는 모든 콘텐츠와 같은 사용 사례에 이상적입니다.

Flex 메시지를 보내려면 요청 내에 raw 페이로드가 있는 template 객체를 포함하세요. 메시지 레이아웃은 LINE Flex 메시지 사양을 따라야 합니다.

팁: LINE Flex 메시지 시뮬레이터를 사용하여 Flex 메시지를 디자인하고 미리 볼 수 있습니다.

요청 본문
Anchor link to
매개변수
유형
필수설명
applicationstring예Pushwoosh 애플리케이션 코드
authstring예요청 인증에 사용되는 API 액세스 토큰입니다.
notificationsarray of objects예보낼 메시지 목록입니다.
contentstring예메시지의 대체 또는 미리보기 텍스트로 사용됩니다.
참고: content와 template이 모두 설정된 경우, 템플릿이 사용됩니다.
preset과 content가 모두 포함된 경우, 요청의 콘텐츠가 프리셋을 재정의합니다.
send_datestring예메시지를 보낼 시점입니다. "now" 또는 YYYY-MM-DD HH:mm 형식을 사용하세요.
devicesarray of strings예메시지를 수신할 LINE 장치 토큰(사용자 ID) 목록입니다.
presetstring아니요Pushwoosh 제어판에서 생성한 LINE 프리셋의 코드입니다.
참고: preset과 template이 모두 포함된 경우, 템플릿이 프리셋을 재정의합니다.
preset과 content가 모두 포함된 경우, 요청의 콘텐츠가 프리셋을 재정의합니다.
templateobject예메시지 레이아웃 템플릿입니다. 여러 메시지 유형을 지원합니다. 아래에서 자세한 내용을 참조하세요.
템플릿 매개변수
Anchor link to

Flex 메시지의 경우 원시 구조를 사용하세요. 유형: raw (Flex)

매개변수
유형
필수설명
alt_textstring예알림, 채팅 미리보기 및 인용문에 표시되는 대체 텍스트입니다. 최대 400자.
contentobject예LINE의 Flex 사양에 따라 bubble, box, text 및 기타 구성 요소를 사용하여 구조화된 Flex 메시지 레이아웃입니다.
요청 예시
Anchor link to
{
  "request": {
    "application": "XXXXXX-XXXXXX",
    "auth": "**************************************",
    "notifications": [
      {
        "content": "test",
        "send_date": "now",
        "devices": ["XXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"],
        "preset": "preset_code",
        "template": {
          "en": {
            "raw": {
              "alt_text": "My raw template",
              "content": {
                "type": "bubble",
                "body": {
                  "type": "box",
                  "layout": "vertical",
                  "contents": [
                    {
                      "type": "text",
                      "text": "RECEIPT",
                      "weight": "bold",
                      "color": "#1DB446",
                      "size": "sm"
                    }
                    // Additional components...
                  ]
                }
              }
            }
          }
        }
      }
    ]
  }
}