Messenger 플랫폼

Instagram 메시지를 위한 제품 템플릿

제품 템플릿을 사용하여 제품 카탈로그 에 업로드한 제품 정보가 포함된 Instagram 메시지를 보내세요. 제품 상세 정보(이미지, 제목, 가격)는 제품 카탈로그에서 자동으로 가져옵니다.

제품 템플릿을 사용하여 제품이 하나인 메시지를 만들거나 제품을 수평으로 스크롤할 수 있는 슬라이드가 있는 메시지를 만들 수 있습니다.

시작하기 전에

이 가이드에서는 Messenger 플랫폼 개요를 읽고 메시지와 알림을 주고받는 데 필요한 구성 요소를 구현했다고 가정합니다.

다음과 같은 항목이 필요합니다.

제품 메시지 보내기

누군가에게 제품 메시지를 보내려면 /PAGE-ID/messages 엔드포인트로 POST 요청을 보냅니다. 이때 recipient.id 속성은 메시지를 받는 사람의 Instagram 범위 ID로 설정합니다. message.attachment 개체에 type 및 payload 속성을 포함합니다. type을 template으로 설정하고 payload.template_type 속성을 product로 설정하며 payload.elements를 제품 ID 키-값 쌍의 리스트로 설정합니다.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"INSTAGRAM-SCOPED-ID"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID"
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

슬라이드 보내기

제품 슬라이드를 보내려면 더 많은 제품 키-값 쌍을 payload.elements 속성에 추가합니다. 요청에 최대 10개의 제품을 포함할 수 있습니다.

...
      "payload": {
        "template_type": "product",
        "elements": [
          {
            "id": "PRODUCT-ID-1"
          },
          {
            "id": "PRODUCT-ID-2"
          },
          {
            "id": "PRODUCT-ID-3"
          }
        ]
      }
...

요청이 성공하면 앱이 수신자 ID 및 메시지 ID가 포함된 다음의 JSON 개체를 받습니다.

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}

옵트인 요청 보내기

정기 마케팅 메시지를 받을 사람에게 옵트인 요청을 보내려면 /PAGE-ID/messages 엔드포인트에 POST 요청을 보냅니다. 이때 recipient.id 속성을 메시지를 받는 사람의 Instagram 범위 ID로 설정합니다. messageattachment.payload 속성에서 template_type을 notification_messages로 설정합니다. payload.elements 속성에서 image_url, title, payload, notification_message_frequency 및 notification_messages_cta_text를 포함합니다.

curl -X POST -H "Content-Type:application/json" -d '{
  "recipient": {
    "id": "INSTAGRAM-SCOPED-ID"
  },
  "message": {
    "attachment": {
      "type": "template",
      "payload": {
        "template_type": "notification_messages",
        "elements": [
          {
            "image_url": "IMAGE-URL",
            "title": "TEXT-TO-DISPLAY",
            "payload": "INFORMATION-ABOUT-THIS-MESSAGE",
            "notification_messages_frequency": "DAILY",
            "notification_messages_cta_text": "GET_UPDATES"
          }
        ]
      }
    }
  }
}' "https://graph.intern.facebook.com/LATEST-GRAPH-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

알림 메시지 요소 참고 자료

속성값

image_url

문자열

템플릿에 표시할 이미지의 URL입니다.

notification_messages_cta_text

enum { ALLOW, FREQUENCY, GET, GET_UPDATES, OPT_IN, SIGN_UP }

행동 유도 버튼에 표시되는 텍스트는 다음의 값 중 하나를 사용하여 설정합니다.

  • ALLOW – 옵트인 메시지 버튼 텍스트를 메시지 허용으로 설정
  • FREQUENCY – 옵트인 메시지 버튼 텍스트를 매일 메시지 받기로 설정
  • GET – 옵트인 메시지 버튼 텍스트를 메시지 받기로 설정
  • GET_UPDATES – 옵트인 메시지 버튼 텍스트를 업데이트 받기로 설정. notification_messages_cta_text를 설정하지 않은 경우에도 이는 기본값으로 설정됩니다.
  • OPT_IN – 옵트인 메시지 버튼 텍스트를 메시지 옵트인으로 설정
  • SIGN_UP – 옵트인 메시지 버튼 텍스트를 메시지 신청하기로 설정

notification_messages_frequency

enum { DAILY, WEEKLY, MONTHLY }

이 정기 알림 옵트인 요청에 대한 메시지 빈도입니다.

  • DAILY – 6개월 동안 24시간마다 알림 1개를 받도록 옵트인
  • WEEKLY – 9개월 동안 7일마다 알림 1개를 받도록 옵트인
  • MONTHLY – 12개월 동안 1개월마다 알림 1개를 받도록 옵트인

payload

문자열

이 정기 알림 옵트인 요청의 정기 알림 유형(예: 홍보 메시지 또는 제품 출시 메시지)

title

문자열

템플릿에 표시할 제목이며, 65자 이내여야 합니다. 값을 할당하지 않을 경우 기본값은 '업데이트 및 프로모션'으로 지정됩니다.

다음 단계

정기 마케팅 메시지 수신을 옵트인하도록 하는 방법을 알았으므로 이제 마케팅 메시지를 보내는 방법을 알아보세요.

기타 참고 자료