Terhubung dengan Orang Di Aplikasi dan Bot di Messenger

Merupakan hal yang umum bagi bisnis untuk menggunakan beberapa saluran untuk berkomunikasi dengan pelanggannya, mis,. situs web, aplikasi seluler, dan Messenger. Saat seseorang menggunakan Facebook Login pada situs web atau aplikasi seluler, sebuah ID dibuat untuk aplikasi Facebook tertentu, yang disebut dengan ID lingkup aplikasi. Saat seseorang berinteraksi dengan bisnis melalui Messenger, ID dibuat untuk Halaman tertentu yang terkait dengan bot di Messenger, yang disebut dengan ID lingkup Halaman. Ini berarti, untuk orang yang sama, ID di saluran komunikasi yang berbeda juga berbeda. Perlu diingat bahwa ID lingkup aplikasi dibuat saat pengguna masuk dengan aplikasi Anda, jadi Anda tidak akan melihat ID yang dicadangkan untuk pengguna yang belum terpasang, dan masuk dengan aplikasi Anda.

Sebuah bisnis mungkin ingin memberikan pengalaman mulus bagi orang-orang di berbagai saluran. Misalnya, saat seseorang berkomunikasi dengan sebuah bisnis melalui bot di Messenger, pengalaman ini dapat menjadi lebih disesuaikan jika bisnis menyadari bahwa orang tersebut adalah pelanggan yang sudah ada di aplikasi Facebook mereka (mis. situs web atau aplikasi seluler dengan Facebook Login). Kami menyediakan API untuk mengambil ID untuk orang yang sama di semua aplikasi dan bot di Messenger yang dimiliki oleh bisnis yang sama.

Pertama, Anda harus mengizinkan Facebook untuk mengetahui bahwa aplikasi dan Halaman Anda yang terkait dengan bot Anda di Messenger dimiliki oleh entitas bisnis yang sama. Untuk melakukan ini, Anda harus menggunakan Pengelola Bisnis Facebook untuk:

Lalu Anda dapat mengkueri edge ids_for_apps atau ids_for_pages untuk node pengguna guna mengambil ID.

Panggilan awal Anda ke API dapat memicu peninjauan aplikasi yang dapat memakan waktu sekitar 48 jam untuk menyelesaikannya.

Dokumen ini mencakup:

Contoh Penggunaan
Contoh Kueri
Kebijakan

Contoh Penggunaan

Ada beberapa kasus penggunaan utama untuk API ini:

Dengan menggunakan ID pengguna untuk bot di Messenger, mengambil ID untuk aplikasi yang dimiliki oleh bisnis yang sama

Node Pengguna: ID lingkup Halaman yang terkait dengan bot di Messenger.
Edge:ids_for_apps
Persyaratan: Ini membutuhkan token akses halaman dan appsecret_proof, yang keduanya harus dihasilkan menggunakan aplikasi yang mengelola Halaman tersebut. Selain itu, aplikasi yang mengelola halaman dan aplikasi lain yang dihubungkan harus dimiliki oleh bisnis yang sama.

Contoh:

Ini mengembalikan ID untuk semua aplikasi yang dimiliki oleh bisnis yang sama

GET /{user-id}/ids_for_apps
    ?access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]

Ini mengembalikan ID untuk aplikasi tertentu dengan ID aplikasi 10152368852405295

GET /{user-id}/ids_for_apps
    ?app=10152368852405295
    &access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]

Dengan menggunakan ID pengguna untuk aplikasi, mengambil ID untuk bot di Messenger yang dimiliki oleh bisnis yang sama

Node Pengguna: ID lingkup aplikasi.
Edge:ids_for_pages
Persyaratan: Ini membutuhkan token akses halaman dan appsecret_proof, yang keduanya harus dihasilkan menggunakan aplikasi yang mengelola Halaman, dan yang dilingkupi ID. Selain itu, aplikasi dan Halaman harus dimiliki oleh bisnis yang sama.

Contoh:

Ini mengembalikan ID untuk semua bot di Messenger yang Halaman terkaitnya dimiliki oleh bisnis yang sama

GET /{user-id}/ids_for_pages
    ?access_token=[app_access_token]
    &appsecret_proof=[appsecret_proof]

Ini mengembalikan ID untuk bot tertentu di Messenger yang Halaman terkaitnya memiliki ID halaman 380374449010653

GET /{user-id}/ids_for_pages
    ?page=380374449010653
    &access_token=[app_access_token]
    &appsecret_proof=[appsecret_proof]

Dengan menggunakan ID pengguna untuk aplikasi, mengambil ID untuk aplikasi lain yang dimiliki oleh bisnis yang sama

Node Pengguna: Node pengguna adalah ID lingkup aplikasi.
Edge:ids_for_apps
Persyaratan: Ini membutuhkan token akses aplikasi, yang dihasilkan dengan menggunakan aplikasi yang menjadi lingkup ID ini. Selain itu, aplikasi harus dimiliki oleh bisnis yang sama.

Contoh:

Ini mengembalikan ID untuk semua aplikasi yang dimiliki oleh bisnis yang sama
```
GET /{user-id}/ids_for_apps
    ?access_token=[app_access_token]
```

Ini mengembalikan ID untuk aplikasi tertentu dengan ID aplikasi 10152368852405295

GET /{user-id}/ids_for_apps
    ?app=10152368852405295
    &access_token=[app_access_token]

Dengan menggunakan ID untuk Halaman (yang terkait dengan bot), mengambil ID untuk Halaman lain yang dimiliki oleh bisnis yang sama

Node Pengguna: ID lingkup Halaman yang terkait dengan bot di Messenger.
Edge:ids_for_pages
Persyaratan: Ini membutuhkan token akses halaman dan appsecret_proof, yang keduanya harus dihasilkan menggunakan aplikasi yang mengelola Halaman tersebut. Selain itu, Halaman harus dimiliki oleh bisnis yang sama.

Contoh:

Ini mengembalikan ID untuk semua Halaman yang dimiliki oleh bisnis yang sama

GET /{user-id}/ids_for_pages
    ?access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]

Ini mengembalikan ID untuk Halaman tertentu dengan ID aplikasi 380374449010653

GET /{user-id}/ids_for_pages
    ?app=380374449010653
    &access_token=[page_access_token]
    &appsecret_proof=[appsecret_proof]

Contoh Kueri

Mengambil ID terkait dari ID untuk aplikasi

GET /{user-id}
    ?fields=name,age_range,ids_for_apps,ids_for_pages
    &access_token=[app_access_token]

Contoh tanggapan:

{
  "name": "John Smith",
  "age_range": {
    "min": 21
  },
  "ids_for_apps": {
    "data": [
      {
        "id": "10152368852405295",
        "app": {
          "category": "Business",
          "link": "https://www.facebook.com/games/?app_id=1419232575008550",
          "name": "John's Game App",
          "id": "1419232575008550"
        }
      },
      {
        "id": "645195294",
        "app": {
          "link": "https://apps.facebook.com/johnsmovieappns/",
          "name": "JohnsMovieApp",
          "namespace": "johnsmovieappns",
          "id": "259773517400382"
        }
      }
    ],
    "paging": ...
  },
  "ids_for_pages": {
    "data": [
      {
        "id": "12345123", // The psid for the user for that page
        "page": {
          "category": "Musician",
          "link": "https://www.facebook.com/Johns-Next-Great-Thing-380374449010653/",
          "name": "John's Next Great Thing",
          "id": "380374449010653"
        }
      }
    ],
    "paging": ...
  },
  "id": "645195294"
}

Mengambil ID terkait dari ID untuk bot di Messenger

GET /{user-id}
    ?fields=name,is_payment_enabled,ids_for_apps,ids_for_pages
    &access_token=[page_access_token]
    &appsecret_proof=[appsecrete_proof]

Contoh tanggapan:

{
  "name": "John Smith",
  "is_payment_enabled": true,
  "ids_for_apps": {
    "data": [
      {
        "id": "10152368852405295",
        "app": {
          "category": "Business",
          "link": "https://www.facebook.com/games/?app_id=1419232575008550",
          "name": "John's Game App",
          "id": "1419232575008550"
        }
      },
      {
        "id": "645195294",
        "app": {
          "link": "https://apps.facebook.com/johnsmovieappns/",
          "name": "JohnsMovieApp",
          "namespace": "johnsmovieappns",
          "id": "259773517400382"
        }
      }
    ],
    "paging": ...
  },
  "ids_for_pages": {
    "data": [
      {
        "id": "12345123", // The psid for the user for that page
        "page": {
          "category": "Musician",
          "link": "https://www.facebook.com/Johns-Next-Great-Thing-380374449010653/",
          "name": "John's Next Great Thing",
          "id": "380374449010653"
        }
      }
    ],
    "paging": ...
  },
  "id": "645195294"
}

Kebijakan

API hanya dapat digunakan oleh bisnis untuk menghubungkan ID untuk aplikasi bisnis tersebut atau Halaman dengan aplikasi atau Halaman yang dimiliki dan dikelola atas nama bisnis yang sama. Misalnya, penyedia layanan tidak dapat menggunakan API untuk mendukung beberapa pelanggan.

Untuk potensi pelanggaran terhadap kebijakan ini, permintaan API Anda akan tunduk pada peninjauan dan mengembalikan pesan kesalahan “(#200) Bisnis Anda saat ini sedang dalam proses peninjauan untuk mengakses API ini.”