WhatsApp Business 플랫폼 온프레미스 API

스티커팩 관리

/v1/stickerpacks

stickerpacks 노드를 사용하여 자사 및 타사 스티커팩과 스티커를 모두 관리할 수 있습니다.

이 문서에서 다루는 내용은 다음과 같습니다.

자사 스티커팩

자사 스티커팩 검색

요청

GET /v1/stickerpacks?namespace=whatsapp

응답

{
  "stickerpacks": [
    {"id": "sticker-pack-id1"},
    {"id": "sticker-pack-id2"}
  ]
}

자사 스티커팩 정보 검색

요청

GET /v1/stickerpacks/sticker-pack-id?namespace=whatsapp

응답

{
  "stickerpacks": [
    {
      "publisher" : "sticker-pack-publisher-name",
      "name": "sticker-pack-name"
    }
  ]
}

자사 스티커

자사 스티커 검색

요청

GET /v1/stickerpacks/sticker-pack-id/stickers?namespace=whatsapp

응답

{
  "stickers": [
    {"index": "sticker-index1"},
    {"index": "sticker-index2"}
  ]
}

자사 스티커 정보 검색

요청

GET /v1/stickerpacks/sticker-pack-id/stickers/sticker-index?namespace=whatsapp

응답

{
  "stickers": [
    {
      "id": "sticker-media-id" # ex: b942a4d1-4e1d-4c56-8cfa-a848b8222061
      "emojis": ["🐥", "😃"],
    }
  ]
}

타사 스티커팩

타사 스티커팩 만들기

요청

POST /v1/stickerpacks
{
  "publisher" : "your-publisher-name",
  "name": "your-sticker-pack-name",
  "ios_app_store_link" : "https://itunes.apple.com/app/id3133333",
  "android_app_store_link" : "https://play.google.com/store/apps/details?id=com.example",
}

매개변수

이름필수설명

publisher

예

타사 스티커팩 퍼블리셔 이름

name

예

스티커팩 이름

ios_app_store_link

아니요

Apple iOS App Store의 스티커팩 링크
링크는 https://itunes.apple.com/app/idXXXXXXXXX 형식을 준수
App Store 링크를 가져오려면 https://stackoverflow.com/questions/4137426/get-itunes-link-for-app-before-submitting의 지침 참조

android_app_store_link

아니요

Google Play Store의 스티커팩 링크
링크는 https://play.google.com/store/apps/details?id=com.example 형식을 준수하며 여기에서 com.example은 앱의 패키지 이름에 해당

응답

{
  "stickerpacks": [
    {
      "id": "sticker-pack-id"
    }
  ]
}

타사 스티커팩 검색

요청

GET /v1/stickerpacks

응답

{
  "stickerpacks": [
    {"id": "sticker-pack-id1"},
    {"id": "sticker-pack-id2"}
  ]
}

타사 스티커팩 정보 검색

요청

GET /v1/stickerpacks/your-sticker-pack-id

응답

{
  "stickerpacks": [
    {
      "publisher" : "sticker-pack-publisher-name",
      "name": "sticker-pack-name",
      "ios_app_store_link" : "https://itunes.apple.com/app/id3133333",
      "android_app_store_link" : "https://play.google.com/store/apps/details?id=com.example",
    }
  ]
}

타사 스티커팩 업데이트

요청

PATCH /v1/stickerpacks/your-sticker-pack-id
{
  "publisher" : "your-publisher-name",
  "name": "your-sticker-pack-name",
  "ios_app_store_link" : "https://itunes.apple.com/app/id3133333",
  "android_app_store_link" : "https://play.google.com/store/apps/details?id=com.example",
}

매개변수

이름필수설명

publisher

아니요

타사 스티커팩 퍼블리셔 이름

name

아니요

스티커팩 이름

ios_app_store_link

아니요

Apple iOS App Store의 스티커팩 링크
링크는 https://itunes.apple.com/app/idXXXXXXXXX 형식을 준수
App Store 링크를 가져오려면 https://stackoverflow.com/questions/4137426/get-itunes-link-for-app-before-submitting의 지침 참조

android_app_store_link

아니요

Google Play Store의 스티커팩 링크
링크는 https://play.google.com/store/apps/details?id=com.example 형식을 준수하며 여기에서 com.example은 앱의 패키지 이름에 해당

응답

성공적인 응답에는 200 OK와 null 또는 {}가 표시됩니다.

null or {}

타사 스티커팩 삭제

요청

DELETE /v1/stickerpacks/your-sticker-pack-id

응답

성공적인 응답에는 200 OK와 null 또는 {}가 표시됩니다.

null or {}

타사 스티커

타사 스티커 만들기

요청

POST /v1/stickerpacks/your-sticker-pack-id/stickers
{
  "image_data_id" : "your-sticker-image-media-id",
  "emojis": ["🐥", "😃"]
}

매개변수

이름필수설명

image_data_id

예

스티커 미디어의 ID

emojis

아니요

스티커팩에 포함된 이모티콘 배열

응답

{
  "stickers": [{
    "index": "sticker-index"
  }]
}

타사 스티커 검색

요청

GET /v1/stickerpacks/your-sticker-pack-id/stickers

응답

{
  "stickers": [
    {"index": "sticker-index1"},
    {"index": "sticker-index2"}
  ]
}

타사 스티커 정보 검색

요청

GET /v1/stickerpacks/your-sticker-pack-id/stickers/your-sticker-index

응답

{
  "stickers": [
    {
      "id": "sticker-media-id" # ex: b942a4d1-4e1d-4c56-8cfa-a848b8222061
      "emojis": ["🐥", "😃"],
      "image_data_id" : "sticker-image-media-id",
    }
  ]
}

타사 스티커 업데이트

요청

PATCH /v1/stickerpacks/your-sticker-pack-id/stickers/your-sticker-index
{
  "image_data_id" : "your-sticker-image-media-id",
  "emojis": ["🐥", "😃"],
}

매개변수

이름필수설명

image_data_id

아니요

스티커 미디어의 ID

emojis

아니요

스티커팩에 포함된 이모티콘 배열

응답

성공적인 응답에는 200 OK와 null 또는 {}가 표시됩니다.

null or {}

타사 스티커 삭제

요청

DELETE /v1/stickerpacks/your-sticker-pack-id/stickers/your-sticker-index

응답

성공적인 응답에는 200 OK와 null 또는 {}가 표시됩니다.

null or {}