Messenger로 보내기 플러그인

Facebook 앱이 개발 모드일 때 플러그인과 API 기능은 유효한 세션이 있는 앱의 관리자, 개발자 및 테스터에게만 작동합니다. 앱이 승인되어 공개된 후에는 일반 사용자에게도 작동합니다.

'Messenger로 보내기' 플러그인은 Webhooks에 인증 이벤트를 트리거하는 데 사용됩니다. 데이터를 전달하여 어떤 사용자 및 거래가 인증 이벤트와 연결되었는지 확인하고 백엔드에서 해당 사용자를 링크할 수 있습니다.

사용자가 이 버튼을 처음 클릭하면 확인 팝업이 표시됩니다.

요구 사항

Facebook Javascript SDK

Messenger로 보내기 플러그인을 사용하려면 플러그인을 렌더링할 페이지에 Javascript용 Facebook SDK를 포함해야 합니다.

SDK를 포함하기 위한 지침은 Javascript용 Facebook SDK 빠른 시작을 참조하세요.

설정

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

사용 가능한 속성에 대한 전체적인 설명은 Messenger로 보내기 플러그인 참고 자료를 참조하세요.

이벤트 구독

플러그인 이벤트를 구독합니다.

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

이벤트 필드

필드 이름	유형	설명
`event`	enum	이벤트의 이름. 가능한 값: `rendered`, `clicked`, `not_you`, `opt_in`.
`ref`	문자열	플러그인에서 `data-ref` 매개변수에 설정된 값을 포함합니다. 영숫자, -, _, =만 지원됩니다.
`is_after_optin`	부울	확인 팝업이 확인된 후에 이벤트가 발생했는지 여부를 나타냅니다.
`pluginID`	정의되지 않음	이 필드는 사용하지 않습니다.

Webhooks 이벤트

Messenger로 보내기 플러그인은 messaging_optins Webhooks 이벤트를 트리거합니다.

로그인 동작 맞춤 설정

로그인한 Facebook 사용자가 없을 경우 플러그인이 사용자 ID를 표시하지 않고 렌더링됩니다. 버튼을 클릭하면 사용자에게 로그인하라는 메시지가 표시됩니다.

allow_login을 false로 설정하면 로그인하지 않은 사용자에게는 플러그인이 렌더링되지 않습니다.

앱이 승인되고 공개된 경우에만 Facebook 세션 없이 플러그인이 렌더링됩니다.

CTA 텍스트 옵션

Messenger로 보내기 플러그인은 cta_text 속성도 지원합니다. 이 경우 사전 정의된 문자열 리스트에서 플러그인의 버튼 텍스트를 선택할 수 있습니다. cta_text 속성을 사용할 경우, 대부분의 로그인한 사용자는 팝업으로 다시 확인할 필요 없이 플러그인 버튼 자체만 클릭하여 옵트인할 수 있으며 messaging_optins 이벤트가 즉시 전송됩니다.

cta_text 속성에 대해 지원되는 값은 다음과 같습니다.

GET_THIS_IN_MESSENGER
RECEIVE_THIS_IN_MESSENGER
SEND_THIS_TO_ME
GET_CUSTOMER_ASSISTANCE
GET_CUSTOMER_SERVICE
GET_SUPPORT
LET_US_CHAT
SEND_ME_MESSAGES
ALERT_ME_IN_MESSENGER
SEND_ME_UPDATES
MESSAGE_ME
LET_ME_KNOW
KEEP_ME_UPDATED
TELL_ME_MORE
SUBSCRIBE_IN_MESSENGER
SUBSCRIBE_TO_UPDATES
GET_MESSAGES
SUBSCRIBE
GET_STARTED_IN_MESSENGER
LEARN_MORE_IN_MESSENGER
GET_STARTED