Messenger 플랫폼

m.me 링크

이 문서에서는 Messenger 경험의 m.me 링크를 만드는 방법을 보여줍니다.

m.me는 Meta에서 운영하는 URL 서비스로, 사용자를 사용자, 페이지 또는 Messenger 내 대화로 리디렉션합니다. 웹사이트, 이메일 뉴스레터 등에서 이 서비스를 사용할 수 있습니다.

사용 방법

m.me 링크의 형식은 다음과 같습니다. 이때 PAGE-NAME은 메시지 앱에 연결된 Facebook 페이지입니다.

http://m.me/PAGE-NAME

사용자가 m.me 링크를 클릭하면 비즈니스와의 새로운 대화로 리디렉션되거나, 과거에 비즈니스와 메시지를 주고받은 경험이 있다면 기존의 대화로 리디렉션됩니다. 대화에 "링크를 따라 이 대화에 참여했습니다. 회원님이 대화에 참여한 것을 PAGE-NAME에 알렸습니다."라는 기본 메시지가 대화에 표시됩니다.

text 매개변수를 추가하여 맞춤 메시지도 포함할 수 있습니다.

http://m.me/PAGE-NAME?text=Hello%20and%20Welcome

비즈니스는 웹사이트나 다른 스레드로 리디렉션되는 링크를 공유할 수 있습니다. 그중 일부에는 미리 입력된 텍스트가 포함될 수 있습니다.

사용자가 시작하기 버튼을 클릭하여 비즈니스와의 대화를 시작하면 messaging_postbacks Webhooks 알림이 Webhooks 서버로 전송됩니다. 이 Webhooks 알림의 postback 개체에 ref 매개변수가 포함된 referral 개체가 포함됩니다.

사용자가 m.me 링크를 클릭할 때 비즈니스와 사용자 사이에 이미 대화가 존재하면 링크를 통해 기존 대화로 이동합니다. 이 행동은 24시간 표준 메시지 전송 기간을 재설정하므로 메시지 앱에서 사용자에게 답장이 가능하며 messaging_referrals Webhooks 알림은 Webhooks 서버로 전송됩니다. 이 Webhooks 알림에 m.me 링크의 ref 매개변수가 포함됩니다.

리퍼럴 매개변수

m.me 링크에는 ref 매개변수가 포함될 수 있는데, 사용자가 링크를 클릭하면 대화에 대한 자세한 컨텍스트(예: 웹사이트의 링크 vs. 매장 내 링크)를 비즈니스에 제공합니다. 이러한 유형의 링크는 Messenger 경험 내에서 사용할 수 있는 특정 콘텐츠나 기능으로 사용자를 이동시킬 수도 있습니다.

http://m.me/PAGE-NAME?ref=REF-PARAMETER-INFORMATION

QR 코드

ref 매개변수를 포함한 m.me 링크는 QR 코드에 포함할 수 있습니다. QR 호환 코드는 휴대폰의 네이티브 카메라로 스캔할 수 있습니다. QR 코드를 스캔하면 Messenger 앱이 열리고 비즈니스와의 메시지 대화가 열립니다.

QR 코드 예시

예시 QR 코드는 http://m.me/OriginalCoastClothing?ref=summer_coupon이 인코딩되어 있어서 Messenger에서 할인 쿠폰에 대한 예시 플로를 트리거합니다.

Webhooks 알림

Webhooks 알림을 받으면 비즈니스와 대화를 시작하는 사용자나 기존에 비즈니스와 대화를 나누던 사용자의 정보가 포함되어 있을 것입니다.

대화 시작하기

사용자가 시작하기 버튼을 클릭하여 비즈니스와 대화를 시작하면 messaging_postbacks Webhooks 알림에서 ref 매개변수를 전송합니다.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "postback":{
    "payload":"POSTBACK-PAYLOAD-YOU-CONFIGURED",
    "referral": {
      "ref": "REF-PARAMETER-INFORMATION",
      "source": "SHORTLINK",
      "type": "OPEN_THREAD",
    }
  }
}

기존 대화 계속하기

비즈니스와 m.me 링크를 클릭한 사용자 사이에 이미 대화가 존재할 경우 messaging_referrals Webhooks 알림이 전송됩니다.

{
  "sender":{
    "id":"PSID"
  },
  "recipient":{
    "id":"PAGE-ID"
  },
  "timestamp":1458692752478,
  "referral": {
    "ref": "REF-PARAMETER-INFORMATION",
    "source": "SHORTLINK",
    "type": "OPEN_THREAD",
  }
}

시작하기 전에

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

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

  • 비즈니스의 Facebook 페이지와 연결된 앱에 대한 Advanced Access
  • 새로운 대화를 위한 Messenger 경험의 시작하기 버튼
  • messaging_postbacks 및 messaging_referrals Webhooks 필드를 구독하는 비즈니스의 Facebook 페이지에 연결된 앱

제한 사항

  • Standard Access 권한이 있는 앱은 메시지 앱에서 개발자, 테스터 또는 관리자 역할이 부여된 사용자에게서만 정보를 수집할 수 있습니다.

마케팅 메시지 옵트인 요청

m.me/rn URL을 사용하면 m.me 링크로 정기 알림 옵트인 요청을 만들 수 있습니다. m.me/rn 링크의 형식에는 정기 알림의 주제를 포함해야 합니다. 정기 알림의 빈도를 설정할 수 있으며, 설정하지 않으면 기본값이 매일로 설정됩니다.

http://m.me/rn/PAGE-NAME?topic=TOPIC&cadence=MESSAGE-FREQUENCY

제한 사항

  • m.me/rn 링크가 올바르게 작동하려면 iOS 버전 383이 필요합니다. 링크를 클릭한 사람은 기본 m.me URL인 http://m.me/PAGE-NAME URL로 리디렉션됩니다.

마케팅 메시지 예시 링크

https://m.me/rn/OriginalCoastClothing?topic=weekly%20deals&cadence=weekly

주제 등록

새로운 주제로 m.me/rn URL을 사용할 수 있게 되기 전에 먼저 새로운 주제를 등록해야 합니다.

이전의 m.me/rn URL에서 사용한 주제를 사용하고 있고 사람들이 정기 알림을 수신하도록 옵트인한 경우 주제를 다시 등록할 필요가 없습니다.

다음 단계에 따라 새 주제를 등록할 수 있습니다.

1단계. 앱에서 역할이 부여된 사용자에 대한 주제를 포함하여 정기 알림 옵트인 요청을 자신에게 보냅니다. 자신의 주제를 등록하기 위한 것임을 나타내는 페이로드를 추가하는 것이 좋습니다.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
          "title":"TITLE",
          "payload": "Registering a new topic: TOPIC-NAME",
          "notification_messages_frequency": MESSAGE-FREQUENCY,
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

성공할 경우 앱은 다음과 같은 JSON 응답을 받습니다.

{ 
        "recipient": {
          "id":"PSID",
          "message_id":"MESSAGE-ID",
}

2단계. 대화에서 옵트인 버튼을 클릭합니다. Facebook에서 옵트인 Webhooks 알림을 보냅니다. 이제 주제가 등록되고 공개적으로 사용할 수 있습니다.

등록되지 않은 주제의 m.me/rn 링크를 클릭하는 사람은 기본 정기 알림 URL인 http://m.me/rn/PAGE-NAME URL로 리디렉션됩니다.

주제를 등록할 때 자신에게 옵트인 요청을 보냈지만 옵트인 버튼을 클릭하지 않은 경우, 주제가 등록되지 않습니다.

요청 샘플

가독성을 높이기 위해 형식을 지정했습니다.
curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

성공할 경우 앱은 다음과 같은 JSON 응답을 받습니다.

{ "success": true }

messaging_optins Webhooks 알림

Webhooks 알림을 받으면 비즈니스와 대화를 시작하는 사용자나 기존에 비즈니스와 대화를 나누던 사용자의 정보가 포함되어 있을 것입니다.

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "title": "TITLE-FOR-NOTIFICATION-MESSAGE",
    "ref": "REF-PARAMETER-INFORMATION",
    "payload": "",
    "source":"SHORTLINK"
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_topic": "RECURRING-NOTIFICATION-TOPIC", 
    "notification_messages_frequency": "MESSAGE-FREQUENCY",
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS"
    }
}

m.me 참고 자료

매개변수 이름설명

cadence

enum { daily, monthly, weekly }

m.me/rn 링크 옵트인 요청의 메시지 빈도. 기본값은 daily입니다.

ref

문자열

messaging_referrals Webhooks 알림으로 전송되는 대화 관련 컨텍스트(예: 웹사이트 링크 vs. 매장 내 링크). 이 매개변수는 m.me 링크에서 사용될 때 URL로 인코딩되어야 합니다. 이 값의 길이는 2,083자를 초과할 수 없습니다.

text

문자열

누군가가 대화에 들어가기 위해 m.me 링크를 클릭했을 때 전송되는 맞춤 메시지.

topic

문자열 		필수 항목.

m.me/rn 링크 옵트인 요청에 대한 주제(예: 주간 프로모션, 새로운 릴리스). 이 매개변수는 m.me 링크에서 사용될 때 URL로 인코딩되어야 합니다. 특수 문자 없이 영문자와 숫자를 URL로 인코딩해야 합니다.

다음 단계

기타 참고 자료