Liên kết m.me

Tài liệu này hướng dẫn bạn cách tạo liên kết m.me cho trải nghiệm Messenger.

m.me là dịch vụ URL do Meta cung cấp nhằm chuyển hướng người dùng đến một người, trang hoặc cuộc trò chuyện trên Messenger. Bạn có thể sử dụng loại liên kết này trên trang web, bản tin qua email và hơn thế nữa.

Cách thức hoạt động

Định dạng của liên kết m.me có dạng như dưới đây, trong đó PAGE-NAME là Trang Facebook được liên kết với ứng dụng nhắn tin của bạn.

Khi một người nhấp vào liên kết m.me, người đó sẽ được chuyển hướng đến cuộc trò chuyện mới với doanh nghiệp bạn hoặc cuộc trò chuyện hiện có nếu người đó từng nhắn tin cho doanh nghiệp. Cuộc trò chuyện này sẽ hiển thị một tin nhắn mặc định có nội dung "Bạn đã tham gia cuộc trò chuyện này thông qua một liên kết. Chúng tôi đã cho PAGE-NAME biết bạn đang ở đây."

Bạn có thể thêm thông số text để bao gồm cả tin nhắn tùy chỉnh.

Doanh nghiệp có thể chia sẻ liên kết chuyển hướng đến các trang web hoặc chuỗi trò chuyện khác. Một số liên kết có thể chứa văn bản điền sẵn.

Khi một người nhấp vào nút Bắt đầu để bắt đầu cuộc trò chuyện với doanh nghiệp bạn, hệ thống sẽ gửi thông báo webhook messaging_postbacks đến máy chủ webhooks của bạn. Trong thông báo webhook này, đối tượng postback sẽ chứa một đối tượng referral cùng với thông số ref.

Khi một người nhấp vào liên kết m.me và doanh nghiệp bạn đã từng trò chuyện với người này, liên kết sẽ chuyển người đó đến cuộc trò chuyện hiện có. Hành động này sẽ đặt lại khoảng thời gian nhắn tin tiêu chuẩn 24 giờ. Nhờ vậy, ứng dụng nhắn tin của bạn có thể trả lời người đó, đồng thời hệ thống sẽ gửi thông báo webhook messaging_referrals đến máy chủ webhooks của bạn. Thông báo webhook này sẽ bao gồm thông số ref từ liên kết m.me.

Thông số tham chiếu

Liên kết m.me có thể chứa thông số ref. Khi một người nhấp vào liên kết này, doanh nghiệp bạn sẽ biết thêm ngữ cảnh về cuộc trò chuyện, chẳng hạn như liên kết trên trang web của bạn hoặc liên kết trong một cửa hàng. Các loại liên kết này cũng có thể chuyển hướng người đó đến nội dung hoặc tính năng cụ thể có trong trải nghiệm Messenger của bạn.

Mã QR

Bạn có thể nhúng liên kết m.me cùng với thông số ref vào Mã QR. Bạn có thể dùng camera gốc của điện thoại để quét mã tương thích với mã QR. Thao tác quét sẽ mở ứng dụng Messenger và cuộc trò chuyện qua tin nhắn với doanh nghiệp bạn.

Mã QR mẫu Mã QR mẫu được mã hóa http://m.me/OriginalCoastClothing?ref=summer_coupon sẽ kích hoạt một quy trình mẫu về phiếu giảm giá trên Messenger.

Thông báo webhook

Khi bạn nhận được thông báo webhook, thông báo này sẽ chứa thông tin từ người đang bắt đầu cuộc trò chuyện với doanh nghiệp bạn hoặc từ người đã từng trò chuyện với doanh nghiệp bạn.

Bắt đầu cuộc trò chuyện

Khi một người nhấp vào nút Bắt đầu để bắt đầu cuộc trò chuyện với doanh nghiệp bạn, chúng tôi sẽ gửi thông số ref trong thông báo webhook messaging_postbacks.

{
  "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",
    }
  }
}

Tiếp tục cuộc trò chuyện hiện có

Nếu doanh nghiệp bạn đã từng trò chuyện với người nhấp vào liên kết m.me, hệ thống sẽ gửi thông báo webhook messaging_referrals.

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

Trước khi bạn bắt đầu

Bạn sẽ cần:

• Quyền truy cập nâng cao cho ứng dụng được liên kết với Trang Facebook của doanh nghiệp bạn
• Nút Bắt đầu cho trải nghiệm Messenger của bạn để tạo cuộc trò chuyện mới
• Ứng dụng được liên kết với Trang Facebook của doanh nghiệp bạn phải đăng ký nhận các trường webhooks messaging_postbacks và messaging_referrals

Các giới hạn

• Các ứng dụng có Quyền truy cập tiêu chuẩn chỉ có thể nhận thông tin từ những người có vai trò nhà phát triển, người dùng thử hoặc quản trị viên trên ứng dụng nhắn tin của bạn

Yêu cầu đồng ý nhận tin nhắn marketing

Với URL m.me/rn, bạn có thể tạo yêu cầu đồng ý nhận thông báo định kỳ qua liên kết m.me. Định dạng của liên kết m.me/rn phải bao gồm chủ đề của thông báo định kỳ. Bạn có thể đặt tần suất nhận thông báo định kỳ. Nếu không, tần suất sẽ được đặt thành hàng ngày theo mặc định.

Các giới hạn

• Bắt buộc có iOS phiên bản 383 để liên kết m.me/rn hoạt động đúng cách. Người nhấp vào liên kết của bạn sẽ được chuyển hướng đến URL m.me cơ sở là URL http://m.me/PAGE-NAME

Liên kết mẫu cho tin nhắn marketing

Đăng ký chủ đề của bạn

Để sử dụng URL m.me/rn với một chủ đề mới, trước tiên, bạn phải đăng ký chủ đề mới đó.

Nếu đang sử dụng một chủ đề bạn đã dùng trong URL m.me/rn trước đó và mọi người đã chọn nhận thông báo định kỳ, bạn không cần đăng ký lại chủ đề đó.

Bạn có thể làm theo các bước sau để đăng ký chủ đề mới:

Bước 1. Tự gửi yêu cầu đồng ý nhận thông báo định kỳ kèm theo chủ đề đến một người có vai trò trên ứng dụng của bạn. Bạn nên thêm phần tải dữ liệu để cho biết hoạt động này nhằm đăng ký chủ đề.

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"

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON sau đây:

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

Bước 2. Đảm bảo nhấp vào nút chọn nhận trong cuộc trò chuyện. Chúng tôi sẽ gửi cho bạn thông báo webhook chọn nhận. Bây giờ, chủ đề của bạn đã được đăng ký và sẵn sàng sử dụng công khai.

Yêu cầu mẫu

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"

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON sau đây:

{ "success": true }

Thông báo webhook messaging_optins

Khi bạn nhận được thông báo webhook, thông báo này sẽ chứa thông tin từ người đang bắt đầu cuộc trò chuyện với doanh nghiệp bạn hoặc từ người đã từng trò chuyện với doanh nghiệp bạn.

{
  "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"
    }
}

Tài liệu tham khảo về m.me

Các bước tiếp theo

• Gửi tin trả lời
• Gửi thông báo định kỳ

Xem thêm

• Xem trang Thông số tham chiếu trên Hướng dẫn mẫu về Original Coast Clothing
• Xem tài liệu tham khảo về messaging_optins
• Xem tài liệu tham khảo về messaging_postbacks để biết thêm thông tin về các trường của webhook này
• Xem tài liệu tham khảo về messaging_referrals để biết thêm thông tin về các trường của webhook này