Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Webhook suapan Halaman Facebook: peristiwa komen, siaran dan reaksi

Medan suapan dalam webhook Halaman Facebook melaporkan hampir semua perubahan pada suapan Halaman sebaik ia berlaku. Setiap perubahan membawa item, seperti siaran, komen atau reaksi, dan verb, seperti add, edit atau remove, serta ID yang terlibat, pengarang dalam from dan teks dalam message. Meta menghantarnya sebagai JSON, ditandatangani dengan X-Hub-Signature-256.

easyCoexistence melanggan setiap Halaman yang anda sambungkan kepada medan feed dan memajukan perubahannya ke endpoint HTTPS anda sebaik ia tiba, ditandatangani dengan rahsia Halaman itu, manakala peraturan komen-ke-DM dan automasi bertindak ke atas komen baharu.

10K likes

Notifikasi suapan bagi suka Halaman hanya dihantar untuk Halaman yang mempunyai kurang suka daripada jumlah ini.

Ad posts

Medan suapan tidak menghantar apa-apa untuk siaran iklan itu sendiri, tetapi menghantar komen pada siarannya.

pages_manage_metadata

Kebenaran yang perlu diberikan oleh pentadbir Halaman yang mempunyai keistimewaan MODERATE agar webhook Halaman sampai ke aplikasi.

1,000

Kebanyakan kemas kini digabungkan oleh Meta menjadi satu penghantaran webhook, walaupun ia tidak menjamin penggabungan.

36 hours

Tempoh masa Meta terus cuba semula penghantaran yang gagal ke endpoint aplikasi, dengan kekerapan yang semakin berkurang.

Apakah yang dilaporkan oleh medan suapan?

Hampir semua perubahan pada suapan Halaman, mengikut istilah Meta, seperti siaran, komen, reaksi dan kongsian; apa yang dibawa oleh sesuatu perubahan bergantung pada jenisnya. Meta tidak menghantar apa-apa untuk siaran iklan itu sendiri, walaupun komen pada siaran tersebut tetap sampai, dan ia hanya menghantar notifikasi suka Halaman selagi Halaman itu mempunyai kurang daripada 10,000 suka.

Apakah maksud item dan verb?

Dua medan dalam nilai setiap perubahan menyatakan apa yang berlaku:

  • item: perkara yang berubah, daripada senarai Meta, yang merangkumi post, status, photo, video, link, share, comment, reaction dan album.
  • verb: apa yang berlaku kepadanya: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute atau update.
  • Komen baharu tiba dengan item comment dan verb add, iaitu apa yang dicari oleh peraturan komen-ke-DM.
  • Reaksi membawa item reaction dan reaction_type yang menamakannya.

Bagaimanakah rupa perubahan suapan?

Satu POST yang JSON-nya mempunyai object ditetapkan kepada page dan satu entry bagi setiap Halaman, memuatkan ID Halaman, masa dan tatasusunan changes. Ini ialah contoh Meta sendiri, seseorang menyiarkan ke Halaman:

A feed change, as Meta sends it
{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1520544816,
      "changes": [
        {
          "field": "feed",
          "value": {
            "from": { "id": "<USER_ID>", "name": "<NAME>" },
            "item": "post",
            "post_id": "<PAGE_POST_ID>",
            "verb": "add",
            "created_time": 1520544814,
            "is_hidden": false,
            "message": "<POST_TEXT>"
          }
        }
      ]
    }
  ]
}

Medan apakah yang boleh dibawa oleh sesuatu perubahan?

Rujukan Meta menyenaraikan antara medan nilai perubahan suapan ini, hadir mengikut jenis perubahan:

  • post_id, comment_id dan parent_id: siaran, komen dan perkara yang dimilikinya.
  • from: ID dan nama pihak yang membuat perubahan.
  • message: teks, dengan link, photo, photos atau video bagi kandungan yang dilampirkan.
  • created_time, dan edited_time bagi suntingan.
  • reaction_type bagi reaksi, dan is_hidden untuk sama ada siaran disembunyikan.
  • post: butiran seperti status_type, is_published, updated_time dan permalink_url.

Bagaimanakah Halaman dilanggan?

Aplikasi menghantar POST /{page-id}/subscribed_apps dengan subscribed_fields=feed dan token Halaman, daripada seseorang yang boleh melaksanakan tugas CREATE_CONTENT, MANAGE atau MODERATE, dengan pages_manage_metadata dan pages_show_list telah diberikan. Meta hanya menghantar notifikasi selagi Halaman mempunyai aplikasi dipasang dan belum mematikan platform aplikasi dalam tetapannya. easyCoexistence melanggan setiap Halaman kepada feed, messages dan mention apabila ia disambungkan.

Bagaimanakah peristiwa suapan sampai ke endpoint anda?

Meta menghantarnya ke aplikasi easyCoexistence, yang menyemak X-Hub-Signature-256, membalas Meta serta-merta dan memajukan setiap entry bagi Halaman yang disambungkan ke endpoint HTTPS yang anda tetapkan untuknya. Pemajuan itu membawa header X-EC-Signature, iaitu HMAC-SHA256 bagi cap masa dan badan mentah yang dikunci dengan rahsia Halaman tersebut, dan dihantar sekali sahaja, tanpa salinan disimpan dan tanpa percubaan semula. Tetapkan endpoint dengan set_social_webhook_destination atau dengan PUT /channels/:id/webhook pada Partner API.

Perubahan suapan manakah yang memulakan peraturan komen dan automasi?

Hanya komen baharu: perubahan dengan item comment dan verb add pada salah satu siaran Halaman. Peraturan komen-ke-DM menyemak message-nya bagi kata kunci mereka dan melangkau komen yang dibuat oleh Halaman itu sendiri, dan automasi mengambil komen yang tidak dibalas oleh mana-mana peraturan. Suntingan, sembunyian, reaksi dan siaran terus ke endpoint anda, jika anda menetapkannya.

Kesilapan biasa

  • Menganggap mana-mana perubahan suapan sebagai komen baharu. Semak item dan verb: reaksi, suntingan, sembunyian dan pembuangan tiba pada medan yang sama.
  • Membalas komen Halaman sendiri. Balasannya juga datang sebagai perubahan suapan, jadi langkau yang from.id-nya ialah ID Halaman.
  • Menganggap satu perubahan bagi setiap penghantaran. Meta boleh menggabungkan sehingga 1,000 kemas kini, jadi gelung melalui setiap entry dan setiap change di dalamnya.
  • Membaca entry.time sebagai masa perubahan berlaku. Meta menetapkannya kepada masa notifikasi dihantar; created_time dalam nilai ialah masa objek dicipta.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah webhook suapan merangkumi komen?

Ya. Komen baharu tiba sebagai perubahan suapan dengan item comment dan verb add, membawa comment_id, post_id, from dan message.

Adakah saya menerima webhook untuk suka Halaman?

Hanya bagi Halaman dengan kurang daripada 10,000 suka, mengikut rujukan webhook Halaman Meta.

Adakah siaran iklan termasuk dalam webhook suapan?

Bukan siaran iklan itu sendiri, tetapi komen pada siaran tersebut dihantar.

Adakah saya perlu aplikasi Meta sendiri untuk mendapat peristiwa suapan Halaman?

Tidak. Meta menghantarnya ke aplikasi easyCoexistence, yang memajukan setiap satu ke endpoint yang anda tetapkan untuk Halaman itu.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada