Messenger 플랫폼

일회성 알림(베타)

요약

Messenger 플랫폼의 일회성 알림 API(베타)를 사용하면 24시간 메시지 전송 기간이 끝나고 페이지가 사용자에게 한 번의 후속 메시지를 보내달라고 요청할 수 있습니다. 사용자에게 향후 알림을 받을지 선택권을 제공합니다. 사용자가 알림을 받기로 하면 페이지는 토큰을 받습니다. 이 토큰은 사용자에게 단일 메시지를 보낼 수 있는 권한과 같습니다. 이 토큰은 한 번만 사용할 수 있고 생성 후 1년 이내에 만료됩니다.




권한

이 API를 사용하고자 하는 페이지는 페이지 설정의 "고급 메시지" 섹션에서 "일회성 알림" 권한을 요청해야 합니다. 페이지가 베타 약관에 동의하면 Facebook의 기준을 충족할 경우 권한이 부여됩니다.




목차

사용 방법

일회성 알림 요청 보내기

페이지는 보내기 API를 사용하여 알림 요청 메시지를 템플릿으로 보낼 수 있습니다. 템플릿 유형은 one_time_notif_req가 되어야 합니다. 요청의 본문은 모든 템플릿 유형의 표준 형식을 따르며 유형 및 각 템플릿 유형에 대한 특정 콘텐츠 상세 정보가 포함된 message.attachment.payload 속성을 사용합니다. 요청의 제목과 페이로드만 맞춤 설정할 수 있습니다. title 필드는 65자로 제한됩니다.

{
  "recipient": {
    "id":"

일회성 알림 요청 템플릿이 렌더링되고 사용자가 알림 받기 버튼을 클릭하면 message_optins Webhooks가 백엔드로 전달됩니다. 그 후 one_time_notif_token을 사용하여 24시간 제한 시간이 끝나고 사용자에게 후속 메시지를 1회 보낼 수 있습니다.

후속 메시지 보내기

후속 메시지를 보내려면 POST 요청을 보내기 API에 제출하고 Webhooks를 통해 one_time_notif_token을 받고 요청 본문에 message.text를 설정합니다.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "one_time_notif_token":"<ONE_TIME_TOKEN>"
  },
  "message": {
    "text":"<MESSAGE_CONTENT>"
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

서식이 있는 메시지를 보내려면 텍스트를 서식이 있는 내용으로 바꾸세요. 지원되는 메시지 유형의 전체 리스트는 보내기 API 참고 자료를 참조하세요. one_time_notif_token은 한 번만 사용할 수 있으며 메시지가 전송되는 즉시 무효화됩니다.

Webhooks 이벤트

사용자가 특정 업데이트에 대한 알림을 받는 데 동의하면 payload와 one_time_notif_token이 포함된 Webhooks 이벤트를 가져옵니다. 정보가 있을 때 후속 메시지를 보내려면 페이로드와 토큰을 모두 저장해야 합니다. one_time_notif_token 리스트를 쿼리하는 별도의 API가 없기 때문에 Webhooks 정보를 받은 그대로 처리하고 저장하는 것이 중요합니다. 각 토큰은 한 번만 사용할 수 있으며 생성 시점에서 1년 이내에 만료됩니다.

{
   "sender": {
     "id":"<PSID>"
   },
   "recipient": {
     "id":"<PAGE_ID>"
   },
   "timestamp":1458692752478,
   "optin": {
     "type": "one_time_notif_req",
     "payload": "<USER_DEFINED_PAYLOAD>",
     "one_time_notif_token":"<ONE_TIME_TOKEN>",
   }
}

제한 사항

  • 페이로드 필드를 사용하여 비밀번호, 사용자 자격 증명, 사용자를 개인적으로 식별하는 정보(즉, 이름, 이메일 주소 등과 같이 그 자체만으로 사용자에게 연락하거나 신원을 식별할 수 있는 정보) 또는 다른 민감한 정보(예: 건강, 금융, 결제, 카드 소유자 데이터 또는 관련 법에서 민감한 정보로 정의한 다른 정보 범주)를 보내지 마세요.
  • 일회성 알림 요청의 횟수는 잘못된 사용자 경험이 되지 않도록 사용 제한이 적용됩니다.

FAQ

자주 묻는 질문 페이지에서 자세한 정보를 참조하세요.

개발자 지원