Tautan m.me

Dokumen ini menunjukkan kepada Anda cara membuat tautan m.me untuk pengalaman Messenger Anda.

m.me adalah layanan URL singkat yang dioperasikan oleh Meta yang mengarahkan pengguna ke seseorang, halaman, atau percakapan di Messenger. Anda dapat menggunakannya di situs web Anda, buletin email, dan banyak lagi.

Cara Kerjanya

Format tautan m.me adalah sebagai berikut, di mana PAGE-NAME adalah Halaman Facebook yang terhubung ke aplikasi berkirim pesan Anda.

Ketika seseorang mengeklik tautan m.me, dia akan diarahkan ke percakapan baru dengan bisnis Anda atau percakapan yang sudah ada jika orang tersebut telah mengirim pesan ke bisnis Anda di masa lalu. Pesan berikut akan muncul dalam percakapan: "Anda telah memasuki percakapan ini dengan mengikuti tautan. Kami telah memberi tahu PAGE-NAME bahwa Anda ada di sini."

Anda dapat menambahkan parameter text agar juga menyertakan pesan yang disesuaikan.

Bisnis dapat membagikan tautan yang mengarahkan ke situs web atau utas lain, beberapa di antaranya mungkin termasuk teks yang terisi otomatis.

Ketika seseorang mengeklik tombol Mulai untuk memulai percakapan dengan bisnis Anda, notifikasi Webhooks messaging_postbacks akan dikirim ke server Webhooks Anda. Sebagai bagian dari notifikasi Webhooks ini, objek postback akan berisi objek referral dengan parameter ref.

Ketika seseorang mengeklik tautan m.me dan percakapan sudah ada antara bisnis Anda dan orang tersebut, tautan tersebut akan membawanya ke percakapan yang ada. Tindakan ini akan mereset periode berkirim pesan standar 24 jam, yang memungkinkan aplikasi berkirim pesan Anda untuk membalas orang tersebut dan notifikasi Webhooks messaging_referrals akan dikirim ke server Webhooks Anda. Sebagai bagian dari notifikasi Webhooks ini, parameter ref dari tautan m.me akan disertakan.

Parameter Perujuk

Tautan m.me dapat berisi parameter ref yang akan memberi bisnis Anda konteks selengkapnya tentang percakapan ketika seseorang mengeklik tautan tersebut, seperti tautan di situs web Anda versus tautan di toko. Jenis tautan ini juga dapat mengarahkan orang ke konten atau fitur tertentu yang tersedia dalam pengalaman Messenger Anda.

Kode QR

Tautan m.me dengan parameter ref dapat disematkan ke Kode QR. Kode yang kompatibel dengan QR dapat dipindai dengan kamera native telepon seluler. Saat dipindai, kode akan membuka aplikasi Messenger dan percakapan pesan dengan bisnis Anda.

Contoh Kode QR Contoh kode QR dengan http://m.me/OriginalCoastClothing?ref=summer_coupon tersemat yang akan memicu alur contoh tentang kupon diskon di Messenger.

Notifikasi Webhooks

Ketika Anda menerima notifikasi Webhooks, itu akan berisi informasi dari orang yang memulai percakapan dengan bisnis Anda atau dari orang yang memiliki percakapan yang sudah ada dengan bisnis Anda.

Memulai Percakapan

Ketika seseorang mengeklik tombol Mulai untuk memulai percakapan dengan bisnis Anda, kami akan menyampaikan parameter ref sebagai bagian dari notifikasi Webhooks 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",
    }
  }
}

Melanjutkan Percakapan yang Ada

Jika sudah ada percakapan antara bisnis Anda dan orang yang mengeklik tautan m.me, notifikasi Webhooks messaging_referrals akan dikirim.

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

Sebelum Memulai

Anda akan memerlukan:

• Akses Lanjutan untuk aplikasi yang tertaut ke Halaman Facebook bisnis Anda
• Tombol Mulai untuk pengalaman Messenger Anda untuk percakapan baru
• Aplikasi yang tertaut ke Halaman Facebook bisnis Anda harus berlangganan kolom Webhooks messaging_postbacks dan messaging_referrals

Batasan

• Aplikasi dengan Akses Standar hanya bisa mendapatkan informasi dari orang-orang yang memiliki peran developer, penguji, atau admin di aplikasi berkirim pesan Anda

Permintaan Persetujuan Ikut Serta Pesan Marketing

URL m.me/rn memungkinkan Anda untuk membuat permintaan persetujuan ikut serta notifikasi berulang dengan tautan m.me. Format untuk tautan m.me/rn harus menyertakan topik untuk notifikasi berulang. Anda dapat mengatur frekuensi notifikasi berulang. Jika tidak, default-nya adalah harian.

Batasan

• iOS versi 383 diperlukan agar m.me/rn berfungsi dengan benar. Orang yang mengeklik tautan Anda akan diarahkan ke URL m.me dasar Anda, URL http://m.me/PAGE-NAME

Contoh Tautan Pesan Marketing

Mendaftarkan Topik Anda

Sebelum Anda dapat menggunakan URL m.me/rn dengan topik baru, Anda harus terlebih dahulu mendaftarkan topik baru.

Jika Anda menggunakan topik yang telah Anda gunakan sebelumnya di URL m.me/rn dan orang-orang telah ikut serta untuk menerima notifikasi berulang, Anda tidak perlu mendaftarkan topik lagi.

Anda dapat mendaftarkan topik baru dengan mengikuti langkah-langkah ini:

Langkah 1. Kirimi diri Anda permintaan persetujuan ikut serta notifikasi berulang dengan topik kepada orang yang memiliki peran di aplikasi Anda. Kami merekomendasikan penambahan payload untuk menunjukkan bahwa ini adalah untuk mendaftarkan topik Anda.

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"

Setelah berhasil, aplikasi Anda menerima tanggapan JSON berikut:

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

Langkah 2. Pastikan untuk mengeklik tombol ikut serta dalam percakapan. Kami akan mengirimi Anda notifikasi Webhooks ikut serta. Topik Anda sekarang terdaftar dan siap untuk digunakan publik.

Contoh Permintaan

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"

Setelah berhasil, aplikasi akan menerima tanggapan JSON berikut:

{ "success": true }

Notifikasi Webhooks messaging_optins

Ketika Anda menerima notifikasi Webhooks, itu akan berisi informasi dari orang yang memulai percakapan dengan bisnis Anda atau dari orang yang memiliki percakapan yang sudah ada dengan bisnis Anda.

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

Referensi m.me

Langkah Berikutnya

• Mengirim Balasan
• Mengirim Notifikasi Berulang

Lihat Juga

• Lihat halaman Parameter Rujukan di Contoh Panduan Original Coast Clothing
• Kunjungi referensi messaging_optins
• Kunjungi referensi messaging_postbacks untuk informasi selengkapnya tentang kolom Webhooks ini
• Kunjungi referensi messaging_referrals untuk informasi selengkapnya tentang kolom Webhooks ini